电商 Campaign Management API

Axon Campaign Management API 适用于使用 AppLovin Campaign 来推广其网站的广告主。

您可以通过向 Axon Campaign Management API 发送请求来创建和更新 Campaign 和广告素材组，并上传新资源。

您必须验证每个 API 请求。为此，请在请求中添加 Authorization HTTP header 并将其值设置为您的 Campaign Management API Key。(此 Key 与您用于 Ad Unit Management API 的 Management Key 不同。)

You can find your Campaign Management API key in the Axon dashboard. Click your account in the top right of the dashboard and select Keys.

You also must add the account_id query parameter to each request. To find your account_id, click your account in the top right of the Axon dashboard and select Go to settings. Your account ID is the number that follows your account name.

如果此 API 返回错误，请参阅 x-al-error-code 和 x-al-error-message 响应 header 以获取更多信息。

所有响应还包含 X-TRACE-ID header。 请在所有支持请求中包含此 Trace ID，以便 AppLovin 可以更好地定位和追踪您的问题。

Campaign

/campaign/list 终端

向此终端发送 GET 请求，以检索您账户中最多 100 个 Campaign 的列表。 此列表是 Campaign 对象的 JSON 数组。

如果选定页面上没有 Campaign，此终端将返回一个空数组。

目标 URL

https://api.ads.axon.ai/manage/v1/campaign/list?account_id=«account-ID»

查询参数

名称描述默认
ids用逗号分隔的 Campaign ID 列表。使用此列表将结果筛选为仅具有指定 ID 的结果。通过这种方式，您最多可以指定 100 个 ID。不要将此与 hashed_ids 一起使用。null
hashed_ids用逗号分隔的 Campaign ID 列表。使用此列表将结果筛选为仅具有指定 ID 的结果。通过这种方式，您最多可以指定 100 个 ID。不要将此与 ids 一起使用。null
page要检索的结果页码。第一页是第 1 页。1
size每页要返回的结果数量。最大数量为 100。100

示例

    已分页的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/campaign/list?account_id=«account-ID»&size=50&page=10' \
--header 'Authorization: «campaign-API-key»'

    已筛选的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/campaign/list?account_id=«account-ID»&ids=12345' \
--header 'Authorization: «campaign-API-key»'

    响应

    [
  {
    "id": "1691903",
    "name": "maxb_testing_catalog",
    "status": "LIVE",
    "type": "WEB",
    "budget": {
      "daily_budget_for_all_countries": "6000",
      "country_code_to_daily_budget": {}
    },
    "goal": {
      "goal_value_for_all_countries": "0.99",
      "goal_type": "CHK_ROAS",
      "roas_day_target": "DAY7",
      "country_code_to_goal_value": {},
      "event_target": ""
    },
    "targeting": [
      {
        "country_code": "US"
      }
    ],
    "hashed_id": "7a386e158371f5ae745b4f4a62b6459d",
    "created_at": "2025-08-29T12:54:16",
    "bidding_strategy": "MAXIMIZE_RESULTS_WITH_CPM_BILLING",
    "start_date": "2025-08-30T00:00:00",
    "end_date": "2039-08-31T00:00:00",
    "website_url": "https://www.test.com",
    "is_dynamic_ads_enabled": false
  }
]

/campaign/create 终端

向此终端发送 POST 请求以创建新的 Campaign。请求体是 Campaign 对象。查看 Campaign 对象表的 Create 列，以确定应在请求中包含哪些字段。

此终端返回一个 JSON 对象，其中包含此终端创建的 Campaign 的 Campaign ID (id)。

目标 URL

https://api.ads.axon.ai/manage/v1/campaign/create?account_id=«account-ID»

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/campaign/create?account_id=«account-ID»' \
--header 'Content-Type: application/json' \
--header 'Authorization: «campaign-API-key»' \
--data '{
  "name": "dynamic_test",
  "type": "WEB",
  "start_date": "2025-08-30T00:00:00",
  "end_date": "2025-08-31T00:00:00",
  "targeting": [
    {
      "country_code": "US"
    }
  ],
  "budget": {
    "daily_budget_for_all_countries": "6000"
  },
  "goal": {
    "goal_value_for_all_countries": "0.99",
    "goal_type": "CHK_ROAS",
    "roas_day_target": "DAY7"
  },
  "bidding_strategy": "MAXIMIZE_RESULTS_WITH_CPM_BILLING",
  "website_url": "https://www.test.com",
  "is_dynamic_ads_enabled": true,
  "variant_set_id": "a3f7b2d8-9e54-c1d0-f8b6-4e927ac5d3f1",
  "catalog_id": "d4e8a3c2-b7f9-156e-0ac9-f23d84b1e7c5",
  "status": "LIVE"
}'

    响应

    {
  "id": "12345"
}

/campaign/update 终端

向此终端发送 POST 请求以更新现有的 Campaign。 请求体是 Campaign 对象。 查看 Campaign 对象表的 Update 列，以确定应在请求中包含哪些字段。

此终端返回一个 JSON 对象，其中包含此终端更新的 Campaign 的 Campaign ID (id)。

目标 URL

https://api.ads.axon.ai/manage/v1/campaign/update?account_id=«account-ID»

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/campaign/update?account_id=«account-ID»' \
--header 'Content-Type: application/json' \
--header 'Authorization: «campaign-API-key»' \
--data '
{
  "id": "12345",
  "name": "dynamic_test",
  "status": "PAUSED",
  "type": "WEB",
  "website_url": "https://www.test.com",
  "is_dynamic_ads_enabled": true,
  "variant_set_id": "a3f7b2d8-9e54-c1d0-f8b6-4e927ac5d3f1",
  "catalog_id": "d4e8a3c2-b7f9-156e-0ac9-f23d84b1e7c5",
}'

    响应

    {
  "id": "12345"
}

Campaign 对象

名称类型描述CreateUpdate
bidding_strategyStringBidding strategy for the campaign. Valid values include:
auto_bidding_with_cpm_billing
AppLovin aims to fully use your budget while maximizing results at the lowest possible cost per result. You are charged on every ad impression.
maximize_results_with_cpm_billing
AppLovin aims to fully use your budget while maximizing results, ensuring the cost per result stays in a certain range around your target goal. You are charged on every ad impression.
必要禁止
budgetBudgetCampaign 的预算设置。查看预算。必要可选
catalog_idString动态广告的目录 ID。可选可选
created_atStringCampaign 的创建时间，采用 ISO 8601 格式 (UTC)。已忽略已忽略
end_dateStringCampaign 的结束日期，采用 ISO 8601 格式 (UTC)。必要可选
goalGoalCampaign 的目标设置。请参阅目标。必要可选
hashed_idStringCampaign 的外部 ID。它与 Reporting API 中的 campaign_id_external 和跟踪 URL 宏 中的 {CAMPAIGN_ID} 值相同。禁止已忽略
idLongCampaign ID。禁止必要
is_dynamic_ads_enabledBoolean是否启用动态广告。可选可选
nameStringCampaign 名称。必要可选
start_dateStringCampaign 的开始日期，采用 ISO 8601 格式 (UTC)。不能早于今天的日期。必要禁止
statusStringCampaign 的当前状态。有效值：LIVE、PAUSED。已忽略可选
targetingarray<Targeting>Campaign 投放的目标国家/地区。请参阅定向。必要可选
typeStringCampaign 类型。必须是 WEB必要必要
variant_set_idString动态广告的变体集 ID。可选可选
website_urlString包含跟踪参数的完整的目标 URL。必要可选

定向对象

名称类型描述
country_codeStringISO 3166-1 alpha-2 代码代表目标国家/地区。例如，US 代表美国，FR 代表法国，JP 代表日本。请参阅下方国家代码表以获取完整列表。
region_codesarray<String>An array of region codes that specify target regions in the specified country. These are optional and only apply when the country_code is US. This array should contain valid U.S. state abbreviations (e.g. CA for California, NY for New York). See Table of Region Codes below for the full list.
"targeting": [
  {
    "country_code": "US",
    "region_codes": [ "CA", "FL" ]
  }
]

预算对象

您可以设置全球预算或国家级预算。 创建 Campaign 时必须设置此项。

名称类型描述
daily_budget_for_all_countriesdecimal指定要应用于所有目标国家/地区的统一每日预算。
"budget": {
  "daily_budget_for_all_countries": "6000"
}

目标对象

目标值

目标值取决于目标类型。 CPE/CPP 分别表示单次事件成本/单次购买成本；对于 CHK_ROAS，则表示目标日的百分比回报。

您可以设置全球目标或国家级目标。

名称类型描述
goal_value_for_all_countriesdecimal指定一个您希望在全部目标国家/地区应用的统一目标值。
"goal": {
  "goal_value_for_all_countries": "0.5",
  ⋮
}

目标类型

目标类型定义了 Campaign 的优化目标。

You can only set these values when you create a campaign. If you try to set these values when you update a campaign, the endpoint returns an error.

Cost per custom Event.
goal_type value: CPE

名称类型描述
event_targetString指定 Campaign 针对哪个事件进行优化。
goal_typeString定义 Campaign 的优化目标。
"goal": {
  ⋮
  "goal_type": "CPE",
  "event_target": "signup"
}

素材组

/creative_set/list 终端

向此终端发送 GET 请求，以检索您账户中最多 100 个素材组的列表。 此列表是素材组对象的 JSON 数组。

如果所选页面上没有素材组，此终端将返回一个空数组。

目标 URL

https://api.ads.axon.ai/manage/v1/creative_set/list?account_id=«account-ID»

查询参数

名称描述默认
ids用逗号分隔的素材组 ID 列表。使用此列表将结果筛选为仅具有指定 ID 的结果。通过这种方式，您最多可以指定 100 个 ID。不要将此与 hashed_ids 一起使用。null
hashed_ids用逗号分隔的外部素材组 ID 列表。使用此列表将结果筛选为仅具有指定 ID 的结果。通过这种方式，您最多可以指定 100 个 ID。不要将此与 ids 一起使用。null
page要检索的结果页码。第一页是第 1 页。1
size每页要返回的结果数量。最大数量为 100。100

示例

    已分页的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/list?account_id=«account-ID»&size=50&page=10' \
--header 'Authorization: «campaign-API-key»'

    已筛选的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/list?account_id=«account-ID»&ids=56789' \
--header 'Authorization: «campaign-API-key»'

    响应

    [
  {
    "id": "56789",
    "campaign_id": "12345",
    "type": "WEB",
    "name": "test",
    "assets": [
      {
        "id": "63085821",
        "name": "playable.html",
        "status": "ACTIVE",
        "url": "https://res1.applovin.com/r83948939/playable_raw.html",
        "type": "HOSTED_HTML",
        "resource_type": "HTML",
      },
      {
        "id": "62453682",
        "name": "test1.mp4",
        "status": "ACTIVE",
        "url": "https://res1.applovin.com/r83948939/test1.mp4",
        "asset_type": "VID_LONG_P",
        "resource_type": "VIDEO",
      }
    ],
    "countries": [
      "US"
    ]
  }
]

/creative_set/list_by_campaign_id 终端

向此终端发送 GET 请求来调取您账户中一组 Campaign ID 中包含的素材集信息。该终端一次最多返回 100 个结果。

目标 URL

https://api.ads.axon.ai/manage/v1/creative_set/list_by_campaign_id?account_id=«account-ID»

查询参数

名称描述默认
idsA comma-separated list of campaign IDs. Use this to filter the results to only creative sets with the specified campaign IDs. You can specify a maximum of 100 IDs this way.null
page要检索的结果页码。第一页是第 1 页。1
size每页要返回的结果数量。最大数量为 100。100

响应体参数

名称描述
campaign_countcampaigns 对象中的 Campaign 数量。
creative_set_count此响应中返回的全部 Campaign 的素材集总数。
campaigns包含返回 Campaign 相关信息的字典。键即 Campaign ID。该值为素材组对象数组。

示例

    已分页的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/list_by_campaign_id?account_id=«account-ID»&ids=56789,1648980&size=50&page=10' \
--header 'Authorization: «campaign-API-key»'

    已筛选的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/list_by_campaign_id?account_id=«account-ID»&ids=56789' \
--header 'Authorization: «campaign-API-key»'

    响应

    {
  "campaign_count": 2,
  "creative_set_count": 2,
  "campaigns": {
    "12345": [
      {
        "id": "56789",
        "type": "WEB",
        "name": "test",
        "assets": [
          {
            "id": "63085821",
            "name": "playable.html",
            "status": "ACTIVE",
            "url": "https://res1.applovin.com/r83948939/playable_raw.html",
            "type": "HOSTED_HTML",
            "resource_type": "HTML",
          },
          {
            "id": "62453682",
            "name": "test1.mp4",
            "status": "ACTIVE",
            "url": "https://res1.applovin.com/r83948939/test1.mp4",
            "asset_type": "VID_LONG_P",
            "resource_type": "VIDEO",
          }
        ],
        "countries": [
          "US"
        ],
        "campaign_id": "56789",
        "created_at": "2025-07-18T10:56:05"
      }
    ],
    "1648980": [
      {
        "id": "27227280",
        "type": "WEB",
        "name": "Test_1",
        "assets": [
          {
            "id": "63085821",
            "name": "playable.html",
            "status": "ACTIVE",
            "url": "https://res1.applovin.com/r83948939/playable_raw.html",
            "type": "HOSTED_HTML",
            "resource_type": "HTML",
          },
          {
            "id": "62453682",
            "name": "test1.mp4",
            "status": "ACTIVE",
            "url": "https://res1.applovin.com/r83948939/test1.mp4",
            "asset_type": "VID_LONG_P",
            "resource_type": "VIDEO",
          }
        ],
        "status": "PAUSED",
        "countries": [],
        "campaign_id": "1648980",
        "created_at": "2025-06-03T23:23:12"
      }
    ]
  }
}

/creative_set/create 终端

向此终端发送 POST 请求以创建新的素材组。 请求体是素材组对象。 查看素材组对象表的 Create 列，以确定应在请求中包含哪些字段。

此终端返回一个 JSON 对象，其中包含此终端创建的素材组的素材组 ID (id)。

目标 URL

https://api.ads.axon.ai/manage/v1/creative_set/create?account_id=«account-ID»

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/create?account_id=«account-ID»' \
--header 'Content-Type: application/json' \
--header 'Authorization: «campaign-API-key»' \
--data '
{
  "campaign_id": "12345",
  "type": "WEB",
  "name": "test",
  "assets": [
    {
      "id": "62453682"
    }
  ],
  "countries": [
    "US"
  ]
}

    响应

    {
  "id": "56789",
  "version": "V2"
}

/creative_set/update 终端

向此终端发送 POST 请求以更新现有的素材组。 请求体是素材组对象。 查看素材组对象表的 Update 列，以确定应在请求中包含哪些字段。

此终端返回一个 JSON 对象，其中包含此终端更新的素材组的素材组 ID (id)。

目标 URL

https://api.ads.axon.ai/manage/v1/creative_set/update?account_id=«account-ID»

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/update?account_id=«account-ID»' \
--header 'Content-Type: application/json' \
--header 'Authorization: «campaign-API-key»' \
--data '
{
  "id": "56789",
  "campaign_id": "12345",
  "type": "WEB",
  "name": "test",
  "assets": [
    {
      "id": "63085821"
    },
    {
      "id": "62453682"
    }
  ],
  "countries": [
    "US"
  ]
}

    响应

    {
  "id": "56789",
  "version": "V2"
}

素材组版本

AppLovin 支持两种不同的素材组版本：

  • V1：每种资源类型只能上传 1 项资源。
  • V2：每种资源类型最多可上传 10 项资源。

When you create a new creative set, its version is always V2 unless you clone it from an existing creative set that is V1.

素材组对象

名称类型描述CreateUpdate
assetsarray<CreativeSetAsset>Assets to include in the creative set. See CreativeSetAsset.
May contain the following types: HOSTED_HTML, VID_LONG_P, VID_SHORT_P, IMG_BANNER, IMG_INTER_P
Must contain either a HOSTED_HTML, or an IMG_INTER_P and a video (VID_LONG_P or VID_SHORT_P).		必要可选
campaign_idString此素材组所属的 Campaign 的 ID。必要必要
creative_set_urlString包含跟踪参数的完整的目标 URL。该设置会覆盖 Campaign 系列级别的 URL。可选可选
idString素材组 ID。禁止必要
hashed_idString创意集的外部 ID。它与 Reporting API 中的 creative_set_id 和跟踪 URL 宏 中的 {CREATIVE_SET_ID} 值相同。禁止已忽略
nameString素材组的名称。必要可选
statusString素材组的状态：LIVE 或 PAUSED已忽略可选
typeStringCampaign 类型。必须为 WEB。必要必要

CreativeSetAsset 对象

名称类型描述创建素材组
idString资源 ID。您在创建或更新素材组时使用此 ID。必要
nameString资源名称。已忽略
statusString资源状态。可能的值有：IN_REVIEW、REJECTED、ACTIVE、PAUSED、UNKNOWN。已忽略
typeString素材资源类型。可能的值有：VID_LONG_P、VID_SHORT_P、HOSTED_HTML、IMG_BANNER、IMG_INTER_P。已忽略
urlString资源的 URL，例如：https://res1.applovin.com/r83948939/test1.mp4已忽略

/creative_set/clone 终端

向此终端发送 POST 请求，以将现有素材组克隆到其他 Campaign。

此终端返回一个 JSON 对象，其中包含生成的克隆素材组的素材组 ID (id)。

目标 URL

https://api.ads.axon.ai/manage/v1/creative_set/clone?account_id=«account-ID»

请求体参数

名称类型描述
campaign_idInteger您要将素材组克隆到的 Campaign 的 ID。
creative_set_idInteger您要克隆的素材组的 ID。
statusString克隆的素材组的状态：LIVE 或 PAUSED。

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/creative_set/clone?account_id=«account-ID»' \
--header 'Content-Type: application/json' \
--header 'Authorization: «campaign-API-key»' \
--data '
{
  "campaign_id": "12345",
  "creative_set_id": "39823",
  "status": "LIVE"
}

    响应

    {
  "id": "56795",
  "version": "V1"
}

资源

/asset/list 终端

向此终端发送 GET 请求，以检索您账户中最多 100 个资源的列表。 此列表是资源对象的 JSON 数组。

如果选定页面上没有资源，此终端将返回一个空数组。

目标 URL

https://api.ads.axon.ai/manage/v1/asset/list?account_id=«account-ID»

查询参数

名称描述默认
ids用逗号分隔的资源 ID 列表。使用此列表将结果筛选为仅具有指定 ID 的结果。通过这种方式，您最多可以指定 100 个 ID。null
page要检索的结果页码。第一页是第 1 页。1
resource_type资源类型种类。使用此项将结果筛选为仅具有该资源类型的结果。可能的值有：image、html、videonull
size每页要返回的结果数量。最大数量为 100。100

资源对象

名称类型描述
asset_typeString素材资源类型。可能的值有：VID_LONG_P、VID_SHORT_P、HOSTED_HTML、IMG_BANNER、IMG_INTER_P。
idString资源 ID。创建或更新素材组时使用此项。
nameString资源名称。
resource_typeString资源类型。可能的值有：IMAGE、VIDEO 或 HTML。
statusString资源状态。可能的值有：IN_REVIEW、REJECTED、ACTIVE 或 PAUSED。
upload_timeString资源的上传时间，例如：2025-04-27T23:34:06
urlString上传的资源的 URL，例如：https://res1.applovin.com/r83948939/test1.mp4

示例

    已分页的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/asset/list?account_id=«account-ID»&size=50&page=10' \
--header 'Authorization: «campaign-API-key»'

    已筛选的请求

    curl --location 'https://api.ads.axon.ai/manage/v1/asset/list?account_id=«account-ID»&ids=12345' \
--header 'Authorization: «campaign-API-key»'

    响应

    [
  {
    "id": "65061535",
    "name": "playable.html",
    "status": "ACTIVE",
    "url": "https://res1.applovin.com/r83948939/playable_raw.html",
    "asset_type": "HOSTED_HTML",
    "resource_type": "HTML",
    "upload_time": "2025-07-04T07:25:30"
  },
  {
    "id": "65061052",
    "name": "test1.mp4",
    "status": "ACTIVE",
    "url": "https://res1.applovin.com/r83948939/test1.mp4",
    "asset_type": "VID_LONG_P",
    "resource_type": "VIDEO",
    "upload_time": "2025-07-04T07:24:57"
  }
]

/asset/upload 终端

Make a POST request to this endpoint to upload new asset files. You can upload up to 40 files at once. The total size must not exceed 10 GB and the size of a single file should not exceed 1 GB. After the upload, AppLovin processes, optimizes, and reviews the assets.

此终端返回一个带有 upload_id 的 JSON 对象。 您可以使用此 ID 查询已上传资源的状态。 请参阅下面的 /asset/upload_result 终端。

目标 URL

https://api.ads.axon.ai/manage/v1/asset/upload?account_id=«account-ID»

请求表单字段

名称类型描述
filesarray<File>Each filename must be unique in the batch and each file must have a Content-Type. Supported Content-Type values are text/html, image/gif, image/jpeg, image/png, video/mp4, and video/quicktime.

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/asset/upload?account_id=«account-ID»' \
--header 'Authorization: «campaign-API-key»' \
--form 'files=@"/path/to/playable.html"' \
--form 'files=@"/path/to/video.mp4"'

    响应

    {
  "upload_id": "c7a3db4226b24bd8bb0b38c46654aa54"
}

/asset/upload_result 终端

向此终端发送 GET 请求以检查上传请求的状态。

此终端返回一个 JSON 对象，其中包含有关指定 upload_id 的信息。

目标 URL

https://api.ads.axon.ai/manage/v1/asset/upload_result?account_id=«account-ID»&upload_id=«upload-ID»

请求查询参数

名称类型描述
upload_idString/asset/upload 终端返回的 upload_id。

响应体参数

名称类型描述
detailsarray<AssetUploadDetail>每个已上传文件的详细信息。请参阅 AssetUploadDetail。
summaryAssetUploadSummary已上传文件的状态概览。请参阅 AssetUploadSummary。
upload_statusStringThe status of upload asset request: PENDING if any files are still processing, otherwise FINISHED.

AssetUploadSummary 对象

名称类型描述
failedInteger失败资源的数量。
pendingInteger待处理资源的数量。
successInteger已成功处理资源的数量。
totalInteger上传请求中全部资源的数量。

AssetUploadDetail 对象

名称类型描述
error_messageString如果上传失败，这会包含失败的原因。
file_statusString资源的上传状态。可能的值有：PENDING、FAILURE 或 SUCCESS。
idString资源 ID。
nameString资源名称。
resource_typeString资源类型。可能的值有：IMAGE、VIDEO 或 HTML。
uploadTimeString资源的上传时间，例如：2025-04-27T23:34:06
urlString上传的资源的 URL，例如：https://res1.applovin.com/r83948939/test1.mp4

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/asset/upload_result?account_id=«account-ID»&upload_id=«upload-ID»' \
--header 'Authorization: «campaign-API-key»' \

    响应

    {
  "summary": {
    "total": 2,
    "success": 2,
    "failed": 0,
    "pending": 0
  },
  "details": [
    {
      "id": "66218554",
      "name": "playable.html",
      "uploadTime": "2025-07-19T08:24:29",
      "url": "https://res1.applovin.com/r0186867/b30361c076022e02ea3cc1b80a6855f5491a6d70_raw.raw",
      "resource_type": "HTML",
      "file_status": "SUCCESS"
    },
    {
      "id": "65061052",
      "name": "test1.mp4",
      "uploadTime": "2025-07-19T08:24:29",
      "url": "https://res1.applovin.com/r83948939/test1.mp4",
      "resource_type": "VIDEO",
      "file_status": "SUCCESS",
    }
  ],
  "upload_status": "FINISHED"
}

目录

/campaign/catalog_info 终端

向此终端发送 GET 请求以检索可用于动态广告配置的目录和变体集信息。 此终端仅适用于电子商务/网页账户。

目标 URL

https://api.ads.axon.ai/manage/v1/campaign/catalog_info?account_id=«account-ID»

示例

    请求

    curl --location 'https://api.ads.axon.ai/manage/v1/campaign/catalog_info?account_id=«account-ID»' \
--header 'Authorization: «campaign-API-key»'

    响应

    {
  "catalogs": [
    {
      "id": "d4e8a3c2-b7f9-156e-0ac9-f23d84b1e7c5",
      "name": "My Catalog",
      "variant_sets": [
        {
          "id": "a3f7b2d8-9e54-c1d0-f8b6-4e927ac5d3f1",
          "name": "[Default] All Variants",
          "catalog_id": "d4e8a3c2-b7f9-156e-0ac9-f23d84b1e7c5",
          "total_variants": "497",
          "total_items": "105"
        },
        {
          "id": "7c9a5e2b-1f04-d8e3-a6b7-c49f2d1350ea",
          "name": "Variants above $20",
          "catalog_id": "d4e8a3c2-b7f9-156e-0ac9-f23d84b1e7c5",
          "total_variants": "245",
          "total_items": "63"
        }
      ]
    }
  ]
}

目录对象

名称类型描述
idString在 Campaign 中用作 catalog_id 的唯一目录 ID。
nameString该目录的名称。
variant_setsarray<VariantSet>该目录中的变体集列表。

VariantSet 对象

名称类型描述
idString在 Campaign 中用作 catalog_id 的唯一目录标识符。
nameString此变体集的名称。
catalog_idString此变体集所在目录的 ID。
total_variantsInteger动态广告可用的商品变体数
total_itemsInteger此变体中包含的独特商品/产品数量。

国家代码表

  • `AD`
  • `AE`
  • `AF`
  • `AG`
  • `AI`
  • `AL`
  • `AM`
  • `AO`
  • `AR`
  • `AS`
  • `AT`
  • `AU`
  • `AW`
  • `AX`
  • `AZ`
  • `BA`
  • `BB`
  • `BD`
  • `BE`
  • `BF`
  • `BG`
  • `BH`
  • `BI`
  • `BJ`
  • `BL`
  • `BM`
  • `BN`
  • `BO`
  • `BQ`
  • `BR`
  • `BS`
  • `BT`
  • `BW`
  • `BY`
  • `BZ`
  • `CA`
  • `CD`
  • `CF`
  • `CG`
  • `CH`
  • `CI`
  • `CK`
  • `CL`
  • `CM`
  • `CN`
  • `CO`
  • `CR`
  • `CV`
  • `CW`
  • `CY`
  • `CZ`
  • `DE`
  • `DJ`
  • `DK`
  • `DM`
  • `DO`
  • `DZ`
  • `EC`
  • `EE`
  • `EG`
  • `EH`
  • `ER`
  • `ES`
  • `ET`
  • `FI`
  • `FJ`
  • `FK`
  • `FM`
  • `FO`
  • `FR`
  • `GA`
  • `GB`
  • `GD`
  • `GE`
  • `GF`
  • `GG`
  • `GH`
  • `GI`
  • `GL`
  • `GM`
  • `GN`
  • `GP`
  • `GQ`
  • `GR`
  • `GT`
  • `GU`
  • `GW`
  • `GY`
  • `HK`
  • `HN`
  • `HR`
  • `HT`
  • `HU`
  • `ID`
  • `IE`
  • `IL`
  • `IM`
  • `IN`
  • `IQ`
  • `IS`
  • `IT`
  • `JE`
  • `JM`
  • `JO`
  • `JP`
  • `KE`
  • `KG`
  • `KH`
  • `KI`
  • `KM`
  • `KN`
  • `KR`
  • `KW`
  • `KY`
  • `KZ`
  • `LA`
  • `LB`
  • `LC`
  • `LI`
  • `LK`
  • `LR`
  • `LS`
  • `LT`
  • `LU`
  • `LV`
  • `LY`
  • `MA`
  • `MC`
  • `MD`
  • `ME`
  • `MF`
  • `MG`
  • `MH`
  • `MK`
  • `ML`
  • `MM`
  • `MN`
  • `MO`
  • `MP`
  • `MQ`
  • `MR`
  • `MS`
  • `MT`
  • `MU`
  • `MV`
  • `MW`
  • `MX`
  • `MY`
  • `MZ`
  • `NA`
  • `NC`
  • `NE`
  • `NF`
  • `NG`
  • `NI`
  • `NL`
  • `NO`
  • `NP`
  • `NQ`
  • `NR`
  • `NU`
  • `NZ`
  • `OM`
  • `PA`
  • `PE`
  • `PF`
  • `PG`
  • `PH`
  • `PK`
  • `PL`
  • `PM`
  • `PN`
  • `PR`
  • `PS`
  • `PT`
  • `PW`
  • `PY`
  • `QA`
  • `RE`
  • `RO`
  • `RS`
  • `RU`
  • `RW`
  • `SA`
  • `SB`
  • `SC`
  • `SD`
  • `SE`
  • `SG`
  • `SH`
  • `SI`
  • `SJ`
  • `SK`
  • `SL`
  • `SM`
  • `SN`
  • `SO`
  • `SR`
  • `SS`
  • `ST`
  • `SV`
  • `SX`
  • `SZ`
  • `TC`
  • `TD`
  • `TG`
  • `TH`
  • `TJ`
  • `TK`
  • `TL`
  • `TM`
  • `TN`
  • `TO`
  • `TR`
  • `TT`
  • `TV`
  • `TW`
  • `TZ`
  • `UA`
  • `UG`
  • `US`
  • `UY`
  • `UZ`
  • `VA`
  • `VC`
  • `VE`
  • `VG`
  • `VI`
  • `VN`
  • `VU`
  • `WF`
  • `WS`
  • `XK`
  • `YE`
  • `YT`
  • `ZA`
  • `ZM`
  • `ZW`

地区代码表

  • `AK` (阿拉斯加州)
  • `AL` (阿拉巴马州)
  • `AR` (阿肯色州)
  • `AZ` (亚利桑那州)
  • `CA` (加利福尼亚州)
  • `CO` (科罗拉多州)
  • `CT` (康涅狄格州)
  • `DC` (哥伦比亚特区)
  • `DE` (特拉华州)
  • `FL` (佛罗里达州)
  • `GA` (乔治亚州)
  • `HI` (夏威夷州)
  • `IA` (爱荷华州)
  • `ID` (爱达荷州)
  • `IL` (伊利诺伊州)
  • `IN` (印第安纳州)
  • `KS` (堪萨斯州)
  • `KY` (肯塔基州)
  • `LA` (路易斯安那州)
  • `MA` (马萨诸塞州)
  • `MD` (马里兰州)
  • `ME` (缅因州)
  • `MI` (密歇根州)
  • `MN` (明尼苏达州)
  • `MO` (密苏里州)
  • `MS` (密西西比州)
  • `MT` (蒙大拿州)
  • `NC` (北卡罗莱纳州)
  • `ND` (北达科他州)
  • `NE` (内布拉斯加州)
  • `NH` (新罕布什尔州)
  • `NJ` (新泽西州)
  • `NM` (新墨西哥州)
  • `NV` (内华达州)
  • `NY` (纽约州)
  • `OH` (俄亥俄州)
  • `OK` (俄克拉荷马州)
  • `OR` (俄勒冈州)
  • `PA` (宾夕法尼亚州)
  • `PR` (波多黎各)
  • `RI` (罗德岛州)
  • `SC` (南卡罗莱纳州)
  • `SD` (南达科他州)
  • `TN` (田纳西州)
  • `TX` (得克萨斯州)
  • `UT` (犹他州)
  • `VA` (弗吉尼亚州)
  • `VT` (佛蒙特州)
  • `WA` (华盛顿州)
  • `WI` (威斯康星州)
  • `WV` (西弗吉尼亚州)
  • `WY` (怀俄明州)
这篇文章有帮助吗？
PREVIOUS
Getting started
NEXT
Reporting API
axon logoaxon logo
axon logoaxon logo
© 2026 AppLovin. All rights reserved.
政策中心使用条款发布商政策需求方合作伙伴政策平台管控隐私隐私选项CPRACookies Settings
search