增量报告

新版 Search Ads 360 Reporting API 现已发布。这个新 API 让您可以更灵活地生成自定义报告,并将数据整合到您的报告应用和流程中。您可以详细了解如何迁移到和使用新版 Search Ads 360 Reporting API

您可以定期仅请求自上次报告以来更改的数据,而不是在每次请求报告时都接收所有数据的转储。这些增量报告可能比完整报告小得多。

如果您请求获取增量报告,请注意以下几点:

  • 最好每隔一段时间请求一次完整的报告,以防某些增量更改丢失。例如,如果您在 1 月份请求每周增量报告,则应在 2 月底请求获取 1 月份的完整报告,以确保获取 1 月份的所有数据。
  • 由于并非总是能够确定某些实体是否已更改,因此如果 Search Ads 360 甚至怀疑某个实体已更改,增量报表便会包含该实体已发生更改。这意味着增量报告可能包含没有变化的数据。

要请求增量报告,请指定以下 Reports.request.timeRange 属性之一:

changedMetricsSinceTimestamp=timestamp

请求自指定时间戳以来更改的指标。由于指标是按天进行存储的,并且可能在一天内发生变化,但在另一天不会,因此此类请求必须按天细分(必须存在 date 列)。例如,如果 keyword 报告包含 clicksactionsdate 列,则会为每个关键字和日期返回一行,其中记录的点击次数或操作次数自指定时间戳以来发生了更改。

时间戳不得早于发出请求的时间的 8 天。如需捕获所有变化的指标,请确保每 7 天至少发出一次 changedMetricsSinceTimestamp 请求,并在指标稳定后为每个日期生成一份完整报告(至少等待 7 天是更安全的做法)。例如,您可以每天创建两份报告:一份增量报告,用于记录过去 36 小时内更改的指标,以及一份完整报告,用于记录 8 天前发生的指标。

changedAttributesSinceTimestamp=timestamp

请求自指定时间戳以来发生更改的属性。changedAttributesSinceTimestamp 请求只能包含属性列(不含指标列或细分列),并且不适用于原始事件报告(如 conversion 报告)。例如,包含 dailyBudgetcampaignStartDate 列的 campaign 报告将为每个自指定时间戳以来每日预算或开始日期发生更改的每个广告系列返回一行。

请注意,changedAttributesSinceTimestamp 报告中不会捕获对父属性的更改。例如,关键字可能会沿用父级广告组的出价策略。 即使为广告组分配了新的出价策略,此关键字也可能不会显示在报表中。值依赖于父实体(因此,changedAttributesSinceTimestamp 报告不会提取)的属性列通常具有“有效”前缀,例如 effectiveLabelIdseffectiveBidStartegy