開発者ガイドの概要

Amazon Ads APIの概要

概要

予算使用状況APIは、キャンペーンとポートフォリオの予算使用率を取得して、予算の使用状況に関するほぼリアルタイムの情報を提供します。すべてのアクティブな、一時停止した、あるいは期限切れになったキャンペーンやポートフォリオについて、ほぼリアルタイムで取得される予算使用率をリクエストできます。

予算使用状況の計算

予算使用率は、計算日時点のキャンペーン広告費を、指定された1日の予算で割ったものです。これには、予算ルールに起因する予算の変更分と、1日の平均予算の計算からの増分が含まれます。

たとえば、1日の予算が100米ドルで、予算ルールがなく、1日の平均予算が増加していないキャンペーンを考えてみます。この場合、現在の1日のキャンペーン支出が80米ドルであれば、予算の増分はないので、予算使用率は80%になります。

別の例として、1日の予算が100米ドルで、特定の日付に予算が50%増大する予算ルールのあるキャンペーンを考えてみます。この日の予算は、予算ルールによって150米ドルになります。キャンペーンで80米ドル支出している場合、予算使用率は80米ドル/150米ドル= 53.3%になります。