您可以定期要求只要求自上次報告以來有所變更的資料,而非在每次要求報表時接收所有資料。這些增量報表可能會遠低於完整報表。
如要索取增量報表,請注意下列事項:
- 我們仍建議您每隔一段時間就索取一次完整報表,以免有遺漏某些增量變更。舉例來說,如果您在 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
。