增加的報表

新版 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 報表包含 clicks、actions 和 date 資料欄，系統會針對每個關鍵字和日期傳回一列，其中記錄的點擊次數或操作次數自指定時間戳記起發生變化。

時間戳記不得早於要求時間的前 8 天。如要擷取所有變更的指標，請務必至少每 7 天提出 changedMetricsSinceTimestamp 要求一次，並在指標確定後為每個日期製作完整的報表 (比較安全，至少等待 7 天)。其中一個模式就是每天建立兩份報表：針對過去 36 小時內變更的指標建立增量報表，以及為 8 天前發生的指標建立完整報表。

changedAttributesSinceTimestamp=timestamp

要求的屬性在指定時間戳記後有所變更。changedAttributesSinceTimestamp 要求只能包含屬性欄 (不含指標或區隔欄)，且不適用於原始事件報表 (例如 conversion 報表)。舉例來說，如果 campaign 報表包含 dailyBudget 和 campaignStartDate 欄，系統就會根據指定時間戳記後，針對每個廣告活動傳回一個資料列。

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