开发人员指南概述

亚马逊广告 API 概览

适用于商品推广的商品投放概览

手动商品推广活动要求您添加至少一个投放子句。您可以使用关键词投放或商品投放（如本文档中所述）。投放是在广告组级别分配的。广告组中的所有商品都将共享投放子句。

商品投放可应用于商品、品类或品牌级别。例如，您可以按 ASIN 投放特定的跑鞋产品，或者使用品类编号将跑鞋作为一个品类进行投放。

您可以在广告活动层次结构中进一步了解广告活动结构。

操作前注意事项

在创建商品投放表达式之前，您需要

请求

接口

POST sp/targets

投放单件商品

当您投放单件商品时，可以精准地选择具体的 ASIN 进行投放，也可以选择特定的 ASIN 和其他相似 ASIN 进行投放，包括同类商品、关联商品和其他相关商品。您可以在广告平台帮助中心进一步了解如何扩展 ASIN 投放。

参数

| 名称 | 可选 | 类型 | 说明 | |--- |--- |--- |--- | | campaignId | 不可选 | number | 要与投放表达式关联的广告活动。 | | adGroupId | 不可选 | String | 要与广告活动关联的广告组。 | | expression.type | 不可选 | string | 对于商品投放，请始终设置为 ASIN_SAME_AS（ASIN 精准投放）ASIN_EXPANDED_FROM（ASIN 精准投放及其他相似 ASIN 的投放）。 | | expression.value | 不可选 | string | 您希望投放的商品的 ASIN。如果您不确定应投放哪些 ASIN，请使用商品建议接口。 | | expressionType | 不可选 | string | 请始终设置为 MANUAL。 | | state | 不可选 | string | 投放表达式的状态，分别为 ENABLED 或 PAUSED。 | | bid | 可选 | float | 竞价表达式。如果未指定，将使用广告组竞价。如果您不确定要竞价的对象，可以考虑使用竞价建议接口。 |

示例

单个 ASIN

此示例为 ASIN B07FKDZPZW 创建了商品投放表达式。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--header 'Prefer: return=representation' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B07FKDZPZW"
        }
      ],
      "campaignId": "123456789",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "987654321"
    }
  ]
}'

多个 ASIN

每个投放子句只能添加一个 ASIN。如果您想投放多个 ASIN，则应创建两个投放子句。

{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B07YT8NVF9"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    },
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B09LJWZT6G"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 2.50,
      "adGroupId": "169462822148652"
    }
  ]
}

ASIN 及相关商品

此示例为 ASIN B07YT8NVF9 以及其他相关 ASIN 创建了投放表达式。

{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_EXPANDED_FROM",
          "value": "B07YT8NVF9"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
}

投放商品品类

相比为单个 ASIN 创建表达式，为商品品类创建投放表达式可提供更多细化支持。

参数

| 名称 | 可选 | 类型 | 说明 | |--- |--- |--- |--- | | campaignId | 不可选 | number | 要与投放表达式关联的广告活动。 | | adGroupId | 不可选 | String | 要与广告活动关联的广告组。 | | expression.type | 不可选 | string | 请参阅下方支持的表达式类型表。至少应添加 ASIN_CATEGORY_SAME_AS。如需了解更多信息，请参阅下方的支持的表达式类型表。 | | expression.value | 不可选 | string | 该值因表达式类型而异。如需进一步了解，请参阅下表。 | | expressionType | 不可选 | string | 请始终设置为 MANUAL。 | | state | 不可选 | string | 投放表达式的状态，分别为 ENABLED 或 PAUSED。 | | bid | 可选 | float | 竞价表达式。如果未指定，该表达式将使用广告组竞价。如果您不确定要竞价的对象，可以考虑使用竞价建议接口。 |

支持的表达式类型

所有品类投放表达式都必须包含 ASIN_CATEGORY_SAME_AS。根据品类的不同，可提供不同的细化选项。要了解可用的细化选项，请参阅商品品类投放建议及细化。

| Predicate | 说明 | 示例值 | |--- |--- |--- | | ASIN_CATEGORY_SAME_AS | 对与所表达的品类相同的品类进行否定投放。该值为品类 ID。 | 11056341 | | ASIN_BRAND_SAME_AS | 投放与所表达的品牌相同的品牌。该值为品牌 ID。 | 7048034011 | | ASIN_PRICE_LESS_THAN | 投放低于所表达的价格的价格。该值为以账户货币表示的价格。 | 20.5 | | ASIN_PRICE_BETWEEN | 投放介于所表达的价格之间的价格。该值为账户货币的两个价格，用连字符分隔。 | 10.5-12.5 | | ASIN_PRICE_GREATER_THAN | 投放高于所表达的价格的价格。该值为以账户货币表示的价格。 | 10.75 | | ASIN_REVIEW_RATING_LESS_THAN | 投放低于所表达的评级的评级。该值为一个小于 5 的数字。 | 4 | | ASIN_REVIEW_RATING_BETWEEN | 投放介于所表达的评级之间的评级。 | 4-5 | | ASIN_REVIEW_RATING_GREATER_THAN | 投放高于所表达的评级的评级。该值为一个大于 1 的数字。 | 3 | | ASIN_IS_PRIME_SHIPPING_ELIGIBLE | 投放符合 Prime 配送条件的商品。这种细化只能应用于品类或品牌级别。该值为一个布尔值。 | TRUE | | ASIN_AGE_RANGE_SAME_AS | 投放处于所表达的年龄范围内的年龄范围。此细化仅适用于玩具品类和游戏品类。该值为一个年龄范围 ID。 | 165890011 | | ASIN_GENRE_SAME_AS | 该值为一个流派 ID。 | 1235687 |

示例

**未进行细化的品类 **

此示例展示了如何对未进行任何细化的整个品类进行投放。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
            "type":"ASIN_CATEGORY_SAME_AS",
            "value":"2522102011"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
  ]
}'

经过细化的品类

此示例展示了如何创建一个包含多个细化条件（品牌和评级之间）的投放表达式。使用细化时，必须先对品类进行定义。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
            "type":"ASIN_CATEGORY_SAME_AS",
            "value":"2522102011"
        },
        {
          "type": "ASIN_BRAND_SAME_AS",
          "value": "7048034011"
        },
        {
          "type": "ASIN_REVIEW_RATING_BETWEEN",
          "value": "3-4.5"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
  ]
}'

响应

成功的请求会返回一个 207 响应，其中包含了每个投放子句的状态消息。您应检查成功数组是否包含了您计划创建的所有对象。任何失败信息都会在错误数组中指示。

对于包含编号（品类 ID、品牌 ID、年龄范围 ID 或流派 ID）的品类投放表达式，解析后的表达式对象将包含与该 ID 相关的可读说明。

提示

如果您希望在请求中返回整个投放对象，请确保在标头中包含 Prefer: return=representation。

示例

{
  "targetingClauses": {
    "error": [],
    "success": [
      {
        "index": 0,
        "targetId": "269280454302686",
        "targetingClause": {
          "adGroupId": "169462822148652",
          "bid": 1.5,
          "campaignId": "26256301417055",
          "expression": [
            {
              "type": "ASIN_SAME_AS",
              "value": "B07FKDZPZW"
            }
          ],
          "expressionType": "MANUAL",
          "resolvedExpression": [
            {
              "type": "ASIN_SAME_AS",
              "value": "B07FKDZPZW"
            }
          ],
          "state": "ENABLED",
          "targetId": "269280454302686"
        }
      }
    ]
  }
}
Amazon Advertising logo