开发人员指南概述

亚马逊广告 API 概览

商品推广活动

广告活动是商品推广实体层次结构的最高层级。您可以在广告活动层次结构中进一步了解广告活动的其他组成部分。

预算、投放类型、开始日期和结束日期都在广告活动级别定义。

进一步了解：

请求

接口

POST /sp/campaigns

参数

| 名称 | 描述 | |--- |--- | | portfolioId | 广告组合允许广告主根据业务需求将广告活动分组。进一步了解广告组合，或查看如何创建广告组合。 | | name | 广告活动的名称。请注意，此字段的幂等性对卖家和供应商的作用不同。卖家不得使用重复的广告活动名称，但供应商可以有重复的广告活动名称。 | | targetingType | 选项可以是 MANUAL 或 AUTO。进一步了解自动广告活动和手动广告活动。 | | state | 选项包括 ENABLED 或 PAUSED。如果您不希望立即投放广告活动，请将 state 设置为 PAUSED。 | | budget.budgetType | 唯一支持的值是 DAILY。 | | budget.budget | 以您配置文件的货币表示的金额。允许的最高和最低预算取决于您的地理位置。有关详细信息，请参阅按站点确定的预算约束。 | | startDate | 广告活动的开始日期，格式为 YYYY-MM-DD。这个日期不能是过去的日期。注意： 如果设置为当天，且 state 设置为 ENABLED，则广告活动在有活跃的广告组、产品广告、定向子句或关键词后立即开始投放。 | | endDate | 广告活动的结束日期。如果未指定，则广告活动将没有结束日期。 | | dynamicBidding.strategy | 广告活动的竞价方案。可能的值为 LEGACY_FOR_SALES、AUTO_FOR_SALES、MANUAL 和 RULE_BASED。进一步了解竞价方案。 | | dynamicBidding.placementBidding.percentage | 您要为指定广告位调整竞价的百分比。 | | dynamicBidding.placementBidding.placement | 您要调整竞价的 Amazon.com 广告位。进一步了解广告位。 | | tags | 您可以添加到广告活动的可选标签，用于管理或报告目的。 |

示例

手动广告活动

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxx' \
--header 'Accept: application/vnd.spCampaign.v3+json' \
--header 'Content-Type: application/vnd.spCampaign.v3+json' \
--data-raw '{
  "campaigns": [
    {
      "endDate": "2022-11-08",
      "name": "Test manual targeting SP campaign",
      "targetingType": "MANUAL",
      "state": "ENABLED",
      "dynamicBidding": {
        "placementBidding": [
          {
            "percentage": 900,
            "placement": "PLACEMENT_TOP"
          }
        ],
        "strategy": "LEGACY_FOR_SALES"
      },
      "startDate": "2022-10-31",
      "budget": {
        "budgetType": "DAILY",
        "budget": 100
      }
    }
  ]
}'

自动广告活动

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Accept: application/vnd.spCampaign.v3+json' \
--header 'Content-Type: application/vnd.spCampaign.v3+json' \
--data-raw '{
  "campaigns": [
    {
      "endDate": "2022-11-08",
      "name": "Test SP auto campaign",
      "targetingType": "AUTO",
      "state": "ENABLED",
      "dynamicBidding": {
        "placementBidding": [
          {
            "percentage": 900,
            "placement": "PLACEMENT_TOP"
          }
        ],
        "strategy": "LEGACY_FOR_SALES"
      },
      "startDate": "2022-10-31",
      "budget": {
        "budgetType": "DAILY",
        "budget": 100
      }
    }
  ]
}'

响应

成功的调用将返回 207 响应代码，并指示所创建的广告活动的索引和广告活动编号。

{
    "campaigns": {
        "error": [],
        "success": [
            {
                "campaignId": "218293333782035",
                "index": 0
            }
        ]
    }
}

提示

如果您希望在响应中收到完整的广告活动对象，请使用 Prefer 标头并设置为 return=representation。

后续步骤

创建广告活动后，您需要创建至少一个广告组。

Amazon Advertising logo