增加的報表

新版 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 報表)。舉例來說,如果 campaign 報表包含 dailyBudgetcampaignStartDate 欄,系統就會根據指定時間戳記後,針對每個廣告活動傳回一個資料列。

請注意,changedAttributesSinceTimestamp 報表不會擷取父項屬性的變更。舉例來說,某個關鍵字可能會沿用上層廣告群組的出價策略。即使廣告群組獲派新的出價策略,這個關鍵字也可能不會顯示在報表中。值取決於父項實體的屬性欄 (因此可能會因 changedAttributesSinceTimestamp 報表未擷取而可能變更) 前置字串為「有效」,例如 effectiveLabelIdseffectiveBidStartegy