开发人员指南概述

亚马逊广告 API 概览

借助建议优化展示型推广活动

本教程将指导您根据建议来创建和更新展示型推广活动。

前提条件

按照此处的设置说明进行操作。如果您之前设置过展示型推广 Postman 集合，则可以跳过这些步骤。

说明

商品推荐 API 使用 OAuth 进行保护，并需要有效的访问令牌（access token）。您需要执行以下步骤：

  1. 获取访问令牌
  2. 调用 Recommendations 服务
  3. 创建或更新展示型推广活动

第 1 步：获取访问令牌

执行以下步骤以获取新的访问令牌。如果您已经获取了访问令牌，但该令牌已过期，则可以使用 OAuth Refresh Token 请求来替换过期的访问令牌。否则，请按照以下说明操作：

  1. 在 collections 选项卡中，选择 Amazon SD API (Contextual) 以展开子文件夹。

  2. 在子文件夹中，选择 OAuth。

  3. 选择 GET OAuth Access Code 请求。

  4. 选择 send 按钮发送请求。

  5. 该响应是一个填充了登录表单的网页。选择 preview。

  6. 选择 OAuth Form Login 以模拟表单登录。这将使用您之前在环境中配置的电子邮件和密码。请注意，如果您是首次登录，则会被重定向到同意页面以授予权限。

  7. OAuth Form Login 返回授权码。此代码是一个中间代码（intermediary code），返回给您的 redirect_uri。Postman 脚本将此值复制到正确的变量中，以供下一步使用。

  8. 打开 OAuth Code to Token 请求。选择 send。响应中包含访问令牌和刷新令牌（refresh token ）。例如：

    {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>",
    "token_type": "bearer",
    "expires_in": 3600
}

  9. 您还需要为 Amazon-Advertising-API-Scope 标头（header）设置一个值。选择 GET profile information 请求，然后选择 send。该响应包含了 profileId 字段中的值。

第 2 步：调用 Recommendations 服务

使用 Postman 集合调用 Recommendations API。

  1. 在 collections 选项卡中，选择 Amazon SD API Recommendations，然后展开 Recommendations 子文件夹。

  2. 选择 SD Product Recommendations 操作。

  3. 选择 Body 选项卡，在 products 数组中使用您的 ASIN 修改负载（payload）：

    {
    "tactic": "T00020",
    "products": [
        {
            "asin": "B015FK1EH2"
        }
    ],
    "typeFilter": [
        "PRODUCT"
    ]
}

注意： 您可以使用相同的对象结构在 products 数组中添加多个 ASIN。

  1. 点击 Send。该响应会返回一组按排名顺序排列的建议商品 ASIN。
  2. 点击 Tests 选项卡并查看代码。在第 8 行中，排名编号指定要保存到变量 targetASIN 中的 ASIN。您可以更改此值以使用其他排名编号。
  3. 打开 Get Amazon ASIN Details 请求，调用亚马逊详情页获取建议的 ASIN。在该响应中，将 Pretty 选项卡切换到 Preview 以检查网页。

第 3 步：创建或更新展示型推广活动

要使用 Postman 创建展示型推广活动，请按照本教程中的步骤进行操作，但创建投放子句除外。使用以下说明根据建议的 ASIN 创建投放子句：

  1. 打开 Amazon SD API (Contextual) collection，选择 body 选项卡，修改字段值以反映您的广告活动。具体操作是，将 expression 对象的 value 属性更改为 {{targetASIN}}。{{targetASIN}} 的值是从上一个请求中自动复制的。您将使用相同的请求，使用建议的 ASIN 更新含有投放子句的现有广告活动。

    [
    {
        "adGroupId": "{{adGroupId}}",
        "state": "enabled",
        "expressionType": "manual",
        "expression": [
            {
                "type": "asinSameAs",
                "value": "{{targetASIN}}"
            }
        ]
    }
]

  2. 点击 send 按钮并验证您的请求是否成功。例如：

    [
{
    "targetId": 111222333444555,
    "code": "SUCCESS"
}
]

  3. 您可以使用以下方法删除效果不佳的现有定向子句：

    DELETE /sd/targets/222333444555666 HTTP/1.1

这种方法允许您通过删除效果不佳的投放子句，根据商品推荐和广告活动效果，以程序化方式优化投放子句。

总结

在本教程中，您了解了如何使用商品建议 API 来创建和更新广告活动，这样您就能够根据广告活动目标来优化广告活动的效果。

Amazon Advertising logo