レポートに関するよくある質問

Amazon Adsバージョン3レポートに関するよくある質問への回答を紹介します。

この最新のAPI更新の主なニーズは何ですか？

現在、キャンペーンレポートはAmazon Adsプロダクトごとに分かれています。その結果、開発者はデータへのアクセスや調整に多くの時間とリソースを費やし、キャンペーンマネージャーは最適化に必要な指標を待つことに不満を感じています。レポート用のAPIの機能強化は、すべてのキャンペーンレポートデータを1か所に統合し、未加工データを実用的なインサイトに変えるプロセスを合理化することで、これらの課題を軽減することを目的としています。これで、開発者とキャンペーンマネージャーは、データの整理に費やす時間を減らし、ビジネス上の課題の解決により多くの時間を費やすことができます。

APIの新しいレポート更新は、バージョン2と比較してどのような利点がありますか？

これらのレポート更新の主な利点は次のとおりです。

1. すべてのレポートには単一のインターフェイスからアクセスでき、指標名が標準化され、同じディメンション名が含まれます。
2. 日付の範囲は、一度に1日ずつではなく、最大31日です。
3. 最長95日という長い履歴レポート期間（バージョン2レポートでは60日）。
4. すべての広告プログラムに共通のレポートスキーマ。現在は、スポンサープロダクト広告と1つのスポンサーブランド広告レポートから始めています。
5. JSON（GZIPファイル）をサポートします。CSVファイルは近日サポートされる予定です。

更新されたAPIはどの地域で利用できますか？

レポート更新は、スポンサー広告を掲載できるすべての国（NA、EU、FE）で利用できます。

新しいAPI更新の使用を開始するにはどうすればよいですか？

API、APIリファレンス、および利用開始チュートリアルへのアクセス方法の詳細については、バージョン3レポートの使用を開始するをご覧ください。

現在どのレポートを利用できますか？

レポートの完全なリストとバージョン2レポートとの対応については、移行ガイドをご覧ください。

統合でバージョン2のAPI仕様を使用しています。新しい仕様に切り替える必要はありますか？

今後は、既存のバージョンに変更は行われないため、今のところバージョン2を引き続き使用できます。

バージョン2のスポンサープロダクト広告エンドポイント（バージョン2）は2023年3月30日に廃止予定ですので、できるだけ早くアップグレードすることをおすすめします。新しいバージョンでは、お客様のデータニーズをより的確に満たすために、アップグレードされた履歴データと期間機能が追加されています。

これは、バージョン2のレポートエンドポイントが廃止されるということですか？

はい。スポンサープロダクト広告の現在のバージョン2のレポートエンドポイントは、2023年3月30日に廃止される予定です。これにより、時間に余裕をもって新しいスキーマに移行できるはずです。このタイムラインについてご不明な点がございましたら、JIRAチケットを開くか、Amazonパートナーアカウントマネージャーにお問い合わせください。

注

バージョン2のスポンサーブランド広告レポートとスポンサーディスプレイ広告レポートは、2023年3月30日以降も引き続き機能します。

共通のリクエストとレスポンススキーマの利点は何ですか？

現在は、さまざまな広告プロダクトのレポートを取得する場合、これらのレポートはリクエストスキーマと指標名が異なるため、直接使用するのは困難です。バージョン3のレポートエンドポイントは、すべてのレポートに標準のリクエストスキーマと指標名を提供するため、データの統合が合理化され、より迅速にインサイトを得ることができます。

新しいAPIへの接続や新しいAPIからのレポートの使用に問題がある場合はどうすればいいですか？

問題があれば、JIRAチケットを作成するか、詳細情報やヘルプが必要な場合はパートナーアカウントマネージャーに連絡して報告できます。

スポンサー広告のレポートデータが利用できるようになるまでどのくらいかかりますか？

最初のインプレッションデータとクリックデータは、APIを使用して12時間以内に利用できるようになります。トラフィック検証プロセスのため、最初のクリック日から最大3日後、インプレッションデータとクリックデータに小さな変更が加えられる場合がありますのでご注意ください。3日後にクリックデータとインプレッションデータを再度取得して、最新のデータを入手することをおすすめします。

最初のコンバージョンデータは24時間以内に利用できるようになりますが、修正プロセスの一環として変更される場合があります。コンバージョンデータの修正は、コンバージョンイベントの1日後、7日後、28日後に行われます。コンバージョンは広告インタラクションが行われた日にレポートされるため、修正にはアトリビューション期間のすべての日が含まれます。たとえば、アトリビューション期間が14日の場合、修正を行うと、レポート日から最大42日（14+28）後にアトリビューションを更新できます。

検索ワードレポートに、広告コンソールレポートに含まれる商品のサブセットしかないのはなぜですか？

広告コンソールの検索ワードレポートには、その語句がクリックにつながったかどうかに関係なく、インプレッションがあったすべての検索用語が含まれます。API検索ワードレポートには、1回以上クリックされたインプレッションのみが含まれます。そのため、コンソールレポートとAPIレポートではエントリー数に違いがあります。