2 張地區卡片連到同一位廣告主,並各自連到不同的廣告素材清單。

Actor 是在託管環境中執行的資料收集程式。廣告素材是廣告的文字、圖片、影片或其他公開呈現形式。廣告素材資料集為空,只能表示程式沒有儲存任何資料列。光憑這一點,無法得知原因。

這項比較背後的買家問題很直接:「是我輸入錯了嗎?」一則公開支援問題提到,使用者搜尋德國地區的某個網域時,沒有得到任何資料列,但使用者明明能看到廣告。提交的輸入使用了 `maxItems:1`,而平台與格式的值都留白。這份回報說明了為何需要清楚的審查方法,但不能證明該結果的成因。公開支援問題

Chronometrica 發布這篇比較文章,也是文中推薦的 Actor 的開發者。產品證據收集於 2026 年 10 月 20 日。本文沒有透過實際執行來測試任一 Actor,也沒有測試回報中的網域。

選擇工作所需的結果資訊規格

主要選擇取決於你的流程是否要求每個目標都有明確的結果記錄。這裡的「結果資訊規格」,是指文件載明程式會提供哪些資訊,以說明檢查過程中發生了什麼。

Chronometrica 的文件說明了 `targetOutcomes`,並將 `no_results` 與公開來源無法使用的情況分開。文件也說明了已儲存的可用廣告素材、因重複或無法使用而略過的廣告素材,以及最終停止原因。如果你需要這些記錄來審查 0 筆資料列的結果,就選擇它。這項建議以其文件載明的規格為依據。Chronometrica Actor

如果 Fortuitous Pirate 的單一查詢輸入、`advertiserId` 與 `proxyConfiguration` 控制項符合你的工作流程,就繼續使用它。經檢查的結構規範接受歷史回報中的德國查詢,也接受平台與格式都留白的值。決定是否更換工具前,先檢查它目前實際執行的日誌與輸出。其簡短的 README 並不能證明它沒有日誌或各目標的結果資訊。Fortuitous Pirate Actor

選擇工作所需的結果資訊規格
決策要點ChronometricaFortuitous Pirate
結果為空時所需的證據明確列出的各目標結果與停止原因檢查目前實際執行的證據
本次比較中的輸入適用性以網域為目標,明確設定德國、所有平台及所有格式經檢查的結構規範接受歷史回報中的輸入結構
選擇理由你的審查需要文件載明的結果資訊規格其查詢方式與控制項已符合你的流程

這些是選擇準則,並非實測效能結果。現有證據不能證明任何速度、價格、準確度、涵蓋範圍或可靠性優勢。

分開看待已儲存的資料列數與來源狀態

空白資料集只回答一個範圍很窄的問題:儲存了多少筆廣告素材資料列?來源狀態回答的是另一個問題:程式能存取及使用什麼?

審查時,請分開看待以下 3 種可能的解釋。

首先,檢查可能已連上公開來源,但在指定目標與篩選條件下找不到可用結果。下一步是檢查目標身分與搜尋範圍。網域、廣告主、地區或日期不符,都可能改變你預期找到的內容。在證據足以支持之前,不要判定原因。

其次,檢查可能無法使用公開來源。在這種情況下,0 筆資料列的資料集不能說明廣告主的廣告活動。先審查來源存取情況,再對搜尋範圍作出結論。

第三,廣告素材頁面可能看得到,但其中的公開媒體資產無法用於收集。依照 Chronometrica 的結果規則,如果廣告素材缺少可用的公開媒體或預覽,就可能被略過。因此,看得到的頁面與已儲存的廣告素材資料列不一定會一一對應。Chronometrica Actor

這項區別也會改變你回報結果的方式。如果你掌握的資訊只有這些,就寫「在這些設定下,儲存了 0 筆可用資料列」。不要簡化成「這位廣告主沒有廣告」。較短的說法刪除了篩選條件、來源狀況與媒體資產限制,而這些條件正是解讀結果所需的背景。

設定的數量上限也是另一項獨立資訊。要求最多 1 筆資料列,不代表保證有 1 筆資料列。它只設定最大數量。如果檢查儲存了 0 筆資料列,光是提高上限並不能解釋先前的結果。

執行前先準備好德國查詢的輸入

Task 是為 Actor 儲存的輸入預設。連結中的地區研究 Task 標題為 Canada。你可以從它開始,再檢查實際儲存的輸入。經檢查的公開頁面可以存取,但這次頁面檢查並未驗證其儲存的欄位值。地區研究 Task

針對支援問題中的德國案例,請使用以下輸入:

json
{
  "targets": [
    "ritzenberger.de"
  ],
  "region": "DE",
  "platform": "ALL",
  "adFormat": "ALL",
  "includeDeliveryDetails": false,
  "maxItems": 1
}
執行前先準備好德國查詢的輸入

這份輸入已通過比對所儲存公開 JSON Schema 的檢查。JSON Schema 定義了允許的輸入欄位、類型與值。上方顯示的所有欄位都存在於經檢查的結構規範中。這確認了輸入結構,但不能確認執行時能否存取來源,也不保證會有結果。Chronometrica Actor 輸入

執行小規模檢查前,請依照以下步驟操作:

  1. 完整保留回報中的網域,不要修改。若另外知道廣告主的身分,也一併記在審查筆記中。
  2. 開啟 Task 輸入,將地區改為 `DE`。不要只看 Task 標題,也不要假設已儲存的地區設定已符合需求。
  3. 在這次檢查中,將 `platform` 與 `adFormat` 設為 `ALL`。
  4. 檢查每個已儲存的欄位。將輸出與瀏覽器畫面比較之前,先確認所有篩選條件。
  5. 在此處示範的初次檢查中,將 `maxItems` 維持為 `1`。

記錄你在公開來源比較中使用的日期範圍。如果你檢查的證據中,Actor 沒有提供該範圍,就標示為未知。不要加入尚未對照結構規範檢查過的輸入欄位。

經檢查的結構規範允許 `targets` 包含 1–100 個項目,並允許 `maxItems` 使用 1–5,000 的整數。如果你的原始需求是將單次執行設定為傳回超過 5,000 筆結果,這個 Actor 就不符合需求。較小規模的檢查,不能滿足在更大範圍內取得所有結果的要求。Chronometrica Actor 輸入

將結果記錄與資料集一併審查

完成預定的小規模檢查後,將已儲存的資料列與結果記錄一併審查。先看目標,再檢查篩選條件、來源狀態、略過的廣告素材,以及停止原因。Chronometrica 的文件透過目標背景資訊與結果統計,說明了這些項目。Chronometrica Actor

使用簡短的審查記錄表。這裡的記錄表,是指針對 1 個目標所寫下的證據記錄。

  1. 解析後的目標:記錄檢查解析出的廣告主身分。如果與預定的廣告主不同,請清楚保留這項差異。
  2. 要求的篩選條件:記錄地區、平台、格式、已知的日期範圍,以及要求的數量上限。
  3. 來源狀態:記錄結果支持的是「沒有可用結果」,還是「公開來源無法使用」。
  4. 可用資料列:記錄實際儲存的數量。只有輸出回報或證實為 0 時,才能填入 0。
  5. 略過的廣告素材:按照輸出提供的資訊,記錄重複及無法使用的廣告素材數量。保留未知或缺漏的值。
  6. 最終停止原因:記錄檢查結束的原因。不要只根據資料集大小來推斷。
  7. 尚未釐清的原因:說明現有證據仍無法解釋的部分。

每份記錄表都應對應 1 個目標與 1 組設定。否則,後來更改篩選條件時,可能會讓先前的結果看似不一致,但其實 2 次檢查回答的是不同問題。

請謹慎解讀略過數量。因重複而略過與因媒體資產無法使用而略過,代表不同的情況。重複是指相同內容再次出現。媒體資產無法使用,則涉及該廣告素材能否成為可用的已儲存資料列。只使用輸出實際提供的細節;如果只提供合計數量,就不要自行編造分類數量。

如果缺少某個值,請寫「未知」。缺少來源狀態證據,不等於已確認來源失效。缺少略過數量,也不等於已確認略過 0 筆。這樣才能讓記錄在後續審查時仍然有用。

虛構範例:資料列數相同,下一步卻不同

以下是虛構範例。它不是 Actor 測試、實際執行的資料集,也不是客戶成果。

一位分析人員對同一個目標檢查了 2 次。2 次檢查都儲存了 0 筆廣告素材資料列。

檢查 A 成功連上公開來源。其結果回報,在明確列出的篩選條件下沒有可用結果。分析人員的下一步,是將解析後的廣告主與篩選條件,和讓人預期會有廣告的公開畫面進行比較。分析人員會檢查地區、平台、格式、日期,以及查看來源的時間。

檢查 B 無法使用公開來源。分析人員會先檢查來源存取情況。由於這次檢查無法使用來源,因此不能據此對廣告主的廣告作出結論。

計算很簡單:檢查 A 儲存了 0 筆資料列,檢查 B 也儲存了 0 筆資料列。兩者的資料列數相同,但來源狀態不同,因此下一步也不同。

2 次檢查都使用 1 筆資料列的上限。這個上限並不要求任一次檢查必須傳回 1 筆資料列。上限只限制最大結果數量,不保證會有結果。

這 2 種結果都不能證明廣告主沒有廣告。檢查 A 仍受目標、篩選條件及可用結果規則限制。檢查 B 仍受來源存取情況限制。這個範例支持的是審查方法,不是費用估算,也不是可靠性宣稱。

用小規模驗收檢查來作決定

驗收檢查是事先寫明通過條件的小規模測試。這裡的目的,是判斷輸出能否回答你的空白結果問題。

執行前先設定通過條件:「針對這個目標,我能確認解析後的廣告主、要求的篩選條件、來源狀態、已儲存的資料列、略過的廣告素材,以及最終停止原因。」資料列數不必為正數,也能通過這項檢查。能夠解釋的空白結果,也可以是有用的證據。

請依照以下方法操作:

  1. 寫下你預期能看到的公開證據。記錄網域或廣告主、地區、可見廣告素材的參考資訊,以及觀察時間。在筆記中原樣保留最初的輸入。
  2. 驗證輸入結構。根據 Actor 目前的結構規範,檢查允許的欄位與值。將結構規範錯誤,與輸入有效但沒有產生可用資料列的搜尋分開看待。
  3. 執行預定的小規模檢查。使用你已審查過的明確設定。不要只為了讓結果數量成為正數,就同時更改多個篩選條件。
  4. 填完記錄表。將結果證據與資料集一併閱讀。把每個尚未確認的值標示為未知。
  5. 選擇下一步行動。如果沒有可用結果,就審查身分與篩選條件;如果來源無法使用,就審查來源存取情況;如果廣告素材無法使用,就審查媒體資產限制。

如果需要進一步檢查,請更改 1 項相關設定,並記錄原因。這樣更容易解讀新結果。資料集更大,不代表解釋就一定更好。

如果問題仍未解決,請準備支援報告,附上已移除敏感資訊的輸入、預期的公開證據、觀察到的結果,以及尚待回答的問題。「已移除敏感資訊」是指已刪除私人或敏感細節。不要附上代理伺服器憑證或其他機密資訊。

這套流程也提供了公平的評估依據,讓你判斷是否繼續使用現有工具。請判斷其實際證據是否符合你的驗收條件。單憑一份歷史支援回報,無法判定目前這次執行是否符合條件。

釐清空白結果問題後,可使用地區廣告素材比較指南,比較不同地區已儲存的廣告素材組合。這是另一項分析。在將空白檢查結果用作地區差異的證據之前,先確認它代表什麼。

來源與延伸閱讀

作者 Chronometrica · 更新日期

返回頂端 ↑