開発者ガイドの概要

Amazon Ads APIの概要

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

レポートに関するよくある質問への回答を紹介します。

一般的なご質問

スナップショットとレポートの違いは何ですか。

スナップショットには、スナップショットリクエストが実行された時点のアカウントのキャンペーン構造に関するメタデータが含まれています。レポートには、キャンペーンのパフォーマンスデータが含まれます。メタデータも含まれる場合があります。より高い成果を得るには、すべてのメタデータをスナップショットでリクエストし、識別子または名前を使用してメタデータとパフォーマンスデータを紐づけることをおすすめします。

タイミングとレポート期間

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

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

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

特定の期間のスポンサー広告レポートを取得する方法を教えてください。

APIレポートには、1日分のみのパフォーマンスデータが含まれます。特定の期間のデータが必要な場合は、目的の期間の日次レポートを日ごとにリクエストしてから、データを集計してください。

広告コンソールを使用して、特定の期間のレポートを取得することもできます。バージョン3のレポーティングAPIも、特定の期間のレポートをサポートしています。

バージョン2のレポーティングAPIで利用可能なレポート履歴とは何ですか？

このAPIでは、60日間のスポンサー広告レポートをリクエストできます。たとえば、今日が2022年1月1日であるとしたら、データのリクエストが可能な最も古い日付は2021年11月2日となります。

60日以上前のスポンサー広告データが必要な場合はどうなりますか？

広告コンソールレポートには、60日以上のレポート期間があります。コンソールレポートデータとAPIレポートデータを紐づけるには、キャンペーン名または広告グループ名をインデックスとして使用してください。

バージョン3のレポーティングAPIもお試しください。レポートタイプによっては、新しいバージョンでより長いレポート期間を利用できます。

レポートにはどのタイムゾーンが使用されますか？

レポートのタイムゾーンは、レポートのリクエストに使用された広告アカウントに関連付けられているタイムゾーンです。リクエストヘッダーに指定したプロフィールIDによって決まります。特定のプロフィールIDのタイムゾーンを確認するには、GET /v2/profiles/{profileId}エンドポイントをご覧ください。

トラブルシューティング

レポートにレート制限があるのはなぜですか？

負荷の高い時間帯には、レポートが制限されることがあります。過度なレート制限を避けるため、すべてのレポートのリクエストを一括で実行するのではなく、1日を通して分散させてください。

その他のベストプラクティスについては、速度制限を参照してください。

レポートの生成に時間がかかるのはなぜですか？

多くの指標をリクエストするレポートは、データファイルが大きくなり、生成に時間がかかる場合があります。レポートのデータが重くなるのを避けるためには、レポートリクエストでは必要な指標のみを指定してください。レポートリクエスト本文にメタデータ（たとえば、campaignName、campaignId、adGroupName、adGroupIdなど）を指定しないレポートリクエストを検討してください。代わりに、スナップショットを使用してメタデータフィールドを取得してから、取得したメタデータをレポートにマージしてください。

レポートが空なのはなぜですか？

リクエストした日にキャンペーンに関連したクリックや閲覧が発生していない場合は、データが含まれていないレポートや、空のJSON配列（[]）が含まれたレポートが生成される場合があります。

スポンサーディスプレイ広告レポートでデータが返されないのはなぜですか？

キャンペーンで使用されたターゲティング戦略を確認してください。キャンペーンでコンテキストターゲティングとオーディエンスターゲティングの両方を使用している場合は、スポンサーディスプレイ広告レポートごとに2つのバージョンをリクエストする必要があります。1つは"tactic": "T00020"、もう1つは"tactic": "T00030"です。その後、データを集計して日次のパフォーマンス全体を把握できます。

入札額最適化の種類もレポートデータに影響を与える可能性があります。スポンサーディスプレイ広告キャンペーンには、クリック単価（CPC）と1,000件あたりのビューアブルインプレッション単価（vCPM）という2つの入札額最適化オプションがあります。

CPCキャンペーンがある場合に、スポンサーディスプレイ広告レポートで使用できる標準指標：impressions、attributedConversions14d、attributedDetailPageView14d、attributedSales14d、attributedUnitsOrdered14d。

vCPMキャンペーンがある場合に、使用しなければならないvCPM固有の指標：viewAttributedConversions14d, [viewAttributedDetailPageView14d]](../../../guides/reporting/v2/metrics.html)、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewImpressions。

CPCキャンペーンしかない場合、vCPM固有の指標では、クリック数に関連する値のみが返されます（つまり、vCPM固有の指標は標準指標と同じものになります）。両方のコストタイプの完全なパフォーマンスデータを取得するには、レポートリクエストにすべての指標を含めてから、データを集計してください。

スポンサーブランド広告レポートでデータが返されないのはなぜですか？

スポンサーブランド動画広告キャンペーンのみを実施している場合は、リクエスト本文でcreativeTypeにvideoを設定してください。creativeTypeを設定しない場合、レポートでは動画以外のキャンペーンデータだけが返されます。スポンサーブランドの動画広告キャンペーンと動画以外の広告キャンペーンの両方を実施している場合、動画用と動画以外用の2つのレポートリクエストを実行してください。

スポンサーブランド広告レポートをフィルタリングすることはできますか？

スポンサーブランド広告レポートでは、現在、スポンサーディスプレイ広告レポートとスポンサープロダクト広告レポートで利用可能なリクエスト本文パラメーターstateFilterを使用したフィルタリング機能には対応していません。デフォルトでは、リクエストした日のパフォーマンスデータが存在するキャンペーンエンティティがすべてレポートに表示されます。

ただし、レポートリクエストに特定の指標を指定した場合は、特定のエンティティにおけるパフォーマンスデータの有無や、エンティティがアクティブか否かに関係なく、過去のキャンペーンエンティティがすべてレポートに含まれます。その結果、パフォーマンスデータが存在しない行を多く含む非常に大きなレポートになることがあります。

レポートのデータが重くなるのを避けるため、以下の指標は、スポンサーブランド広告レポートのリクエストに指定しないでください。

このような情報をスナップショットで取得してから、適切なエンティティID（campaignId、keywordIdなど）を使用してスナップショットとレポートを紐づけることをおすすめします。

スポンサープロダクト広告レポートにスポンサーディスプレイ広告キャンペーンが表示されるのはなぜですか？

これはバージョン2の問題です。少数の広告主様に影響が生じる可能性があります。バージョン3のレポーティングAPIで、この問題は解決されています。

検索ワードレポートには、広告コンソールレポートに含まれるワードの一部しか表示されないのはなぜですか？

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

Postman

Postmanを使用してレポートをダウンロードしようとしています。データを取得できないのはなぜですか？

Postmanでリクエストを送信する場合は、送信ボタンの横にある矢印に移動し、送信してダウンロードをクリックしてください。

Amazon Advertising logo