Skip to content

更新广告

需要携带 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_idint广告 ID1234
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 选填stringApp 的类别,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"

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回广告信息,失败返回具体的错误信息
campaign_idint广告 ID
campaign_namestring广告名称
is_coppastring是否满足 coppa 要求。(YES、NO)
promotion_typestring产品类型
alive_in_storestring产品是否在 Google Play 或者 App Store 上架。(YES、NO)
preview_urlstring需要推广的产品的预览链接。
product_namestring需要推广的产品的名称(应用名称或者网页名称)。
package_namestring针对 app 类型的产品,需要推广的产品的包名,例如"com.xxx.xxx"、"idxxx"
descriptionstring需要推广的产品的简要描述。
iconstring需要推广的产品的 icon 或者 logo
platformstring产品的应用平台
categorystring针对 app 类型的产品,需要推广的产品在应用市场中的分类。[枚举值 - IOS App 类别] [枚举值 - ANDROID App 类别]
app_sizestring针对 app 类型的产品,需要推广的产品的包体大小
min_versionstring针对 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"
  }
}