
設定與公開組建詳情
Google Ads Transparency 公開組建 0.2.7 接受包含名稱、網域、廣告主 ID 或公開的廣告主/素材 URL 的 targets;亦接受 region、platform、adFormat、可選的 dateFrom/dateTo、includeDeliveryDetails 和 maxItems。已儲存的 Task 預設使用的 targets 例如 `["nike.com", "adidas.com"]`,region `CA`,platform `ALL`,adFormat `ALL`,includeDeliveryDetails `false`,以及 maxItems `10`。請把樣本 targets 替換為一個預定的已核對廣告主 ID,以進行首次檢查:targets `[oneID]`,region `CA`,platform `ALL`,adFormat `ALL`,includeDeliveryDetails `false`,以及 maxItems `2`。請使用確切的原生 adFormat,不要使用自創的輸入。可選的 dateFrom/dateTo 設定在相比的樣本之間必須一致;不要自創分頁。
必要的原生欄位包括 input、inputType、requestedRegion、requestedPlatform、requestedFormat、advertiserId、advertiserName、advertiserLegalName、advertiserDomain、advertiserCountryCode、advertiserVerified、creativeId、creativeUrl、observedAt、status 和 statusReason。可選的 payerName、servedRegions 和 servedPlatforms 可以是 null。請把 requestedRegion 與 advertiserCountryCode 和可選的投放地理範圍分開;不要推斷目標設定、受眾國籍或非公開的廣告成效資料。
OUTPUT 代表執行證據,包含 targetsReceived、targetsResolved、targetOutcomes、duplicatesSkipped、unusableCreativesSkipped、creativesSaved、statusCounts 和 stopReason。目前實際而範圍有限的測試驗證結果與虛構內容不同:一次精確 ID 的加拿大先導測試,在上限 2 之下傳回一個有用素材,其 requestedRegion 為 ca、advertiserCountryCode 為 SG、advertiserDomain 為 null、servedRegions 為 null、servedPlatforms 為 null,而且投放詳情為關閉;null 表示無法取得,而不是沒有投放。OUTPUT 報告一個 target 已接收並已解析、一個已儲存素材、status 為 ok,以及 sources_finished。上限 2 是最高限度,不是承諾的數目,而且 sources_finished 並不證明完整的國家覆蓋。只測試了加拿大;真正的第二個國家比較,必須先有一次已通過驗證且相符的第二次執行,然後才可以比較。不要把美國虛構內容呈現為產品已通過測試驗證。
地區素材比較的步驟
- 請先確認確切的廣告主 ID。一個網域名稱可以對應多個帳戶,因此開始前請檢查帳戶納入範圍。
- 請選擇兩個國家。請使兩次執行的平台、廣告格式、日期設定和項目上限保持相同。請把廣告主所在國家與你所要求的廣告地區分開。
- 請先執行小型測試。就加拿大而言,targets 請使用你已知的廣告主 ID,region 為 CA,platform 為 ALL,廣告格式為 ALL,includeDeliveryDetails 為 false,maxItems 為 2。上限是限制,不是承諾的數量。
- 請儲存每個原生素材行。請記下廣告主 ID、素材 ID、素材 URL、region 和 status。不要根據這些日期猜測受眾目標或成效。
- 比較集合之前,請先檢查每次來源執行。查詢失敗或達到上限是來源限制,不是空的總體。如果輸入、身分或收集日期有實質差異,請把樣本標示為未配對,不要把差異歸因於地區篩選。
- 請為每個地區樣本,使用由廣告主 ID 與素材 ID 組合而成的鍵來建立集合。請使用該確切的鍵,報告交集和每個只屬於該樣本的集合。未知的 ID 維持未解析。同一則素材中的多個變體並不是多個素材 ID。
- 請清楚描述結果。請使用例如「兩邊都觀察到」、「僅地區 A」、「僅地區 B」或「在本樣本中未見」等標籤。請把最後一項與「從未投放」區分開。結果差異可能反映來源選擇、上限、時間變化或缺少的詳情,而不是已證明的廣告主策略。
- 請交付你的成員表和輸入收集紀錄。如果查詢失敗,或廣告主不相符的情況仍然存在,請停止比較,並保留你的單一地區證據。不要把「任何地方」樣本與國家樣本合併。
原創虛構的地區樣本紀錄與輸入收集紀錄
以下原創虛構的樣本輸入收集紀錄和成員表,說明的是讀者自製的輸入收集紀錄,不是原生欄位,也不是實際的美國產品執行。假設廣告主 A 有一份輸入已配對的輸入收集紀錄,在相同的 platform ALL、廣告格式 ALL、上限 5、includeDeliveryDetails false、明確的 dateFrom 2026-01-01 和 dateTo 2026-03-31 之下收集,加拿大和美國的具體觀察時間戳都在 2026-02-15。廣告主設定或收集界限有實質差異時,會產生未配對樣本,而不是地區效應。
| 地區樣本 | 輸入設定 | 觀察時間(UTC) | 可用行 | 停止原因 |
|---|---|---|---|---|
| 加拿大樣本 | 廣告主 A, CA, ALL, ALL, maxItems 5, includeDeliveryDetails false, dateFrom 2026-01-01, dateTo 2026-03-31 | 2026-02-15T10:30:00Z | 3 | sources_finished |
| 美國樣本 | 廣告主 A, US, ALL, ALL, maxItems 5, includeDeliveryDetails false, dateFrom 2026-01-01, dateTo 2026-03-31 | 2026-02-15T11:15:00Z | 4 | sources_finished |
以下是原創虛構的地區成員表,當中有五個複合鍵,每個鍵由 advertiserId 加 creativeId 組成。此處,AC1、AC2、AC3、AC4 和 AC5 代表廣告主 A 的虛構素材鍵。
| 素材鍵 | 加拿大樣本 | 美國樣本 | 成員狀態 |
|---|---|---|---|
| AC1 | 存在 | 未見 | 僅加拿大 |
| AC2 | 存在 | 存在 | 兩邊都觀察到 |
| AC3 | 存在 | 存在 | 兩邊都觀察到 |
| AC4 | 未見 | 存在 | 僅美國 |
| AC5 | 未見 | 存在 | 僅美國 |
在這個原創虛構集合中,加拿大樣本大小是 3,美國樣本大小是 4,交集大小是 2(AC2、AC3),僅加拿大的大小是 1(AC1),僅美國的大小是 2(AC4、AC5),併集大小是 5。「未見」只表示在該已儲存的已核對樣本內缺席,而不是從未投放。素材 C3 的重複觀察只貢獻一個已知鍵,未知鍵在可信集合之外維持未解析。如果改為美國執行失敗,該集合是未知,而不是已知含有零個元素,而且無法據此計算只在一個樣本中出現的成員數目。
來源與延伸閱讀
作者 Chronometrica · 更新日期
返回頂端 ↑

