开发人员指南概述

亚马逊广告 API 概览

如何创建展示型推广受众广告活动

本操作指南将引导您完成创建展示型推广活动的步骤。

前提条件

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

说明

获取访问令牌

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

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

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

  3. 选择 GET OAuth Access Code 请求。

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

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

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

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

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

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

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

创建展示型推广活动

要使用 Postman 创建展示型推广活动，请按以下步骤操作：

  1. 在 Postman 集合中，打开 创建一项或多项广告活动 请求。选择体选项卡并修改字段值以反映您的广告活动。例如：

    [{
"name": "My Audiences Campaign",
"tactic": "T00030",
"startDate": "20200810",
"endDate": "20301201",
"state": "enabled",
"budget": 100.00,
"budgetType": "daily",
"costType": "cpc"
}]

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

    [
{
    "campaignId": 222756009537583,
    "code": "SUCCESS"
}
]

  3. 打开后续请求。获取请求的广告活动并选择 send。上一个响应中的 campaignId 值将自动复制到后续请求中。

    {
    "campaignId": 222756009537583,
    "name": "My Audiences Campaign 2",
    "tactic": "T00030",
    "startDate": "20200812",
    "endDate": "20301201",
    "state": "paused",
    "budget": 100.00,
    "budgetType": "daily",
    "costType": "cpc",
    "deliveryProfile": "as_soon_as_possible"
}

  4. 重复相同的步骤以创建并检索其余组成部分。

  1. 来自 GET 获取由标识符指定的定向子句 的最终响应类似于：

    {
    "adGroupId": 209426065354910,
    "bid": 0.25,
    "expression": [
        {
            "type": "views",
            "value": [
                {
                    "type": "similarProduct"
                },
                {
                    "type": "lookback",
                    "value": "30"
                }
            ]
        }
    ],
    "expressionType": "manual",
    "resolvedExpression": [
        {
            "type": "views",
            "value": [
                {
                    "type": "similarProduct"
                },
                {
                    "type": "lookback",
                    "value": "30"
                }
            ]
        }
    ],
    "state": "enabled",
    "targetId": 235944225366139
}

使用展示型推广 API 修改现有广告活动

您还可以修改展示型推广活动以更新值或删除资源。展开 Amazon SD API 集合中的 修改广告活动 文件夹，对这些请求进行试验，并根据您的要求修改广告活动。每个组成部分都包含一个 PUT（更新）和 DELETE（存档）资源。

报告

您还可以请求并下载报告，以了解有关广告活动效果的详细指标。展开报告文件夹并检查请求：

使用 Postman 自动测试展示型推广活动

在之前的段落中，您通过手动调用展示型推广 API 创建了广告活动。您还可以自动创建广告活动，包括使用 Postman Collection Runner 批量创建广告活动。

  1. 在 Postman 中，选择左上角的 Runner 按钮。这将打开一个新窗口。
  2. 在 Collection Runner 中，选择 Amazon SD API (AUDT) 集合。
  3. 对于 Environment 字段，选择 Amazon SD API。
  4. 对于 RUN ORDER字段，取消选择 All。然后，选择以 OAuth Refresh Token 开头的所有请求。这一步假设您拥有有效的访问令牌。如果未获得访问令牌，则可以手动发出 OAuth 请求以获取访问令牌，如前几节所述。
  5. 打开 创建一项或多项广告活动 请求。输入一个唯一名称。如果您没有输入唯一的名称，则第一次调用将因为广告活动名称重复而导致失败。
  6. 选择 Run Amazon SD API。
  7. 验证结果。如果结果符合预期，则表示您已成功自动创建展示型推广活动。

摘要

在本教程中，您学习了如何使用 Audiences API 来创建并更新广告活动，这有助于您进行受众投放，并提升产品的知名度和销量。

Amazon Advertising logo