开发人员指南概述

亚马逊广告 API 概览

预算建议以及错过的机会

预算建议资源为您提供了针对广告活动的建议每日预算和预计错过的机会指标。

此资源可返回以下指标：

  1. 建议的每日预算 - 提供所需的预估预算，在整个 24 小时内保持广告活动处于预算范围之内。考虑采用该预算，以最大限度地降低您的广告活动超出预算的几率。
  2. 预算内时间占比 - 提供广告活动在过去 7 天未超预算的时间所占的比例。
  3. 预估错过的展示量、点击量和销量（所有广告活动） - 这些是广告活动采用建议预算后可能产生的预估额外展示量、点击量和销量。预估值基于之前的网站流量和历史广告活动效果，不能保证实际的展示量、点击量和销量。

前提条件

建议等待广告活动保持投放 9 天后再使用此接口。

接口

POST sp/campaigns/budgetRecommendations

请求

请求体需要包含一份广告活动编号列表。

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaigns/budgetRecommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Authorization: Bearer xxxxxxxx' \
--header 'Accept: application/vnd.budgetrecommendation.v3+json' \
--header 'Content-Type: application/vnd.budgetrecommendation.v3+json' \
--data-raw '{
  "campaignIds": [
    "153839444046652"
  ]
}'

响应

**场景 1:**包含建议预算的成功响应，以及预估错过的展示量、点击量和销量。在 budgetRuleRecommendation 对象中，您可以查看特定预算规则的建议预算增长百分比。只有在创建了至少一条预算规则，才会填充此对象。

{
  "budgetRecommendationsSuccessResults": [
    {
      "index": 0,
      "campaignId": "259207489965973",
      "suggestedBudget": 13,
      "sevenDaysMissedOpportunities": {
        "startDate": "20221001",
        "endDate": "20221007",
        "percentTimeInBudget": 0.5,
        "estimatedMissedImpressionsLower": 3,
        "estimatedMissedImpressionsUpper": 5,
        "estimatedMissedClicksLower": 8,
        "estimatedMissedClicksUpper": 12,
        "estimatedMissedSalesLower": 2,
        "estimatedMissedSalesUpper": 4
      },
      "budgetRuleRecommendation": {
        "suggestedBudgetIncreasePercent": 5,
        "ruleName": "sample rule",
        "ruleId": "123"
      }
    }
  ],
  "budgetRecommendationsErrorResults": []
}

**场景 2：**包含建议预算的成功响应，但不包含预估错过的展示量、点击量或销量。由于 percentTimeInBudget 参数值不小于 1，这意味着广告活动在预算范围内，即不会错过任何机会。

{
    "budgetRecommendationsSuccessResults": [
        {
            "index": 0,
            "campaignId": "259207489965973",
            "suggestedBudget": 13,
            "sevenDaysMissedOpportunities": {
                "startDate": "20210609",
                "endDate": "20210615",
                "percentTimeInBudget": 1,
                "estimatedMissedImpressionsLower": 0,
                "estimatedMissedImpressionsUpper": 0,
                "estimatedMissedClicksLower": 0,
                "estimatedMissedClicksUpper": 0,
                "estimatedMissedSalesLower": 0,
                "estimatedMissedSalesUpper": 0
            },
            "budgetRuleRecommendation": null
        }
    ],
    "budgetRecommendationsErrorResults": []
}

**场景 3：**成功响应，但建议预算、错过的机会和预算规则建议部分为空。这意味着没有足够的历史数据可供亚马逊提出建议。

{
    "budgetRecommendationsSuccessResults": [
        {
            "index": 0,
            "campaignId": "254916660662680",
            "suggestedBudget": null,
            "sevenDaysMissedOpportunities": null,
            "budgetRuleRecommendation": null
        }
    ],
    "budgetRecommendationsErrorResults": []
}

后续步骤

Amazon Advertising logo