如何匯出 Google 廣告素材並保留其來源證據

定義

• 廣告素材：一個公開廣告項目。它不是廣告活動。
• 廣告客戶 ID：Google 為一名廣告客戶提供的帳戶身分。
• 廣告素材 ID：Google 為一名廣告客戶名下一個廣告素材提供的身分。
• 觀察：在收集時間對一個廣告素材的紀錄。
• 指標：指向遠端媒體或預覽資源的連結。
• 清單檔：一份收集設定與摘要檔案。
• 變化版本：一個廣告素材紀錄內的媒體或預覽項目。它不一定是獨立的廣告測試。
• 預覽：用來顯示廣告素材的來源資源。它可能需要渲染，而且不一定是可下載的檔案。
• Actor：一個託管的資料收集程式。
• 已發佈 Task：一份已儲存的公開 Actor 設定。
• **`null`**：沒有可用的值。它不是零。

收集設定與範圍

要收集廣告素材資料，請設定一個 Actor，例如公開的 Google Ads Transparency Scraper。此 Actor 接受 1 至 100 個目標，目標可以是名稱、網域、ID、廣告客戶 URL 或廣告素材 URL。`maxItems` 設定的範圍是 1 至 5000；預設值是 10，而且由所有目標共用。

已發佈 Task 預設為 `nike.com`、地區 `ANYWHERE`、平台 `ALL`、廣告格式 `ALL`、投放詳情關閉，以及 20 個項目的上限 Google Ads Creative Library Export | Ads Data。網域搜尋可以對應多個廣告客戶帳戶，因此調查 1 個指定帳戶時，你必須使用已核實的精確廣告客戶 ID 或 URL。只有當你計劃在事後審閱並分開這些帳戶時，才使用網域搜尋。除非你的研究特別需要投放元資料，否則降低收集上限，並保持投放詳情關閉。可選的日期篩選接受直至今天的真實日期。緊記，收集上限是一個限制，不是完整的廣告歷史。

欄位對應與資料限制

每一列已儲存資料都對應來源平台的特定資料欄位。`advertiserId` 與 `creativeId` 組成一對獨一無二的廣告素材身分。你絕不可只憑品牌名稱識別帳戶。`creativeUrl` 指向公開的來源詳情頁。`mediaUrl` 和 `previewUrl` 都是遠端來源指標，可以傳回 `null`；而且預覽可以是 JavaScript 資源，而不是直接檔案。`variations` 清單和 `variationCount` 記錄巢狀子資產及其 URL 和尺寸，但這些子資產不是獨立的廣告活動變體。

`firstShownAt` 和 `lastShownAt` 在有這些日期時提供公開展示日期，但它們不保證連續投放，也不保證收集時間。`approxDaysShown` 是近似的來源值，不得把它變成精確的連續日數、廣告支出或廣告活動成功。`observedAt` 時間戳記錄 Actor 收集該紀錄的時間。所要求的地區、平台和格式欄位提供收集情境，而不是已投放位置的完整清單。`status` 和 `statusReason` 欄位表示資料列質素；`ok` 表示收集成功，`partial` 可以表示缺少格式。可選的付款人欄位可能不存在，也可能已被關閉，而且付款人不一定是廣告客戶。此外，Google 的來源存放庫可以露出此 Actor 不會傳回的地區專用欄位 Google 廣告透明度說明。

觀察鍵與讀者自建清單檔

廣告客戶 ID 與廣告素材 ID 必須當作一對處理，因為 2 個不同廣告客戶名下的同一個廣告素材 ID 代表 2 個不同身分。Actor 只在單一次執行內移除這一對的重複項目，其後的執行則保留一筆新觀察。因為 Actor 資料列不提供執行 ID，你必須建立讀者自建欄位。

建立讀者自建的 `collection_batch_id`，用於你的批次分組。在另一份讀者自建的收集清單檔中，保留實際執行 ID、組建版本、資料集身分、收集設定、收集時間和執行摘要。建議的觀察鍵結合批次 ID、廣告客戶 ID 和廣告素材 ID。把你的內部執行收據與你的最終證據報告分開。

JSON 資料儲存與變化版本

JSON 是一種文字資料格式，它保留結構化層次。完整的 JSON 檔案保留巢狀變化版本，而 CSV 匯出只是可選的平面表格檢視。一列父觀察可以包含巢狀的變化版本列，但這些子變化版本不是獨立的廣告素材測試或廣告活動測試。始終保留 `null` 值，不要用零或編造的資料取代它們。展示庫是衍生檢視，意思是你必須始終在它下面保留你的原始觀察檔案。

完整收集與保留方法

1. 設定你的目標範圍、地區、公開日期範圍和項目上限。調查 1 個指定帳戶時，使用已核實的精確廣告客戶 ID 或 URL；網域搜尋只配合收集後審閱使用。除非有需要，否則保持投放詳情關閉。
2. 執行 Actor Google Ads Transparency Scraper，並使用已發佈 Task Google Ads Creative Library Export | Ads Data 的設定。
3. 在讀者自建清單檔中記錄你的收集設定。把執行 ID、組建版本、資料集身分、收集設定、收集時間和執行摘要，與你的公開證據報告分開存放。
4. 檢查 OUTPUT 摘要欄位，包括 `creativesSaved`、`duplicatesSkipped`、`unusableCreativesSkipped`、`stopReason` 和 `targetOutcomes`。部分紀錄、失敗目標、零結果和上限停止須保持彼此分開。緊記，空白或縮減的輸出資料集不能證明廣告客戶沒有投放廣告。
5. 套用這項精確的接受規則：一筆已識別觀察必須有非空白的 `advertiserId`、`creativeId`、`creativeUrl` 和 `observedAt`。審閱 `status` 和 `statusReason` 欄位。保留明確缺失的 `mediaUrl` 或 `previewUrl` 值；不要把 `null` 變成零，也不要編造連結。把缺少身分的資料列隔離到獨立的審閱檔案，而不是合併空白值。
6. 建立與 Actor 欄位分開的讀者自建欄。指派讀者自建的 `collection_batch_id`，並結合批次 ID、廣告客戶 ID 和廣告素材 ID，建立你的觀察鍵。
7. 儲存完整的 JSON 觀察檔案，以保留巢狀變化版本。把子變化版本紀錄保留在其父觀察列之下，不要把子資產計算為獨立的廣告素材測試或廣告活動測試。
8. 執行並記錄分開的獨立連結檢查，內容包括檢查時間、指標類型、方法和結果。當新指標出現時，保留較早的指標；即使遠端連結變為無法使用，仍保留觀察紀錄。
9. 附加其後的收集批次，不要取代你較早的觀察檔案。把歷史紀錄與你的衍生最新檢視展示一併保留。
10. 把你已最終確定的來源庫、收集清單檔、有日期的連結檢查紀錄，以及衍生的最新檢視，交給報告步驟。使用原來的廣告客戶 ID 與廣告素材 ID 配對再次尋找來源，並在任何廣告素材評分或廣告活動建議之前停止。

獨立連結檢查與 HTTP HEAD 請求

建立一筆分開的連結檢查紀錄，內容包含父項身分與批次、指標類型、檢查時間、方法和結果。HTTP HEAD 請求只向伺服器索取回應標頭，而不是檔案內容。渲染是指在瀏覽器內成功顯示預覽。200 HTTP 回應碼表示該資源在該次檢查有回應，但 `image/png` 回應不同於 `application/javascript` 回應。

這些回應都不能證明已渲染的影像、永久檔案封存、重用權利或持久可用性。2026年10月13日的小型元資料檢查，從 2 個帳戶儲存了 2 筆 `ok` 觀察，但標頭檢查只證明了有日期的回應，而不是重複歷史或完整覆蓋。下載資產和渲染預覽不在這個來源連結方法的範圍內。

附加其後批次與處理無法使用的指標

附加其後的批次，不要取代你較早的觀察檔案。目前的展示可以顯示每個身分配對的最新觀察，但必須連回歷史紀錄。當舊指標失敗時，保留它的來源紀錄，記錄該次失敗的檢查，並在有需要時於其後的授權審閱中檢查公開來源頁。一個失敗的指標，或一筆在設有上限的收集中沒有出現的觀察，都不能證明廣告已被刪除。不要猜測 URL，也不要嘗試復原已刪除的廣告。因為沒有進行重複執行測試或長期測試，這個例子只教導如何就保留紀錄進行推理。

虛構例子與計數分析

這個例子中的所有紀錄和 ID 都是虛構的。A/B/C1/C2 是教學標籤，不是真實的來源固定樣本。沒有下載媒體檔案。

這次收集得出 5 列觀察，計算方式是批次 S1 的 3 列加上批次 S2 的 2 列（3 + 2 = 5）。獨一無二的廣告素材身分配對有 3 對：A:C1、A:C2 和 B:C1。把所有保留列的變化版本數目相加，得到 6 個變化版本觀察，計算方式是 2 加 1 加 1 加 1 加 1（2 + 1 + 1 + 1 + 1 = 6）。這些變化版本觀察是父紀錄內的子資產，不是 6 個獨一無二的廣告素材，也不是獨立的廣告測試。

每個身分最新一筆的檢視包含 3 列，對應 3 個獨一無二的身分，其中有 2 次有日期且可用的連結檢查，以及 1 次無法使用的檢查。廣告客戶 B:C1 仍由它的 S1 觀察代表，而它沒有出現在批次 S2，並不能證明廣告已被刪除。全部 5 筆觀察都必須保留在庫中。這種紀錄保留保存證據紀錄和指標，但沒有聲稱完整的廣告歷史、永久的媒體檔案儲存、廣告成功，或實際的重複執行測試結果。

公開可見並不授予一般的重用許可 Google 條款：其他內容。這個方法保留來源紀錄和指標；下載或重新發佈資產不在這個來源連結工作流程之內。