増分レポート
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
新しい 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 など）。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2023-12-14 UTC。
[null,null,["最終更新日 2023-12-14 UTC。"],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
