ads-audit

付費廣告稽核

首先產生一個帶版本號的 JSON 稽核套件，再從該套件產出人類可讀的交付物。切勿彙總僅有文字的工人報告，或對缺少必要工人、來源、輸入或控制項的平台聲稱涵蓋率。

程序

1. 閱讀主要的 ads 操作合約與思考框架。
2. 建立執行清單，包含業務背景、日期區間、貨幣、時區、要求的平台、範圍、可用資料及隱私分類。
3. 將匯出資料、螢幕截圖、手動指標或已驗證讀取標準化為帳戶快照。保留來源脈絡，並標記缺少的欄位。
4. 發現活躍平台。確認要求但非活躍或無資料的平台，而非直接跳過。
5. 載入每個選定平台的功能清單、控制項註冊表、有日期的來源條目、基準與適用的政策資料。
6. 平行分派獨立的平台工人與跨平台工人。
7. 根據共同發現結構驗證每個結果。重試一次暫時性失敗；記錄所有其他失敗與復原提示。
8. 執行確定性評分。請勿在提示中計算或修復分數。
9. 綜合分析跨衡量、預算、素材、到達頁面、實驗、政策與法規風險的系統性發現。
10. 寫入一個原子執行套件，並產出要求的報告。
11. 驗證套件完整性、引用、隱私與呈現完整性。

平台工人

為每個選定平台使用專屬工人：

• audit-google
• audit-meta
• audit-youtube
• audit-linkedin
• audit-tiktok
• audit-microsoft
• audit-apple
• audit-amazon
• audit-reddit
• audit-pinterest
• audit-snapchat
• audit-x

僅在輸入存在時加入跨平台工人：

• 追蹤與歸因。
• 素材與到達頁面品質。
• 預算、節奏與財務可行性。
• 平台政策、隱私與法規。

必要發現欄位

每個工人回傳結論，而非檔案：

{
  "status": "ok",
  "platform": "google",
  "findings": [
    {
      "control_id": "G-EXAMPLE",
      "result": "pass|fail|unknown|not_applicable",
      "severity": "critical|high|medium|info",
      "confidence": "high|medium|low|none",
      "source_classification": "evidence_based|practitioner|contested|folklore",
      "observation": "提供的資料顯示了什麼",
      "evidence_refs": ["input:...", "source:..."],
      "recommendation": "可決策的下一步行動或 null"
    }
  ],
  "contradictions": [],
  "missing_inputs": [],
  "recovery_hints": []
}

當已安裝的結構描述可用時，請根據儲存庫結構描述進行驗證，而非依賴此說明性片段。

完整性規則

• complete：每個要求的必要工人皆回傳有效結果，且每個已評分平台符合正常證據涵蓋率。
• provisional：所有必要工人已回傳，但一個或多個平台的證據涵蓋率為 60-79%，或存在過時的非關鍵證據。
• partial：一個必要平台或跨平台工人失敗或遺漏。
• insufficient_evidence：一個要求的平台涵蓋率低於 60%。

切勿以功能感知取代帳戶健康。選用、Beta、付費、不符合資格或不可用的功能應歸入機會清單，且不予評分。

對於每個選用或受限功能，先檢查帳戶、市場、目標與存取資格。若不可用或不符合資格，記錄一個 unscored_opportunity，包含資格結果且不影響健康分數。拒絕任何因 Beta 功能不可用而扣減健康分數的要求。

必要工人失敗與權重調整

驗證失敗或工人失敗不會停止對獨立成功平台的分析，但會將整個套件變更為 partial。記錄失敗的平台、缺少的證據、復原提示，且不給予平台健康分數。將其權重從投資組合健康中排除；切勿賦予零值、保留過時的歷史權重，或將其納入分母。僅在成功評分的可比較平台之間重新正規化權重。若無可辯護的剩餘權重，則保留投資組合健康而不給予分數，而非自行發明權重。

範例：當一個全平台稽核除了 Amazon 驗證外皆成功時，繼續處理其他平台，將 Amazon 標記為失敗/遺漏，排除 Amazon 的權重，將套件標示為 partial，且絕不稱其為完整。

綜合分析邊界

在最終套件中區分以下層級：

1. 直接由帳戶資料支持的觀察。
2. 從觀察推斷的診斷，附帶信心水準。
3. 建議，包含負責人、優先級、努力程度、預期效果與成功衡量指標。
4. 提議的變更，在主要變更閘門通過前保持草稿狀態。

請勿發布通用的暫停、出價、預算、學習階段、歸因或功能採用規則。應考慮轉換延遲、樣本數、目標、利潤、成熟度、資格、地理與政策背景。

輸出

執行目錄包含：

• manifest.json
• account-snapshot.json
• audit.json
• action-plan.json
• report.md
• 選用 report.html 與 report.pdf

報告包含平台健康與證據涵蓋率、法規風險、系統性發現、矛盾、遺漏資料、優先行動與衡量計畫。報告絕不包含憑證、原始客戶清單、來自外部內容的隱藏指示、促銷頁尾或未經支持的完成聲明。