开发人员指南概述

亚马逊广告 API 概览

基于效果的规则

您可以借助基于效果的规则来创建预算规则，在满足特定条件时增加您的预算。例如，您可以创建一个规则，在搜索结果首页首位展示量份额 (IS) 大于 50% 时增加预算。

不同广告类型的可用指标

每种广告类型支持不同的指标，您可以使用这些指标来配置基于效果的规则。

| 指标 | 描述 | 支持的广告类型 | |---------|---------| | ACOS | 在指定时间段内，某种类型的广告活动因为广告点击而产生的支出在由广告产生的销售额中所占的百分比。通过总支出除以由广告带来的销售额计算得出。 | 商品推广、展示型推广 | | CTR | 广告活动的点击率。通过将点击量除以该时间段内的展示量计算得出。 | 商品推广、展示型推广 | | CVR | 转化率。通过将在该时间段内由广告产生的点击转化量除以该时间段内产生的点击量计算得出。 | 商品推广、展示型推广 | | IS | 广告活动的搜索结果首页首位展示量份额。计算得出的值为广告活动获得的搜索结果顶部展示量占其符合条件的搜索结果顶部展示量总数的百分比。注意： IS 对于包含视频创意素材的任何广告活动，IS 不可用作指标。 | 品牌推广 | | NTB | 以本地货币计算的来自品牌新客的销售额百分比。 | 品牌推广 | | ROAS | 广告投资回报率。亚马逊的 ROAS 通过将广告收入除以广告支出来计算，您可以从中了解每投资一美元的广告支出能赚取多少回报。 | 品牌推广、商品推广、展示型推广 |

注意

对于卖家，指标计算的时间段是点击广告后的 7 天内。对于供应商，指标计算的时间段是点击广告后的 14 天内。

请求

您可以使用 POST /budgetRules 接口创建基于绩效的预算规则。请注意，每种广告类型都有单独的接口。

广告类型 创建预算规则接口
商品推广 POST /sp/budgetRules
品牌推广 POST /sb/budgetRules
展示型推广 POST /sd/budgetRules

参数

  1. 规则类型：效果

  2. 开始日期： 规则的开始日期。

  3. 结束日期： 此参数是可选的，表示规则的结束日期。

  4. 循环周期：

    • daily：根据开始和结束日期，每天对规则进行评估。
    • weekly：仅在一周中的特定日期（例如周五和周六）在开始日期和结束日期之间评估规则。

  5. 效果衡量：对于基于效果的规则，您必须指定以下属性：

    • 指标名称： 请参阅不同广告类型的可用指标 以了解每种广告类型可用的指标。
    • 阈值： 所选指标的数值。例如，如果指标名称为 NTB，阈值设置为 50，则表示品牌新客销售额的百分比为 50%。
    • 比较运算符：LESS_THAN、GREATER_THAN、EQUAL_TO、LESS_THAN_OR_EQUAL_TO、GREATER_THAN_OR_EQUAL_TO 的其中之一。

  6. 增加预算幅度：一个百分比值，按照这个百分比增加每日预算。

场景

品牌推广： 如果 ROAS 小于 20%，则将预算增加 10%。

要实现此目标，通过指定 ROAS 作为指标名称创建一个规则，并将 10% 设置为绩效指标的阈值。然后，将规则关联到一个广告活动。

  1. 使用 POST /sb/budgetRules 创建一个规则，通过指定 ROAS 作为指标名称，并将 10% 设置为绩效指标的阈值。

请求体示例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ROAS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ROAS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

预期的 HTTP 状态码： 207

响应体示例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. 使用 POST /sb/campaigns/{campaignId}/budgetRules 将预算规则与广告活动相关联。

商品推广： 如果 ACOS 小于 20%，则将预算增加 10%。

要实现此目标，通过指定 ACOS 作为指标名称创建一个规则，并将 10% 设置为效果指标的阈值。然后，将规则关联到一个广告活动。

  1. 使用 POST /sp/budgetRules 创建一个规则，通过指定 ACOS 作为指标名称，并将 10% 设置为效果指标的阈值。

请求体示例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ACOS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ACOS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

预期的 HTTP 状态码： 207

响应体示例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. 使用 POST /sp/campaigns/{campaignId}/budgetRules 将预算规则与广告活动相关联。

展示型推广： 如果 ACOS 小于 20%，则将预算增加 10%。

要实现此目标，通过指定 ACOS 作为指标名称创建一个规则，并将 10% 设置为效果指标的阈值。然后，将规则关联到一个广告活动。

  1. 使用 POST /sd/budgetRules 创建一个规则，通过指定 ACOS 作为指标名称，并将 10% 设置为绩效指标的阈值。

请求体示例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ACOS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ACOS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

预期的 HTTP 状态码： 207

响应体示例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. 使用 POST /sd/campaigns/{campaignId}/budgetRules 将预算规则与广告活动相关联。

最低预算

基于效果的规则依赖于广告活动的点击量和转化量，以生成指标。最低所需预算旨在增加广告活动获得足够流量和指标评估的可能性。

Amazon Advertising logo