更新广告
需要携带 Token,详情看 Token
通过此接口可用于更新广告信息。
请求地址
https://ss-api.mintegral.com/api/open/v1/campaign
请求方法
PUT
请求示例
json
PUT /api/open/v1/campaign
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
"campaign_id": 1234,
"is_coppa": "YES",
"campaign_name": "Test",
"promotion_type": "APP",
"product_name": "Test",
"package_name": "com.tencent.mm",
"description": "Test",
"icon": "f7c970d0d24c71d84d15a78f29042323",
"category": "BUSINESS",
"app_size": 12.13,
"min_version": "1.0.0"
}
请求参数
字段 | 类型 | 说明 | 默认值 | 例子 |
---|---|---|---|---|
campaign_id | int | 广告 ID | — | 1234 |
campaign_name 选填 | string | 广告名称,唯一且字符长度最多为 100。 | — | "Test_campaign_name" |
promotion_type 选填 | string | 广告类型。可选值:"APP" 、"WEBSITE" 。 | — | "APP" |
is_coppa 选填 | string | 是否满足 coppa 要求。可选值:"YES" 、"NO" | "" | "YES" |
icon 选填 | string | 产品的 icon 或者 logo。通过素材接口上传 icon 图片后返回的 md5 值。 注:图片格式要求为:jpg,、png、 jpeg、 bmp。尺寸: 512x512。大小: 5M 以内。 | "" | "f7c970d0d24c71d84d15a78f29042323" |
product_name 选填 | string | 投放的产品的名称。注:最多 100 个字符。 | — | — |
package_name 选填 | string | 投放的产品的 android bundle id 或者 ios application store id。 | — | android: "com.tencent.mm" ios: "id414478124" |
app_size 选填 | number | 应用包体大小,单位为 MB,小数点后保留两位。 | — | 12.34 |
category 选填 | string | App 的类别,IOS 和 Android 有所不同,类别详情参考附录。[枚举值 - IOS App 类别][枚举值 - ANDROID App 类别] | — | "GAMES" |
min_version 选填 | string | 应用要求的系统版本。格式为 x 或 x.x 或 x.x.x 或 x.x.x.x,且 x 必须为数字。promotion_type="WEBSITE" 时,传空即可。 注:正则校验规则为/^(\d+.)?(\d+.)?(\d+.)?(*\d+)?$/ | — | "1.0.0" |
description 选填 | string | 产品描述。最多 4000 字符。 | — | "Test" |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功,其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回广告信息,失败返回具体的错误信息 |
campaign_id | int | 广告 ID |
campaign_name | string | 广告名称 |
is_coppa | string | 是否满足 coppa 要求。(YES、NO) |
promotion_type | string | 产品类型 |
alive_in_store | string | 产品是否在 Google Play 或者 App Store 上架。(YES、NO) |
preview_url | string | 需要推广的产品的预览链接。 |
product_name | string | 需要推广的产品的名称(应用名称或者网页名称)。 |
package_name | string | 针对 app 类型的产品,需要推广的产品的包名,例如"com.xxx.xxx"、"idxxx" |
description | string | 需要推广的产品的简要描述。 |
icon | string | 需要推广的产品的 icon 或者 logo |
platform | string | 产品的应用平台 |
category | string | 针对 app 类型的产品,需要推广的产品在应用市场中的分类。[枚举值 - IOS App 类别] [枚举值 - ANDROID App 类别] |
app_size | string | 针对 app 类型的产品,需要推广的产品的包体大小 |
min_version | string | 针对 app 类型的产品,需要推广的产品的最低系统版本要求。 |
应答示例
json
{
"msg": "success",
"code": 200,
"data": {
"campaign_id": 1234,
"is_coppa": "YES",
"campaign_name": "Test",
"promotion_type": "APP",
"alive_in_store": "YES",
"preview_url": "https://play.google.com/store/apps/details?id=xxxxxxx",
"product_name": "Test",
"package_name": "com.tencent.mm",
"description": "Test",
"icon": "f7c970d0d24c71d84d15a78f29042323",
"platform": "ANDROID",
"category": "GAMES",
"app_size": "12.13",
"min_version": "1.0.0"
}
}