商品推广商品品类投放建议和细分

品类投放允许您对整个商品品类投放广告。有多种细分可用于筛选品类。

获取所有品类

如果您之前没有进行过品类投放，则首先需要了解哪些品类可用。

接口

GET sp/targets/categories

示例

curl --location --request GET 'https://advertising-api.amazon.com/sp/targets/categories' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \

该响应返回一个树状结构，包含目前在 Amazon.com 上可用的所有品类。

获取建议的品类

您也可以根据 ASIN 列表请求建议的品类。此接口采用一个 ASIN 列表，并返回您可以投放广告的相关品类。请注意，所有输入的 ASIN 都应相似，因为建议适用于请求中的所有 ASIN。

接口

POST /sp/targets/categories/recommendations

示例

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/categories/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \
--data-raw '{
  "includeAncestor": false,
  "asins": [
    "B08LM7291W"
  ]
}'

响应包括任何关联品类，以及该品类中商品的最小和最大数量。

{
  "categories": [
    {
      "id": "11056341",
      "name": "Bath Soaps",
      "parentCategoryId": "11056281",
      "categoryPath": "/Beauty & Personal Care/Skin Care Products/Body Skin Care Products/Body Cleansers/Bath Soaps",
      "asinCounts": {
        "min": 8988,
        "max": 14980
      }
    }
  ]
}

品类细分

品类可以进行细分，您可以用来进一步确定某个品类中的 ASIN。可能的细分包括品牌、年龄范围和流派。

接口

GET sp/targets/category/{categoryId}/refinements

示例

curl --location --request GET 'https://advertising-api.amazon.com/sp/targets/category/2522102011/refinements' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxx' \
--header 'Accept: application/vnd.spproducttargeting.v3+json' \
--header 'Content-Type: application/vnd.spproducttargeting.v3+json' \

响应包括与该品类相关的任何品牌、年龄范围和流派。并非所有品类都有相关的品牌、年龄范围和流派。您可以使用响应中的 ID 作为投放表达式的一部分。

{
  "brands": [
    {
      "name": "Back to Basics",
      "id": "7048034011"
    },
    {
      "name": "DJECO",
      "id": "18681839011"
    },
    {
      "name": "Disney",
      "id": "18726768011"
    },
    {
      "name": "Pipity",
      "id": "20774946011"
    },
    {
      "name": "ALEX Toys",
      "id": "2581933011"
    },
    {
      "name": "Fashion Angels",
      "id": "7481406011"
    }
  ],
  "ageRanges": [
    {
      "name": "Birth to 24 Months",
      "id": "165813011"
    },
    {
      "name": "2 to 4 Years",
      "id": "165890011"
    },
    {
      "name": "8 to 13 Years",
      "id": "5442387011"
    },
    {
      "name": "5 to 7 Years",
      "id": "165936011"
    }
  ],
  "genres": null
}

提示

使用POST /sp/targets/products/count接口，计算一个品类和您需要的细分中有多少商品可供投放。

现在您已经有了品类建议和细分，您可以创建品类投放表达式