兩張地區卡片連接至一個廣告主和分開的素材清單。
請把所要求的地區與每項已儲存的觀察一併保留。

設定與公開組建詳情

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 並不證明完整的國家覆蓋。只測試了加拿大;真正的第二個國家比較,必須先有一次已通過驗證且相符的第二次執行,然後才可以比較。不要把美國虛構內容呈現為產品已通過測試驗證。

地區素材比較的步驟

  1. 請先確認確切的廣告主 ID。一個網域名稱可以對應多個帳戶,因此開始前請檢查帳戶納入範圍。
  2. 請選擇兩個國家。請使兩次執行的平台、廣告格式、日期設定和項目上限保持相同。請把廣告主所在國家與你所要求的廣告地區分開。
  3. 請先執行小型測試。就加拿大而言,targets 請使用你已知的廣告主 ID,region 為 CA,platform 為 ALL,廣告格式為 ALL,includeDeliveryDetails 為 false,maxItems 為 2。上限是限制,不是承諾的數量。
  4. 請儲存每個原生素材行。請記下廣告主 ID、素材 ID、素材 URL、region 和 status。不要根據這些日期猜測受眾目標或成效。
  5. 比較集合之前,請先檢查每次來源執行。查詢失敗或達到上限是來源限制,不是空的總體。如果輸入、身分或收集日期有實質差異,請把樣本標示為未配對,不要把差異歸因於地區篩選。
  6. 請為每個地區樣本,使用由廣告主 ID 與素材 ID 組合而成的鍵來建立集合。請使用該確切的鍵,報告交集和每個只屬於該樣本的集合。未知的 ID 維持未解析。同一則素材中的多個變體並不是多個素材 ID。
  7. 請清楚描述結果。請使用例如「兩邊都觀察到」、「僅地區 A」、「僅地區 B」或「在本樣本中未見」等標籤。請把最後一項與「從未投放」區分開。結果差異可能反映來源選擇、上限、時間變化或缺少的詳情,而不是已證明的廣告主策略。
  8. 請交付你的成員表和輸入收集紀錄。如果查詢失敗,或廣告主不相符的情況仍然存在,請停止比較,並保留你的單一地區證據。不要把「任何地方」樣本與國家樣本合併。

原創虛構的地區樣本紀錄與輸入收集紀錄

以下原創虛構的樣本輸入收集紀錄和成員表,說明的是讀者自製的輸入收集紀錄,不是原生欄位,也不是實際的美國產品執行。假設廣告主 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-312026-02-15T10:30:00Z3sources_finished
美國樣本廣告主 A, US, ALL, ALL, maxItems 5, includeDeliveryDetails false, dateFrom 2026-01-01, dateTo 2026-03-312026-02-15T11:15:00Z4sources_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 · 更新日期

返回頂端 ↑