开发人员指南概述

亚马逊广告 API 概览

商品推广商品投放建议

如果您不知道要投放哪些商品,亚马逊可以根据您正在推广的 ASIN 推荐适合的商品。

请求

提示:

如果您在请求中添加多个 ASIN,请确保它们是相似的商品。响应包括请求中包含的所有 ASIN 的优选广告商品。

您可以按主题或 ASIN 来请求建议。按主题请求的建议将返回主题列表(例如,相似商品或关联商品)。每个主题都包含属于该品类的 ASIN 列表。按 ASIN 请求的建议将返回 ASIN 列表。每个 ASIN 都包含与之匹配的主题的说明。有关更多信息,请参阅以下示例。响应类型由 Accept 标头的值决定。

接口

GET /sp/targets/products/recommendations endpoint

按 ASIN

请求

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/products/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Accept: application/vnd.spproductrecommendationresponse.asins.v3+json' \
--header 'Content-Type: application/vnd.spproductrecommendationresponse.asins.v3+json' \
--data-raw '{
  "adAsins": [
    "B09LJWZT6G"
  ],
  "count": "5",
  "locale": "en_US"
}'

响应

{
  "recommendations": [
    {
      "recommendedAsin": "B08YJY5KW5",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B09TGKBFCM",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B01LL9ITX8",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B07C8RCNXD",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    },
    {
      "recommendedAsin": "B06XWRGMVT",
      "themes": [
        "Similar items (frequently viewed together)"
      ]
    }
  ],
  "nextCursor": "h9oGnf2jn2qd3ymV4nWLsA=="
}

注意

请求中的计数 (count) 值决定了响应中返回的 ASIN 数量。您可以在新请求中使用 nextCursorpreviousCursor 值来返回下一组 ASIN。

按主题

请求

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/products/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: 904444984714944' \
--header 'Accept: application/vnd.spproductrecommendationresponse.themes.v3+json' \
--header 'Content-Type: application/vnd.spproductrecommendationresponse.themes.v3+json' \
--data-raw '{
  "adAsins": [
    "B09LJWZT6G"
  ],
  "locale": "en_US",
  "count": 5
}'

响应

{
  "recommendations": [
    {
      "theme": "Similar items (frequently viewed together)",
      "description": "Items that shoppers frequently view and click along with your advertised item during a shopping session.",
      "recommendedAsins": [
        "B08YJY5KW5",
        "B09TGKBFCM",
        "B01LL9ITX8",
        "B07C8RCNXD",
        "B06XWRGMVT",
        "B09TK2394N"
      ]
    },
    {
      "theme": "Complements",
      "description": "Items frequently bought together as complements (e.g. tennis balls with tennis raquets)",
      "recommendedAsins": [
        "B091K1C3KD",
        "B09VPFJYVR",
        "B09TLM53P7",
        "B099QV15NM",
        "B0B4BFTB3D",
        "B09B4QD42W"
      ]
    }
  ],
  "nextCursor": null,
  "previousCursor": null
}

注意

请求中的计数 (count) 值决定了响应中返回的 ASIN 数量。您可以在新请求中使用 nextCursorpreviousCursor 值来返回下一组主题。

然后,您可以使用建议来创建投放表达式