Amazon Marketing Stream 策略性建议用户指南

策略性建议 API 提供了亚马逊的建议，有助于提升您的搜索广告活动的效果。

注意

此功能目前处于测试阶段。

Amazon Marketing Stream 以推送方式将近乎实时的指标和建议直接传送到您的 AWS 账户。如果您通过 Stream 订阅了sponsored-ads-campaign-diagnostics-recommendations 数据集，您将自动收到推送通知，其中包含有关广告活动的建议。每条建议消息都包含一个建议编号，可与策略性建议 API 一起使用来应用该建议。

例如，假设您收到了来自 Stream 的以下建议消息，建议提高商品推广活动的预算：

{
  "recommendation_id": "2d384ce5-8f4d-403a-afac-7437b99313f6",
  "group_id": "67653abe-44fc-11ed-b878-0242ac120002",
  "apply_endpoint": "/recommendations/apply",
  "type": "CAMPAIGN_BUDGET",
  "published_date": "2022-10-04T21:39:49",
  "expiry_date": "2022-10-18T21:39:49",
  "explanation": {
    "description": "High-performing campaign with ROAS greater than 3 and last week's budget utilization greater than 80%.We've estimated this is a missed opportunity in sales, clicks.Apply the recommended budget.",
    "missed_opportunities": {
      "impressions": "200-1000",
      "clicks": "100-3000",
      "conversions": "10-100",
      "time_period": "Last 7 days"
    },
    "campaign_id": "182756610092559",
    "campaign_name": "All Fabrics",
    "ad_product": "SP",
    "current_campaign_settings": {
      "budget": {
        "campaign_budget": 221
      }
    },
    "recommended_campaign_settings": {
      "budget": {
        "campaign_budget": 321
      }
    }
  }
}

在这个示例中，ecommendation_id 是 2d384ce5-8f4d-403a-afac-7437b99313f6。

应用建议

要按照 Stream 负载中提出的建议完全应用建议，可以在请求体中使用通过 Stream 获取的 recommendation_id，在 POST /recommendations/apply 中进行请求。您一次最多可以应用 100 个建议编号。

请求示例：

curl --location 'https://advertising-api.amazon.com/recommendations/apply' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--data '{
  "maxResults": 0,
  "nextToken": "string",
  "filters": [
    {
      "include": true,
      "field": "RECOMMENDATION_ID",
      "values": [
        "2d384ce5-8f4d-403a-afac-7437b99313f6"
      ],
      "operator": "EXACT"
    }
  ]
}'

更新建议

如果您想在应用之前对建议进行更改，可以使用 PUT /recommendations/{recommendationId} 接口来更新建议。

请求示例：

假设建议是将预算更新为 321，但您更希望更新为 300。此示例将 recommendedValue 更新为 300。

curl --location --request PUT 'https://advertising-api.amazon.com/recommendations/2d384ce5-8f4d-403a-afac-7437b99313f6' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxx' \
--data '{
  "recommendedValue": "300"
}'

对建议进行编辑后，使用 POST /recomendations/apply 将建议应用于您的广告活动。