予算の推奨事項と機会損失

予算の推奨事項リソースは、キャンペーンの1日の推奨予算と、推定される機会損失の指標を提供します。

このリソースは以下の指標を返します。

1日の推奨予算 - 24時間にわたってキャンペーンを予算内に収めるために必要な推定予算。キャンペーン予算が不足する可能性を回避に向け、この予算を検討することをおすすめします。
予算内に収まっていた時間の割合 - 過去7日間にキャンペーンが予算内に収まっていた時間の割合。
全キャンペーンにおける逃した機会損失の推定値、損失したクリックの推定値****および損失売上の推定値 - これらは、推奨予算を採用した場合にキャンペーンで得られる可能性がある付加的なインプレッション数、クリック数、および売上の推定値です。これらは過去のWebサイトのトラフィックと過去のキャンペーンパフォーマンスに基づく推定値であり、実際のインプレッション数、クリック数、売上を保証するものではありません。

始める前に

このエンドポイントを使用するには、キャンペーンがアクティブになるまで9日間待つことをおすすめします。

エンドポイント

POST sp/campaigns/budgetRecommendations

リクエスト

リクエストボディにはキャンペーンIDのリストが必要です。

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オブジェクトには、特定の予算ルールに対する推奨予算増額率が表示されます。このオブジェクトは、少なくとも1つの予算ルールが作成されている場合にのみ移入されます。

{
  "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：**成功時のレスポンスで、推奨予算、損失機会、予算ルールの推奨事項がnullです。これは、推奨事項の作成に十分な履歴データがないことを意味します。

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

次の手順

PUT sp/campaignsリソースを使用して、dailyBudgetパラメーターの新しい推奨入札額を更新します。