开发人员指南概述

亚马逊广告 API 概览

如何创建展示型推广内容相关投放广告活动

本操作指南将向您介绍创建展示型推广活动的步骤。

前提条件

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

说明

获取访问令牌

执行以下步骤以获取新的访问令牌（access token）。如果您已经获得访问令牌，但该令牌已过期，则可以使用 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
}
  1. 您还需要为 Amazon-Advertising-API-Scope 头（header）设置一个值。选择 GET profile information 请求，然后选择 send。该响应包含了 profileId 字段中的值。

创建展示型推广活动

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

  1. 在 Postman 集合中，打开 create one or more campaigns 请求。选择 body 选项卡并修改字段值以反映您的广告活动。例如：
[{
  "name": "My Contextual Targeting Campaign",
  "tactic": "T00020",
  "startDate": "20200810",
  "endDate": "20301201",
  "state": "enabled",
  "budget": 100.00,
  "budgetType": "daily",
  "costType": "cpc"
}]
  1. 点击 send 按钮并验证您的请求是否成功。例如：
[
  {
    "campaignId": 222756009537583,
    "code": "SUCCESS"
  }
]
  1. 打开后续请求。获取请求的广告活动并选择 send。上一个响应中的 campaignId 值将自动复制到后续请求中。
{
    "campaignId": 222756009537583,
    "name": "My Contextual Targeting Campaign 2",
    "tactic": "T00020",
    "startDate": "20200812",
    "endDate": "20301201",
    "state": "paused",
    "budget": 100.00,
    "budgetType": "daily",
    "costType": "cpc",
    "deliveryProfile": "as_soon_as_possible"
}
  1. 重复相同的步骤以创建并检索其余组成部分。
  1. 来自 GET Gets a targeting clause specified by identifie. 的最终响应类似于：
{
    "adGroupId": 12345678900000,
    "expression": [
        {
            "type": "asinSameAs",
            "value": "B07V5HK595"
        }
    ],
    "expressionType": "manual",
    "resolvedExpression": [
        {
            "type": "asinSameAs",
            "value": "B07V5HK595"
        }
    ],
    "state": "enabled",
    "targetId": 1234567890
}

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

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

报告

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

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

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

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

总结

在本教程中，您了解了如何使用 Audiences API 来创建并更新广告活动，这有助于定向受众，并提升产品的认知度和销量。

Amazon Advertising logo