Amazon Ads APIの概要

Amazon Ads APIを利用することで、Amazonの広告主様とAmazon Advertisingパートナーネットワークのメンバーは、広告の運用をプログラマティックに管理できます。

左側のメニューツリーで、APIのリファレンスドキュメントや機能の説明、リリースノート、推奨事項、チュートリアルをご覧いただけます。

Amazon Ads APIを初めて使用する場合

左側の目次または以下のリストから、最初に行う手順に関するガイドをご覧ください。

• オンボーディング：アクセス権を取得するための手順の詳細。
• 最初の手順：認証を管理し、最初のリクエストを行うための手順の詳細。

RESTの設計

APIによって、キャンペーンエンティティに対して読み取りおよび書き込み操作を行うためのRESTfulサービスインターフェイスが公開されます。また、詳細なパフォーマンスデータをリクエストするための柔軟なレポートも利用できます。認証されたHTTP POST、GET、PUT、DELETEの各メソッドを使用して、エンティティおよびレポートの作成、読み取り、更新、削除がそれぞれ行われます。エンティティの作成または更新操作はすべて、JSONを使用したリクエストボディへの入力として行われます。

APIは大規模なバッチ操作向けに最適化されているため、結果が返されるまでに数秒かかる場合があります。また、キャンペーンの構造データへのアクセスは、パフォーマンス指標へのアクセスとは分離されています。パフォーマンス指標は非同期レポートからのみ取得できます。

アプリケーションのUIと最適化アルゴリズムが円滑に機能するように、APIを通じて取得したデータのローカルコピーを保持することをおすすめします。

一般的なユースケース

一般的なクライアントは、以下の操作を定期的に実行するものと想定しています。

1. ページ分割されたリクエストですべてのキャンペーン、広告グループ、広告、キーワードに対するバッチリクエストを行い、データのローカルコピーを保存/更新します。
2. すべてのキャンペーン、広告グループ、広告、キーワードの最新のパフォーマンスデータをレポートでリクエストし、IDを使用して、パフォーマンスデータをバッチリクエストから取得したエンティティに関連付けて、保存/更新します。
3. パフォーマンスを分析し、入札額と予算を変更します。キャンペーン、広告グループ、広告、キーワードに対するバッチ更新APIを使用して、パフォーマンスを最適化します。

上記の操作と単一のエンティティを変更する操作が、APIでサポートされるユースケースです。

APIエンドポイント

APIには、次のURLエンドポイントからアクセスできます。

URL	地域	マーケットプレイス
https://advertising-api.amazon.com	北米（NA）	米国（US）、カナダ（CA）、メキシコ（MX）、ブラジル（BR）
https://advertising-api-eu.amazon.com	ヨーロッパ（EU）	イギリス（UK）、フランス（FR）、イタリア（IT）、スペイン（ES）、ドイツ（DE）、オランダ（NL）、アラブ首長国連邦（AE）、ポーランド（PL）、トルコ（TR）、エジプト（EG）、サウジアラビア（SA）、スウェーデン（SE）、ベルギー（BE）、インド（IN）
https://advertising-api-fe.amazon.com	極東（FE）	日本（JP）、オーストラリア（AU）、シンガポール（SG）