Campaign Management API

Campaign Management API 适合依托 AppLovin AppDiscovery 推广应用的广告主。广告主 (以及拥有其公司账户访问权限的用户) 可以创建 OAuth 应用程序，验证对这些 API 的访问。广告主还可以创建第三方 OAuth 应用程序，以管理多个广告客户的 campaign。

第三方应用授权流程

本节适用对象：代表其他使用第三方应用的公司采用 Campaign Management API 的公司。如果您管理自己公司的 campaign，请改用第一方 OAuth 应用，并跳转至 API 请求验证部分，参阅其中的内容。

AppLovin 支持标准 OAuth 网页应用程序流程。所有查询参数均为必要参数。将用户发送至此 URL，提示用户授权您的应用管理他们的 campaign：

第三方应用授权流程目标 URL

https://oauth.applovin.com/oauth/initialize

第三方应用授权请求查询参数表

名称	描述	示例
`client_id`	OAuth 应用的 Client ID	`34af7c430e24bbccbc647ca3dd5ac858`
`redirect_uri`	流程完成后用户的重定向目标位置。必须进行 URL 编码，且必须与 OAuth 创建过程中定义的 `redirect_uri` 相同。	`https%3A%2F%2Fmydomain.com%2Foauth_code`
`response_type`	将其设置为 `code`。	`code`
`scope`	该应用应使用的作用域 (scope)。必须是该应用中已定义作用域的子集。请对该值进行 URL 编码。受支持的范围： `campaigns:read` `campaigns:write` `creatives:read` `creatives:write` `source_bids:read` `source_bids:write`	`campaigns%3Awrite%20creatives%3Awrite`
`state`	客户端使用的不透明值，用来维护请求和回传之间的状态	`ab13221308fe6abad1d1`

第三方应用授权流程请求示例

https://oauth.applovin.com/oauth/initialize?response_type=code&client_id=34af7c430e24bbccbc647ca3dd5ac858&redirect_uri=https%3A%2F%2Fmydomain.com%2Foauth_code&scope=campaigns%3Awrite%20creatives%3Awrite&state=ab13221308fe6abad1d1

用户同意使用您的 OAuth 应用后，AppLovin 会向您的 redirect_uri 发送回传。该回传包含用户的授权码。

第三方应用授权响应查询参数表

名称	描述	示例
`code`	代表用户用于生成访问和刷新 token 的代码值。请参阅 API 请求验证部分了解更多信息。	`9aa19842db327e4e43cc426e6ad6c2d1eacd2e3d464`
`state`	传递给 AppLovin 初始化请求的 state 参数，将被原样返回	`ab13221308fe6abad1d1`

第三方应用授权流程响应示例

https://mydomain.com/oauth_code?code=9aa19842db327e4e43cc426e6ad6c2d1eacd2e3d464&state=ab13221308fe6abad1d1

API 请求验证

向该终端发出 POST 请求，根据您的 Client ID 和 Client Secret 生成会话识别码。会话识别码的有效期为 60 分钟 (针对第一方 OAuth 应用程序)。将从该终端检索到的权限识别码添加到所有其他请求响应的 accessToken.access_token 字段中。通过 header Authorization: Bearer access_token 完成此操作。

验证目标 URL

https://oauth.applovin.com/oauth/v1/access_token

验证内容类型

multipart/form-data

权限识别码表单字段对照表

名称	描述	示例
`client_id`	OAuth 应用的 Client ID	`34af7c430e24bbccbc647ca3dd5ac858`
`client_secret`	您 OAuth 应用的 Client Secret	`9538e854765525d0b34af7c430e24bbcdfd58b83f3836fd0e83cbfd1b`
`code`	针对外部公司 `redirect_url` 的授权回传的 `code` 值。如有 `grant_type=authorization_code` 则为必要，否则无效。	`9aa19842db327e4e43cc426e6ad6c2d1eacd2e3d464`
`grant_type`	授权类型。第一方应用：设置为 `client_credentials`；使用验证码进行验证的第三方应用：设置为 `authorization_code`；使用刷新 token 进行验证的第三方应用：设置为 `refresh_token`。	`client_credentials`
`redirect_uri`	第三方应用程序的重定向 URI。对第一方应用程序无效。	`https://mydomain.com/oauth_code`
`refresh_token`	用户的刷新 token，用于生成新的权限识别码和刷新 token。每个刷新 token 只能使用一次。但每次调用都会返回一个新的刷新 token。刷新 token 有效期为 30 天。如有 `grant_type=refresh_token` 则为必要，否则无效。	`c75742c98f382264fca6a0a5759354b6eb95ea1a7c44d0e0b22e36ff26f8`
`scope`	本次会话识别码应使用的作用域。必须是该应用定义的作用域的子集。具有写入权限 (write) 的作用域会自动拥有读取权限 (read)。多个作用域请用空格分隔。支持的作用域包括： `campaigns:read` `campaigns:write` `creatives:read` `creatives:write` `source_bids:read` `source_bids:write` 在 `grant_type=client_credentials` 中则为必要，`grant_type=refresh_token` 为可选，`grant_type=authorization_code` 则无效。	`campaigns:write creatives:write`

第一方应用响应正文示例
第三方应用响应正文示例

{
  "accessToken":{
    "token_type":"Bearer",
    "expires_in":3600,
    "access_token":"cLXHaoel3iWi5Z3D"
  }
}

{
  "accessToken": {
    "token_type": "Bearer",
    "expires_in": 3600,
    "access_token": "JeUqLpg1KbJTICq4J28gNfV0TWGDedLDZgwlq3W91R2_eiNG1IwTznW8twia7",
    "refresh_token": "c75742c98f382264fca6a0a5759354b6eb95ea1a7c44d0e0b22e36ff26f8"
  }
}

`/campaign/campaign_id`

向此终端发出 GET 请求，以查看单个 campaign 的详细信息。

向此终端发出 POST 请求，以编辑单个 campaign 的详细信息或创建新的 campaign。在创建新 campaign 时，请不要在请求 URL 和请求正文中填写 campaign_id。

`/campaign/campaign_id` 目标 URL

https://o.applovin.com/campaign_management/v1/campaign/«campaign-ID»

`/campaign/campaign_id` 响应正文示例

{
  "name": "Test Campaign Name - iOS",
  "campaign_id": "29d66efc22ae53a201e1532265b83f12",
  "package_name": "123456789",
  "bundle_id":"com.sample.app.ios",
  "platform": "ios",
  "category": "101",
  "bid_type": "CPI",
  "tracking_method": "adjust",
  "status": true,
  "created_at": "2021-06-29 00:00:00",
  "impressions": 21,
  "clicks": 4,
  "installs": 1,
  "spend": "1.4300"
}

{
  "campaign_id": "29d66efc22ae53a201e1532265b83f12",
  "status": false
}

{
  "name": "My New Campaign Name",
  "package_name": "987654321",
  "bundle_id":"com.sample.app.ios",
  "platform": "ios",
  "category": "108",
  "bid_type": "CPE",
  "tracking_method": "adjust",
  "status": "true"
}

`/campaign/ campaign_id` 请求/响应正文字段对照表

名称描述创建时必需更新时必需

bid_type¹

Campaign 的竞价类型 (CPI，CPP_GOAL，RET、CPE，ROAS_AD_BASED，或 ROAS_IAP)

示例： "CPI"

FALSE

TRUE

bundle_id¹

所推广应用的 Bundle ID (仅限 iOS)

示例： "com.sample.app.ios"

FALSE

TRUE

campaign_id¹

Campaign 唯一标识

示例： "29d66efc22ae53a201e1532265b83f12"

TRUE

FALSE

category

Campaign 类别

示例： "105"

FALSE

TRUE

clicks¹

昨日点击量

示例： 12

FALSE

TRUE

created¹

Campaign 创建日期

示例： "2021-06-30 00:00:00"

FALSE

TRUE

goal_period¹

用于监测目标达成的安装后天数。按照 bid_type 划分，可能的值为：

`bid_type`	值
`CPI`	n/a
`CPP`	7
`CPE`	7
`RET`	1, 3, 7
`ROAS_AD_BASED`	0
`ROAS_IAP`	0, 7

示例： 0

FALSE

impressions¹

昨日展示量

示例： 125

FALSE

TRUE

installs¹

昨日安装量

示例： 2

FALSE

name

campaign 名称

示例： "Test Campaign - iOS"

TRUE

FALSE

package_name¹

所推广应用的包名。在 iOS 端，使用 iTunes ID 的数字部分

示例： "123456789"

FALSE

TRUE

platform¹

所推广应用的平台 (ios 或 android)

示例： "ios"

FALSE

TRUE

spend¹

昨日支出

示例： "2.5000"

FALSE

TRUE

status

Campaign 是否处于活跃状态

示例： true

FALSE

tracking_method

Campaign 跟踪方法。请参阅下方跟踪方法表。

示例： "adjust"

FALSE

TRUE

¹只读

`/campaigns`

向此终端发送 GET 请求，以查看全部 campaign。您无法通过该终端编辑 campaign。

`/campaigns` 目标 URL

https://o.applovin.com/campaign_management/v1/campaigns

`/campaigns` 响应正文示例

[
  {
    "name": "Test Campaign Name - iOS",
    "campaign_id": "29d66efc22ae53a201e1532265b83f12",
    "package_name": "123456789",
    "bundle_id": "com.sample.app.ios",
    "platform": "ios",
    "category": "101",
    "bid_type": "CPI",
    "tracking_method": "adjust",
    "status": false,
    "created_at": "2021-06-29 00:00:00",
    "impressions": 21,
    "clicks": 4,
    "installs": 1,
    "spend": "1.4300"
  },
  {
    "name": "Test Campaign Name - Android",
    "campaign_id": "265b83f129d66efc22ae201e153253a2",
    "package_name": "com.sample.app.android",
    "platform": "android",
    "category": "201",
    "bid_type": "CPI",
    "status": false,
    "created_at": "2021-06-29 00:00:00",
    "impressions": 39,
    "clicks": 9,
    "installs": 2,
    "spend": "1.8600"
  }
]

`/campaigns` 响应正文字段对照表

请参阅 /campaign/campaign_id 请求/响应字段对照表。

`/creative_set/creative_set_id`

向此终端发送 POST 请求，以更新素材组名称或创建新的素材组。如需创建新素材组，请不要在请求 URL 或请求正文中填写 creative_set_id。素材组是可以相互组合并生成许多广告的资源集合。素材组构建完毕后，您就无需多次上传每个资源。素材组还包含基础素材资源的语言信息。

`/creative_set/creative_set_id` 目标 URL

https://o.applovin.com/campaign_management/v1/creative_set/«creative-set-ID»

`/creative_set/creative_set_id` 响应正文示例

{
  "campaign_id":"f87ece84f46b55cfbf24427ff8746a40",
  "name":"My Test Creative Set 0",
  "countries":["us","gb"],
  "languages":[
    "en"
  ],
  "ads":[],
  "assets":[],
  "product_page": null,
  "sizes": {
    "INTER":true,
    "BANNER":false
  }
}

`/creative_set/creative_set_id` 请求/响应正文字段

名称	描述	示例
`ads`¹	与该素材组关联的广告对象数组。对象的格式与来自 `/ad/ad_id` 终端的响应正文相同。
`assets`¹	与该素材组关联的资源对象数组。请参阅下方表格。
`campaign_id`¹	Campaign ID	`"29d66efc22ae53a201e1532265b83f12"`
`countries`	该素材组的国家/地区限制，例如针对特定国家/地区的促销等。您无需重复为每个素材组设置 campaign 定向。如果此列表为空，那么 campaign 定义的国家/地区则符合条件。如果此列表中包含 campaign 定向范围之外的国家/地区，那么此类国家/地区则不符合资格。	`["za", "gb"]`
`languages`	语言列表。请查看下方表格掌握完整信息。	`["en"]`
`name`	素材组名称
`product_page`	与素材组关联的 iOS 自定义产品页，或 Android 商品详情页面。
`sizes`¹	一组素材尺寸选项，以及是否在集合中启用特定尺寸的广告。	`{ "INTER":true, "BANNER":false }` (表示集合包含 `INTER` 和 `BANNER` 尺寸的广告，但 `BANNER` 尺寸的广告处于禁用状态。)

¹只读

资源对象字段对照表

名称	描述	示例
`asset`	资源 URL、哈希或字符串	`"https://res1.applovin.com/oab49763/foobidyfoo_v23_phone.mp4"`
`status`	Campaign Management API 会异步处理广告资源。API 会首先将 `status` 设置为 `processing`。最后将 `status` 设置为 `error` (失败) 或 `ready` (成功)。	`"processing"`、`"error"`、`"ready"`
`type`	资源类型。请参阅下表了解可能的资源类型。	`"TXT_TITLE"`

`/creative_set/creative_set_id/sizes`

向此终端发送 POST 请求，以启用或禁用素材组中的一个或多个素材尺寸。

`/creative_set/creative_set_id/sizes` 目标 URL

https://o.applovin.com/campaign_management/v1/creative_set/«creative-set-ID»/sizes

`/creative_set/creative_set_id/sizes` 请求正文示例

{
  "INTER":true,
  "BANNER":false
}

有效尺寸指示符：BANNER、CTV、INTER 和 PRELOAD。

上述示例会禁用集合中所有尺寸为 BANNER 的广告，并启用集合中尺寸为 INTER 的广告。其他尺寸的广告不会受到影响。

`/creative_sets/campaign_id`

向此终端发送 GET 请求，以查看与 campaign 关联的全部素材组。

`/creative_sets/campaign_id` Target URL

https://o.applovin.com/campaign_management/v1/creative_sets/«campaign-ID»

`/creative_sets/campaign_id` 响应正文示例

[
  {
    "campaign_id":"f87ece84f46b55cfbf24427ff8746a40",
    "name":"My Test Creative Set 0",
    "countries":["us","gb"],
    "languages":[
      "en"
    ],
    "ads":[…],
    "assets":[…],
    "product_page": null,
    "sizes": {
      "INTER":true,
      "BANNER":false
    }
  }
]

`/creative_sets/ campaign_id` 响应正文字段对照表

请参阅 /creative_set/creative_set_id 响应字段对照表

`/creative_set_assets/creative_set_id`

向此终端发送 POST 请求，以上传、更新或移除与素材组关联的资源。每个请求只能管理一项资源。响应中将包含素材组的所有素材资源。

`POST` `/creative_set_assets/creative_set_id` 目标 URL

https://o.applovin.com/campaign_management/v1/creative_set_assets/«creative-set-ID»

`POST` `/creative_set_assets/creative_set_id` 内容类型

multipart/form-data

请求资源表格字段对照表

名称	描述	示例
`asset`¹	资源 URL、哈希或字符串。	`"https://res1.applovin.com/ob7cb6fc/foobidyfoo_v23_phone.mp4"`、`"3f5a01dc0980f3d04188e73e91c"`、`"Best app you’ll ever play"`
`file`²	图片、视频或 HTML 文件。	请参阅广告规则、规范和指南。
`remove`³	(可选) 传入 `true` 以移除资源类型。	`true` 或 `false`
`type`¹	资源类型。请参阅下表了解可能的资源类型。	“TXT_TITLE”
`update`	(可选) 传入 `true` 以更新资源类型。	`true` 或 `false`

¹添加或更新广告资源时，只需发送 asset 参数或 file 参数。²为添加或更新文件资源传入文件时，type 会根据文件属性计算。³移除资源时，只需发送 type 参数。

`POST` `/creative_set_assets/creative_set_id` 响应正文示例

[
  {
    "asset":"https://res1.applovin.com/oab7a439/foobidyfoo_v23_phone.mp4",
    "status":"ready",
    "type":"VID_LONG_P"
  },
  {
    "asset":"Help the heroes to defeat the villains and save the world!",
    "status":"ready",
    "type":"TXT_SUBTITLE"
  }
]

`POST` `/creative_set_assets/creative_set_id` 响应资源对象字段对照表

名称	描述	示例
`asset`	资源 URL、哈希或字符串	`"https://res1.applovin.com/oab49763/foobidyfoo_v23_phone.mp4"`
`status`	Campaign Management API 会异步处理资源。API 会首先将 `status` 设置为 `processing`。最后将 `status` 设置为 `error` (失败) 或 `ready` (成功)。	`"processing"`、`"error"`、`"ready"`
`type`	资源类型。请参阅下表了解可能的资源类型。	`"TXT_TITLE"`

`/ad/ad_id`

向该终端发送 GET 请求，以查看广告属性。

向该终端发出 POST 请求，以编辑广告的名称或状态。通过 UI 或 API 调用 /creative_set/creative_set_id 上传广告模板的所有必要资源后，广告就会自动创建。

`/ad/ad_id` 目标 URL

https://o.applovin.com/campaign_management/v1/ad/«ad-ID»

`/ad/ad_id` 响应正文示例

{
  "name":"Banner_AppIconSimple_MyTestCreativeSet0",
  "id":10780437,
  "creative_set_name":"My Test Creative Set 0",
  "creative_set_id":"37057c98a951078bf06b6d7c3561fd1a",
  "size":"BANNER",
  "status":true,
  "template":"App Icon Simple"
}

`/ad/ad_id` 请求/响应正文字段对照表

名称	描述
`creative_set_id`¹	父级素材组 ID
`creative_set_name`¹	父级素材组名称
`id`¹	广告 ID
`name`	广告名称
`size`¹	广告尺寸 (下列任一)：`BANNER`、`INTER`、`LEADER`、`MREC`、`NATIVE` 或 `WIDGET`
`status`	广告处于活跃 (`true`) 还是休眠状态 (`false`)
`template`¹	广告模板名称

¹只读

`/ads/creative_set_id`

向该终端发送 GET 请求，以查看与素材组关联的所有广告。

`/ads/creative_set_id` 目标 URL

https://o.applovin.com/campaign_management/v1/ads/«creative-set-ID»

`/ads/creative_set_id` 响应正文示例

[
  {
    "name":"Banner_AppIconSimple_MyTestCreativeSet0",
    "id":10780437,
    "creative_set_name":"My Test Creative Set 0",
    "creative_set_id":"37057c98a951078bf06b6d7c3561fd1a",
    "size":"BANNER",
    "status":true,
    "template":"App Icon Simple"
  }
]

广告对象字段对照表

请参阅 /ad/ad_id 请求/响应字段对照表。

`/creative_sets/campaign_id`

向此终端发送 GET 请求，以查看与 campaign 关联的全部素材组。

`/creative_sets/campaign_id` Target URL

https://o.applovin.com/campaign_management/v1/creative_sets/«campaign-ID»

`/creative_sets/campaign_id` 响应正文示例

[
  {
    "campaign_id":"f87ece84f46b55cfbf24427ff8746a40",
    "name":"My Test Creative Set 0",
    "countries":["us","gb"],
    "languages":[
      "en"
    ],
    "ads":[…],
    "assets":[…],
    "product_page": null
  }
]

`/creative_sets/ campaign_id` 响应正文字段对照表

请参阅 /ad/ad_id 请求/响应字段对照表。

`/campaign_targets/campaign_id`

向该终端发送 GET 请求，查看 campaign 的定向、URL、竞价和预算。

向该终端发送 POST 请求，以更新这些属性。

`/campaign_targets/campaign_id` 目标 URL

https://o.applovin.com/campaign_management/v1/campaign_targets/«campaign-ID»

`/campaign_targets/campaign_id` 响应正文示例

{
  "bid_type": "CPI",
  "countries":[
    {
      "DEFAULT":{
        "click_url":"https://app.adjust.com/123abc?campaign={CAMPAIGN_NAME}%20({CAMPAIGN_ID})&adgroup={APP_ID}&idfa={IDFA}&country={CC}&gps_adid={IDFA}&campaign_id={CAMPAIGN_ID}&device_type={DEVICE_TYPE}&publisher_id={APP_ID}&tracker_limit=100000&applovin_click_id={DID}&external_tracker_ids=1&android_id_lower_sha1={HADID}",
        "impression_url":"https://s2s.adjust.com/impression/123abc?campaign={CAMPAIGN_NAME}%20({CAMPAIGN_ID})&adgroup={APP_ID}&idfa={IDFA}&country={CC}&gps_adid={IDFA}&campaign_id={CAMPAIGN_ID}&device_type={DEVICE_TYPE}&publisher_id={APP_ID}&tracker_limit=100000&applovin_click_id={DID}&external_tracker_ids=1&android_id_lower_sha1={HADID}&s2s=1"
      }
    },
    {
      "us":{
        "bid":2.9,
        "budget":300,
        "disabled":false
      }
    },
    {
      "gb":{
        "bid":2.5,
        "budget":250,
        "disabled":false
      }
    }
  ],
  "device_types":[
    "phone"
  ],
  "os_major_version_min":9
}

`/campaign_targets/campaign_id` 请求/响应正文字段对照表

名称	描述	示例
`bid_type`¹	该 campaign 使用的竞价类型。与 campaign 对象设置相同。	`CPI`
`countries`	国家/地区对象列表。请参阅下文。	请参阅下方表格
`device_types`	符合条件的设备类型列表。如果列表为空，则意味着所有设备类型都符合条件。选项包括：`"phone"`、`"tablet"`、`"other"`。仅在 iOS 端受到支持。	`["phone", "other"]`
`os_major_version_min`	可以投放 campaign 的最低 OS 版本。`10` 指 10.0 及以上。	`9`

¹只读

国家/地区对象字段对照表

Campaign 拥有所有国家/地区共享的总预算，或每个国家/地区都有特定的预算。因此，竞价、预算和 URL 值均应当位于 DEFAULT 对象中，或分别位于特定国家/地区的对象中。向该终端发送 POST 请求，只会更新请求中包含的国家/地区。未包含在请求中的定向国家/地区不会收到更新。要禁用某个国家/地区，请将 disabled 设置为 true。

名称	描述	示例
`bid`	对应国家/地区的出价值。在 `CPI` campaign 中是 CPI (USD)；对于 `RET`、`ROAS_AD_BASED` 和 `ROAS_IAP` 是百分比目标 (`50`= 50%)；对于 `CPP` 和 `CPE` 是目标事件值 (USD)。	`2.9`
`budget`	每日预算 (USD)	`1000`
`click_url`	点击跟踪 URL	`https://s2s.adjust.com/impression/123abc?campaign={CAMPAIGN_NAME}%20({CAMPAIGN_ID})&gps_adid={IDFA}`
`country`	`"DEFAULT"` 或由两个字母组成的国家代码	`"gb"`
`disabled`	API 仅返回活跃的国家/地区。要禁用国家/地区，请在更新时将此值设置为 `true`。	`false`
`impression_url`	展示跟踪 URL	`https://app.adjust.com/123abc?campaign={CAMPAIGN_NAME}%20({CAMPAIGN_ID})&gps_adid={IDFA}`

`/sources/campaign_id`

向该终端发送 GET 请求，以查看 campaign 投放来源的状态。

向该终端发送 POST 请求，以更新 campaign 中来源的状态。

`/sources/campaign_id` 目标 URL

简单 GET 或 POST
带有分页的 GET

https://o.applovin.com/campaign_management/v1/sources/«campaign-ID»

https://o.applovin.com/campaign_management/v1/sources/«campaign-ID»?limit=«xxxx»&offset=«yyyy»

`/sources/campaign_id` 响应正文示例

[
  {
    "app_id": "da605e6f950f1aec838816df845e95e0c8d5cb7a994d71ae0ef2",
    "app_id_external": "3a2ccd1298a9eaa1a5de114c323c8b1d",
    "status": true
  },
  {
    "app_id": "ecf49bef2a8026d53f7a3d245e890cc0b59b85c82c16c8d63bf4a5",
    "app_id_external": "ca3cc7d0636891d98ee2267a34d5301e",
    "status": false
  }
]

`/sources/campaign_id?limit=2&offset=2000` 响应正文示例

{
  "offset": 2000,
  "limit": 2,
  "sources": [
    {
      "app_id": "da605e6f950f1aec838816df845e95e0c8d5cb7a994d71ae0ef2",
      "app_id_external": "3a2ccd1298a9eaa1a5de114c323c8b1d",
      "status": true
    },
    {
      "app_id": "ecf49bef2a8026d53f7a3d245e890cc0b59b85c82c16c8d63bf4a5",
      "app_id_external": "ca3cc7d0636891d98ee2267a34d5301e",
      "status": false
    }
  ]
}

`/sources/campaign_id` 请求/响应正文字段对照表

名称	描述	示例
`app_id`¹	可切换的应用引用	`da605e6f950f1aec838816df845e95e0c8d5cb7a994d71ae0ef2`
`app_id_external`²	外部 App ID (只读)	`f950f1aec838816df845e95e0c8da605e6`
`status`	应用是否处于活跃状态	`true`

¹ 您可以在报告 API 列 “external_placement_id”、跟踪 URL 宏 {PLACEMENT_ID} 中找到该值，也可以通过 CSV 竞价 UI 工具找到该值。

² 您可以在报告 API 列 “app_id_external” 或跟踪 URL 宏 {APP_ID} 中找到该值。在 POST 请求中，该值会被忽略。出于向后兼容性的需要，该值会包含在 GET 请求中。

`/sources/campaign_id?limit=xxxx&offset=yyyy` 响应正文字段对照表

名称	描述	示例
`limit`	该响应中返回的行数。适合大型响应的分页。	`5000`
`offset`	该响应应当跳过的、数据集中的行数。适合大型响应的分页。	`15000`
`sources`	来源列表。请参阅 `/sources/campaign_id` 请求/响应正文字段对照表，了解字段定义。
`total_row_count`	与该 campaign 关联的来源竞价重写数量。	`8192`

跟踪方法表

API 名称	MMP 名称
adjust	Adjust
applovin	AppLovin
appsflyer	AppsFlyer
apsalar	Singular
branch	Branch
custom_track	Custom
justtrack	JustTrack
kochava	Kochava
tenjin	Tenjin

语言代码

语言代码	语言
ar	阿拉伯语
bg	保加利亚语
bn	孟加拉语
bs	波斯尼亚语
ca	加泰罗尼亚语
cs	捷克语
da	丹麦语
de	德语
el	希腊语
en	英语
es	西班牙语
et	爱沙尼亚语
eu	巴斯克语
fa	波斯语
fi	芬兰语
fr	法语
he	希伯来语
hi	印地语
hr	克罗地亚语
hu	匈牙利语
id	印尼语
is	冰岛语
it	意大利语
he	希伯来语
hi	印地语
iw	希伯来语
ja	日语
jv	爪哇语
ka	格鲁吉亚语
ko	韩语
lt	立陶宛语
lv	拉脱维亚语
mk	马其顿语
mr	马拉地语
ms	马来语
nb	挪威语
nl	荷兰语
no	挪威语
pl	波兰语
pt	葡萄牙语
ro	罗马尼亚语
ru	俄语
sk	斯洛伐克语
sq	阿尔巴尼亚语
sr	塞尔维亚语
su	巽他语
sv	瑞典语
th	泰语
tr	土耳其语
ug	维吾尔语
uk	乌克兰语
ur	乌尔都语
vi	越南语
zh	中文 (简体和繁体)
zh_hans	简体中文
zh_hant	繁体中文

资源类型

API 名称	资源类型名称	描述
`HOSTED_HTML`	Playable File	试玩广告文件
`IMG_BANNER`	Banner Image	320×50
`IMG_ICON`	App Icon	应与商店中使用的图标一致
`IMG_INTER_L`	Landscape Image	用于静态插屏和视频片尾广告
`IMG_INTER_P`	Portrait Image	用于静态插屏和视频片尾广告
`IMG_LEADER`	Leader Image	728×90
`IMG_MREC`	Medium Rectangle (MREC) Image	300×250
`IMG_NATIVE`	Native Image	原生广告主图：1200×628 或 1200×627
`TXT_BUTTON`	Button	按钮文本
`TXT_RATING`	App Rating	0.0–5.0，仅允许 0.5 的增量
`TXT_SUBTITLE`	Subline	在部分广告中用于描述应用的次要文本
`TXT_TITLE`	App name	用于横幅广告和部分视频模板
`VID_LONG_P`	Long Portrait Video	时长超过 15 秒的纵向视频
`VID_SHORT_P`	Short Portrait Video	时长不超过 15 秒的纵向视频

模板

尺寸	模板名称	资源
横幅	Standard	`IMG_BANNER`
插屏	Portrait — Over 15s	`IMG_INTER_P`、`IMG_INTER_L`、`VID_LONG_P`
插屏	Portrait — Under 15s	`IMG_INTER_P`、`IMG_INTER_L`、`VID_SHORT_P`
插屏	Portrait Playable Endcard — Over 15s	`HOSTED_HTML`、`VID_LONG_P`
插屏	Portrait Playable Endcard — Under 15s	`HOSTED_HTML`、`VID_SHORT_P`
插屏	Rewarded Playable	`HOSTED_HTML`
插屏	Standard	`IMG_INTER_P`、`IMG_INTER_L`
插屏	Standard Playable	`HOSTED_HTML`
引导	Standard	`IMG_LEADER`
MREC	Standard	`IMG_MREC`
预加载	Standard	n/a

条款 | 隐私 | EULA | DMCA | Cookie 设置

Campaign Management API

第三方应用授权流程

第三方应用授权流程目标 URL

第三方应用授权请求查询参数表

第三方应用授权流程请求示例

第三方应用授权响应查询参数表

第三方应用授权流程响应示例

API 请求验证

验证目标 URL

验证内容类型

权限识别码表单字段对照表

/campaign/campaign_id

/campaign/campaign_id 目标 URL

/campaign/campaign_id 响应正文示例

/campaign/campaign_id 请求正文示例

/campaign/ campaign_id 请求/响应正文字段对照表

/campaigns

/campaigns 目标 URL

/campaigns 响应正文示例

/campaigns 响应正文字段对照表

/creative_set/creative_set_id

/creative_set/creative_set_id 目标 URL

/creative_set/creative_set_id 响应正文示例

/creative_set/creative_set_id 请求/响应正文字段

资源对象字段对照表

/creative_set/creative_set_id/sizes

/creative_set/creative_set_id/sizes 目标 URL

/creative_set/creative_set_id/sizes 请求正文示例

/creative_sets/campaign_id

/creative_sets/campaign_id Target URL

/creative_sets/campaign_id 响应正文示例

/creative_sets/ campaign_id 响应正文字段对照表

/creative_set_assets/creative_set_id

POST /creative_set_assets/creative_set_id 目标 URL

POST /creative_set_assets/creative_set_id 内容类型

请求资源表格字段对照表

POST /creative_set_assets/creative_set_id 响应正文示例

POST /creative_set_assets/creative_set_id 响应资源对象字段对照表

/ad/ad_id

/ad/ad_id 目标 URL

/ad/ad_id 响应正文示例

/ad/ad_id 请求/响应正文字段对照表

/ads/creative_set_id

/ads/creative_set_id 目标 URL

/ads/creative_set_id 响应正文示例

广告对象字段对照表

/creative_sets/campaign_id

/creative_sets/campaign_id Target URL

/creative_sets/campaign_id 响应正文示例

/creative_sets/ campaign_id 响应正文字段对照表

/campaign_targets/campaign_id

/campaign_targets/campaign_id 目标 URL

/campaign_targets/campaign_id 响应正文示例

/campaign_targets/campaign_id 请求/响应正文字段对照表

国家/地区对象字段对照表

/sources/campaign_id

/sources/campaign_id 目标 URL

/sources/campaign_id 响应正文示例

/sources/campaign_id?limit=2&offset=2000 响应正文示例

/sources/campaign_id 请求/响应正文字段对照表

/sources/campaign_id?limit=xxxx&offset=yyyy 响应正文字段对照表

跟踪方法表

语言代码

资源类型

模板

`/campaign/campaign_id`

`/campaign/campaign_id` 目标 URL

`/campaign/campaign_id` 响应正文示例

`/campaign/campaign_id` 请求正文示例

`/campaign/ campaign_id` 请求/响应正文字段对照表

`/campaigns`

`/campaigns` 目标 URL

`/campaigns` 响应正文示例

`/campaigns` 响应正文字段对照表

`/creative_set/creative_set_id`

`/creative_set/creative_set_id` 目标 URL

`/creative_set/creative_set_id` 响应正文示例

`/creative_set/creative_set_id` 请求/响应正文字段

`/creative_set/creative_set_id/sizes`

`/creative_set/creative_set_id/sizes` 目标 URL

`/creative_set/creative_set_id/sizes` 请求正文示例

`/creative_sets/campaign_id`

`/creative_sets/campaign_id` Target URL

`/creative_sets/campaign_id` 响应正文示例

`/creative_sets/ campaign_id` 响应正文字段对照表

`/creative_set_assets/creative_set_id`

`POST` `/creative_set_assets/creative_set_id` 目标 URL

`POST` `/creative_set_assets/creative_set_id` 内容类型

`POST` `/creative_set_assets/creative_set_id` 响应正文示例

`POST` `/creative_set_assets/creative_set_id` 响应资源对象字段对照表

`/ad/ad_id`

`/ad/ad_id` 目标 URL

`/ad/ad_id` 响应正文示例

`/ad/ad_id` 请求/响应正文字段对照表

`/ads/creative_set_id`

`/ads/creative_set_id` 目标 URL

`/ads/creative_set_id` 响应正文示例

`/creative_sets/campaign_id`

`/creative_sets/campaign_id` Target URL

`/creative_sets/campaign_id` 响应正文示例

`/creative_sets/ campaign_id` 响应正文字段对照表

`/campaign_targets/campaign_id`

`/campaign_targets/campaign_id` 目标 URL

`/campaign_targets/campaign_id` 响应正文示例

`/campaign_targets/campaign_id` 请求/响应正文字段对照表

`/sources/campaign_id`

`/sources/campaign_id` 目标 URL

`/sources/campaign_id` 响应正文示例

`/sources/campaign_id?limit=2&offset=2000` 响应正文示例

`/sources/campaign_id` 请求/响应正文字段对照表

`/sources/campaign_id?limit=xxxx&offset=yyyy` 响应正文字段对照表