开发人员指南概述

亚马逊广告 API 概览

商品推广广告组

创建广告组

使用广告组可以组织、管理和跟踪广告活动中商品的表现。 同一广告组中的商品采用相同的竞价和投放方式(关键词投放或商品投放)。每个广告活动都包含一个或多个广告组。

前提条件

要创建广告组,您必须首先创建广告活动,以获得 campaignId。您可以在商品推广活动中进一步了解如何创建广告活动。

优秀实践

请求

接口

POST /sp/adGroups

示例

如果您要复制示例,请确保输入自己的客户端编号、访问令牌、广告活动编号和配置文件标识符。

curl --location --request POST 'https://advertising-api.amazon.com/sp/adGroups' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Authorization: Bearer xxxxxxxx' \
--header 'Accept: application/vnd.spAdGroup.v3+json' \
--header 'Content-Type: application/vnd.spAdGroup.v3+json' \
--data-raw '[
  {
    "name": name,
    "campaignId": 153839444046652,
    "defaultBid": "3.0",
    "state": "enabled"
  }
]'

响应

成功的响应将返回 207 响应代码。error 数组包含创建广告组时可能出现的任何错误消息。success 数组返回包含 adGroupId 的广告组对象。

 {
    "adGroups": {
        "error": [],
        "success": [
            {
                "adGroup": {
                    "adGroupId": "38308592845076",
                    "name": "adGroupTest"
                },
                "adGroupId": "38308592845076",
                "index": 0
            }
        ]
    }
}

后续步骤