増分レポート

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では、柔軟性の向上により、カスタム レポートを作成し、レポート作成のアプリケーションやプロセスにデータを統合することができます。詳しくは、新しい Search Ads 360 Reporting API への移行と使用についての記事をご覧ください。

レポートをリクエストするたびにすべてのデータのダンプを受け取る代わりに、前回のレポート以降に変更されたデータのみを定期的にリクエストできます。この場合、増分レポートは、完全なレポートよりも大幅にサイズが小さくなる可能性があります。

増分レポートをリクエストする場合は、次の点に注意してください。

• それでも、増分変更が失われた場合に備えて、完全なレポートを時々リクエストすることをおすすめします。たとえば、1 月中の増分レポートを毎週リクエストする場合、1 月のデータをすべて取得するには、2 月末に 1 月の完全レポートをリクエストする必要があります。
• エンティティが変更されたかどうか常に判断できるわけではないため、エンティティが変更されたことが検索広告 360 で疑われる場合でも、増分レポートにはエンティティが含まれます。つまり、増分レポートには、変更されていないデータが含まれる場合があります。

増分レポートをリクエストするには、次のいずれかの Reports.request.timeRange プロパティを指定します。

changedMetricsSinceTimestamp=timestamp

指定されたタイムスタンプ以降に変更された指標をリクエストします。指標は日単位の粒度で保存され、ある日は変化しても別の日は変化しない可能性があるため、このようなリクエストは日ごとにセグメント化する必要があります（date 列が存在する必要があります）。たとえば、clicks、actions、date 列を含む keyword レポートは、キーワードと日付ごとに、記録されているクリック数またはアクション数が指定のタイムスタンプ以降変更されている行を返します。

タイムスタンプは、リクエストの時点の 8 日前までにする必要があります。変化する指標をすべて取得するには、少なくとも 7 日に 1 回は changedMetricsSinceTimestamp リクエストを行い、指標が確定したら日付ごとに完全なレポートを作成してください（少なくとも 7 日間待つ方が安全です）。パターンの例としては、過去 36 時間以内に変化した指標の増分レポートと 8 日前に発生した指標の完全なレポートを毎日作成するというものがあります。

changedAttributesSinceTimestamp=timestamp

指定されたタイムスタンプ以降に変更された属性をリクエストします。changedAttributesSinceTimestamp リクエストに含めることができるのは属性列のみです（指標列やセグメント列は指定できません）。また、conversion レポートなどの未処理のイベント レポートは機能しません。たとえば、dailyBudget 列と campaignStartDate 列を含む campaign レポートは、指定されたタイムスタンプ以降、1 日の予算または開始日が変更されたキャンペーンの行を返します。

親属性に対する変更は changedAttributesSinceTimestamp レポートにキャプチャされません。たとえば、キーワードが親の広告グループから入札戦略を継承することがあります。広告グループに新しい入札戦略が割り当てられても、このキーワードはレポートに表示されない場合があります。通常、値が親エンティティに依存する（したがって changedAttributesSinceTimestamp レポートに取得されずに変更される可能性がある）属性列には、「有効」という接頭辞が付きます（例: effectiveLabelIds、effectiveBidStartegy など）。