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

私の統合はすべての地域を対象としますか？また理解しておかなければならない地域的な考慮事項はありますか？

Amazon DSPレポーティングAPIは以下の地域でご利用いただけます。 NA（USとCA）、EU（UK、DE、FR、IT、ES、SE、DK、FI、NO、AE）およびFE（JPとAU）。各地域のエンドポイントは以下のとおりです。

• NA：https://advertising-api.amazon.com
• EU：https://advertising-api-eu.amazon.com
• FE：https://advertising-api-fe.amazon.com

Amazon DSPレポーティングAPIを介してデータはどのくらいの頻度で更新されますか？

データは1日に数回更新されます。データ保持と更新のスケジュールについては、こちらをご覧ください。

レポートはどのくらいの頻度で取得する必要がありますか？

現在、各レポートタイプについて、広告主様ごとに1日につき1～2件のレポートリクエストを推奨しています。これはデータの更新頻度に基づいています。

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

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

私のアカウントには100件以上の広告主がいます。それらすべてのレポートを取得するにはどうすればいいですか？

一度に100件の広告主について複数のレポートを取得する必要があります。

「Report size too large」というエラーを回避するにはどうすればいいですか？

「Report size too large」というエラーが表示された場合は、CSV形式のレポートをリクエストしてみてください。JSON形式のDSPレポートはAPIで最大25万行をサポートしますが、CSV形式のレポートは最大50万行をサポートします。

さらに、リクエストに含まれる期間、ディメンションの数、指標の数を減らしてみてください。可能な場合は、特定の注文IDで絞り込んでください。

APIの使用時に「Not Acceptable」というエラーが表示されます。

これは、Acceptヘッダーで間違ったバージョンを使用していることが原因です。APIドキュメントで正しいバージョンを見つけてください。

DSPコンソールとAPIのレポートにはどのような違いがありますか？

一部のレポート機能はDSPコンソールでのみ使用できます。また、一部のAPIフィールドの名前は、DSPコンソールでは異なります。

詳しくは、DSPコンソールとAPIをご覧ください。

マネージャーアカウントを使用してDSPレポーティングAPIを呼び出しています。広告主レベルで注文やラインアイテムを編集するためのアクセス権を得ることはできますか？

いいえ。DSPでは、マネージャーアカウントには読み取り専用権限のみを割り当てることができます。読み取り専用アクセス権を持つマネージャーアカウントを使用して、DSPキャンペーン管理エンドポイントを呼び出すことはできません。

詳しくは、マネージャーアカウントをご覧ください。

APIの呼び出し時に、「401 Unauthorized」というエラーが表示されます。

これは、いくつかの原因で発生する可能性があります。

• URLに正しいエンティティIDまたは広告主IDを使用していることを確認してください。エンティティIDはすべて大文字でなければならないことに注意してください。
• API承認ユーザーがマネージャーアカウントのユーザーであることを確認します。
• 広告主様がマネージャーアカウントに正しくリンクされていることを確認します。

レポートをリクエストしようとすると、429エラー「Too Many Requests」が表示されます。

レポートをリクエストする頻度を少なくするか、リクエストするレポートのサイズを小さくしてください。ベストプラクティスについて詳しくは、広告APIのレート制限をご覧ください。

レポートはどのくらいの頻度で取得する必要がありますか？

DSPデータの更新頻度に基づいて、各レポートタイプについて、広告主様ごとに1日につき1～2件のレポートリクエストを推奨しています。