开发人员指南概述

亚马逊广告 API 概览

使用测试账户

成功创建了测试账户后，您就可以使用相同的客户端编号以及拥有 advertising::campaign_management 作用域权限的访问令牌来访问 API 中的其他接口。

测试账户中的产品数据

如果您在账户创建过程中将供应商测试账户链接到供应商代码，您可以使用产品元数据 API 获取销售账户中 ASIN 的相关信息，该信息随后可以用于测试广告活动的创建。

对于作者测试账户，测试电子书 ASIN 将随测试账户一同创建。这些 ASIN 可以通过 GET 请求 /testAccounts检索。

配置文件

向配置文件资源 发送 GET 请求将返回已授权用户账户的配置文件列表。亚马逊广告 API 中的每个配置文件代表特定站点中用户账户的广告账户。

对于测试账户，在返回的配置文件中，accountInfo 中的 id 键将与 GET 请求/testAccounts.返回的 id 相匹配。

[
    {
        "profileId": "xxxxx",
        "countryCode": "US",
        "currencyCode": "USD",
        "timezone": "America/Los_Angeles",
        "accountInfo": {
            "marketplaceStringId": "ATVPDKIKX0DER",
            "id": "ENTITYxxxxxxxxxxx",
            "type": "vendor",
            "name": "3PTestBrand-xxxxxxx",
            "validPaymentMethod": true
        }
    }
]

在测试亚马逊广告 API 之前，使用返回的配置文件中的 profileId 作为后续请求中 Amazon-Advertising-API-Scope 标头的值。

测试商品推广

使用测试账户的 profileId，您可以测试商品推广下的任何 API。

注意

可以使用测试账户测试预算规则 和基于规则的竞价 API，但该测试不会提供完整的体验。测试账户可以用于配置预算规则和竞价规则，但由于广告不会投放，规则不会生效。

测试品牌推广

使用测试账户的 profileId，您可以测试品牌推广下的任何 API。

请参阅有关品牌推广活动创建的技术规范，像在真实账户中一样创建测试广告活动。

注意

可以使用测试账户测试预算规则 API，但测试不会提供完整的体验。测试账户可以用于配置规则，但由于广告不会投放，规则不会生效。

品牌推广活动的审核

亚马逊广告测试账户启用了自动审核功能，以便测试品牌推广活动和 API。在测试账户下创建的任何品牌推广活动都会得到批准并可用于测试。

注意

测试账户中的广告活动批准并不意味着在真实广告主账户中创建的同一广告活动会被批准。标准广告主账户中的广告活动将按照常规审核流程进行审核。

测试品牌推广活动的创意素材

创建品牌推广活动素材时需要提供创意素材。您可以使用测试账户并通过以下两种方式创建新的素材：

使用店铺 API 创建素材

  1. 使用stores/createAsset 操作创建新的素材。请记下响应中返回的 assetID。
  2. 使用上一步中的 assetID 创建品牌推广活动。

使用创意素材 API 创建素材*（仅限图片）*

  1. 按照创意素材 API 文档中的流程上传并注册任何新的图片素材。
  2. 素材注册成功后，请记下注册请求返回的 assetId 并使用它来创建品牌推广活动。

无论使用哪种方法，广告活动和创意素材都将通过自动审核获得批准。无需对创意素材进行单独审核。素材将在创建广告活动时使用的 brandEntityId 下提供。

可以使用 stores/listAssets 操作获取现有素材的列表，以便将来创建 品牌推广活动时使用。

不支持的品牌推广 API

以下品牌推广的 API 不支持测试账户，并且不建议使用它们：

要了解其他不受支持的功能，请参阅不支持测试账户的功能。

测试品牌推广视频广告活动

创建品牌推广活动视频广告活动时需要提供视频素材。您可以使用测试账户按照以下方法创建新的视频素材：

  1. 使用media/upload resource 获取用于上传视频的 URL。

    目前，仅支持品牌推广作为广告方案类型，且仅支持视频作为创意素材类型。请求体如下：

    {
"programType": "SponsoredBrands",
"creativeType": "Video"
}

    响应中包含您用于上传视频的 URL：

    {
"uploadLocation" : "URL for uploading your file"
}

  2. 有多种方法可以使用预签名 URL 来上传视频。在此示例中，我们将解释如何使用 Postman：

    1. 在 Postman 中，选择“文件”，然后选择“新建”。
    2. 选择“HTTP 请求”以创建 HTTP 请求。
    3. 在 HTTP 操作下拉列表中，选择 PUT。
    4. 在“输入请求 URL”文本框中，添加上述响应中的预签名 URL。
    5. 在第 4 步的“输入请求 URL”文本框下的横向属性列表中，选择“Body”。
    6. 点击“二进制”单选按钮。
    7. 在第 5 步下方的窗格中，点击“选择文件”按钮。导航到您要上传的视频文件，选中该文件，然后选择“确定”。
    8. 点击“发送”。

  3. 上传完成后，您将使用 media/complete 资源来获取 mediaId 属性。

  4. 在第 3 步中获取到 mediaId 后，将其作为 creative 属性的 videoMediaIds 数组的一部分，传递到品牌推广视频广告活动 创建操作的请求对象中。

Amazon Advertising logo