Communitygithub.com

ooiyeefei/ccc

在網站上設定 Meta Pixel(Facebook/Instagram 廣告追蹤)並端到端觸發轉換事件(Lead、CompleteRegistration、Purchase)。引導使用者操作 Business Suite / Events Manager、建立或尋找 Pixel/Dataset ID、安裝基礎程式碼、觸發標準事件,並在投放廣告前使用 Meta Pixel Helper 進行驗證。

ccc 是什麼?

這是一個專為開發者設計的 AI 技能,用於在網站上完整設定 Meta Pixel(Facebook/Instagram 廣告追蹤)並觸發轉換事件。它針對兩個常見陷阱提供了明確的指引:**Pixel vs Conversions API 的決策**(Meta 的精靈會積極推廣較重的 CAPI)以及**資料類別宣告**(錯誤選擇可能限制廣告效能)。技能會根據使用者已經完成的步驟(如是否已有 Facebook 頁面、Business Suite 或 Pixel ID)動態調整引導流程,避免重複建立。支援的平台包括 Next.js、HTML、WordPress、Shopify、GTM 等,並提供參考文件涵蓋各平台的安裝方式、標準事件清單、CAPI 的考量以及完整的驗證檢查清單。其主要價值在於幫助開發者避開 Meta 精靈可能導致的誤區,快速、正確地完成 Pixel 設定,確保廣告優化有真實的轉換資料可學習。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ooiyeefei/ccc/tree/HEAD/skills/meta-pixel-setup

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

ccc preview

說明文件

Meta Pixel 設定

讓 Meta Pixel 在網站上追蹤真實的轉換事件,並經過驗證,讓 Facebook/Instagram 廣告優化有真實的資料可以學習。有兩件事經常讓使用者困擾,這個技能會優先處理:Pixel vs Conversions-API 的決策(Meta 的精靈會積極推廣較重的 CAPI)以及要宣告哪個資料類別(錯誤的選擇可能會限制你的廣告)。

命名說明:Meta 在 UI 中已將「Pixel」重新命名為 「Dataset」。一個 dataset 包含 pixel,其 Dataset ID = Pixel ID(一個約 15–16 位數的數字)。將兩者視為同一件事。

從使用者目前的狀態開始

設定的鏈結是:Facebook 頁面 → 商務組合 → Events Manager → Pixel/Dataset(取得 ID)→ 網站上的基礎程式碼 → 轉換事件 → 驗證。 使用者可能處於鏈結中的任何位置。先詢問,然後直接介入 — 不要重新建立已經存在的東西(商家通常已經有 pixel;重複使用它,而不是將資料分散到兩個不同的 pixel 中)。

詢問(根據他們已經提到的內容進行調整):

  1. 你已經設定好 Facebook 頁面 和 Meta Business Suite / 商務組合 了嗎?
  2. 你是否已經有 Pixel / Dataset(在 Events Manager 中)?如果有的話,Dataset ID(那個約 16 位數的數字)是什麼?貼上它 — 可能只需要這個。
  3. 哪一個轉換事件最重要(潛在客戶/候補名單提交、註冊、購買)?這是廣告優化的目標。
  4. 網站的技術棧 + 網域(Next.js、純 HTML、WordPress、Shopify)— 這決定了程式碼如何嵌入。

如果他們已經有 Dataset ID 和頁面,直接跳到安裝(§3)。不要引導他們回頭去建立已經完成的帳戶。

決策 1:僅 Pixel,還是 + Conversions API?(從僅 Pixel 開始)

Meta 的設定精靈會顯示 「Conversions API 和 Meta Pixel(推薦)」 並附帶一個亮眼的統計數據。不要反射性地接受它。以下是誠實的取捨:

  • Meta Pixel(瀏覽器) — 網站上的一段程式碼片段從訪客的瀏覽器發送事件。簡單,不需要後端,今天就能用。這是你啟動所需的一切。
  • Conversions API(CAPI) — 你的伺服器直接向 Meta 發送事件。它是伺服器對伺服器的,「需要開發人員支援」,而且為了真正有效,它需要將客戶 PII(電子郵件、電話、IP)發送給 Meta 以進行比對。這需要更多的建置工作以及更大的隱私/合規風險(GDPR/PDPA/CCPA)。

所以:先用瀏覽器 Pixel 啟動。 之後再加入 CAPI,只有在瀏覽器訊號遺失(廣告封鎖器、iOS ATT)對你造成可測量的損害,而且你已經解決了 PII/同意問題時才這麼做。將 CAPI 視為啟動後的優化步驟,而不是設定步驟。在實際接線之前,請先閱讀 references/conversions-api.md — 它的存在是為了防止你意外地將個人資料發送給 Meta。

決策 2:Dataset「類別」— 除非明確符合,否則留空

建立 dataset 時,Meta 會要求「選取任何適用的類別」。對於金融/健康/敏感產品來說,這是個陷阱。 對話框警告:「根據類別和地點,資料分享可能會受到限制或封鎖。」 像 「金融服務」、「經濟弱勢」、「個人困難」、「國籍」 這類類別會觸發 Meta 的受限資料處理機制,並可能限制或封鎖你的廣告優化。

規則:只有在某個類別準確且無可避免地描述了你的業務,而且你了解它會限制資料時,才勾選它。 一個預算管理/生產力/SaaS 工具是軟體,而不是「金融服務」(那個類別是給貸款機構、信用報告、消費者金融的)。如果不確定,將類別留空(這是選填的)— 留空表示沒有限制,這正是普通的候補名單/註冊測試想要的。

1. 建立或尋找 Pixel/Dataset(取得 ID)

在 Events Manager 中:

  1. 左側導覽列 → 連結資料(綠色 +)→ Web → Meta Pixel → 連結。(或者如果已存在 dataset,點擊它 — ID 就在其名稱下方。)
  2. 以商家名稱命名(例如「Acme Web」)。至於類別,請參閱決策 2(通常留空)。
  3. 複製 Dataset ID — 名稱下方那個約 16 位數的數字。之後也可以在 Events Manager → Datasets 中隨時看到。
  4. 如果它啟動了一個提供 Conversions-API 與 Pixel-only 選擇的「設定 / 連結你的網站」精靈 — 你可以關閉/跳過它。你只需要 ID;程式碼將手動放入(§3)。如果你確實繼續進行,請選擇 Meta Pixel only(決策 1)。

2.(選填)重複使用現有的 pixel

Pixel 不像 GA4 資源那樣是一個嚴格的報表牆。 一個 pixel 可以涵蓋整個網域 — 主應用程式和 /waitlist 登陸頁面。透過事件和自訂參數(例如 content_name: 'waitlist')來區分漏斗,而不是使用第二個 pixel。如果商家已經有一個,請重複使用其 ID。

3. 安裝基礎程式碼

貼入每個頁面的 <head> 中,並將 YOUR_PIXEL_ID 替換為實際 ID。它會自動觸發 PageView。(從 Events Manager 複製你確切的程式碼片段 — 它已經預先填入了 ID — 或者使用這個標準形式。)

<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window,document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
  src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->

請勿添加 integrity/SRI 雜湊 — fbevents.js 是一個有版本號的載入器,Meta 會就地更新且不發布穩定的雜湊值;SRI 會導致它失效。特定框架的安裝方式(Next.js next/script、WordPress、Shopify、GTM)請參考 references/install-by-platform.md。

4. 在操作發生時觸發轉換事件

使用標準事件以便 Meta 的優化和報表能夠識別 — Lead(候補名單/聯絡)、CompleteRegistration(註冊)、Purchase(銷售)。完整清單以及何時使用每個事件:references/standard-events.md。僅在操作真正成功後才觸發它,絕不要在捕獲到錯誤時觸發。

<script>
form.addEventListener('submit', async function (e) {
  e.preventDefault();
  try {
    await saveTheLead(/* ... */);          // 1. 先持久化 — 真正的成功
    if (window.fbq) fbq('track', 'Lead', { // 2. 然後才計數(防護廣告封鎖器)
      content_name: 'waitlist',            // 可分段、非 PII 的參數
      value_bucket: 'high'
    });
    window.location.href = '/thank-you';
  } catch (err) {
    showError('Something went wrong, please try again.');  // 不觸發事件,不偽造成功
  }
});
</script>

PII 規則 — 不要透過瀏覽器 Pixel 發送個人資料

絕對不要將電子郵件、電話、姓名或地址作為事件參數傳遞。發送類別/區間(content_name、價值區間、人物誌)— 足夠用來區分,不足以識別個人。(Meta 確實會使用雜湊 PII 的唯一地方是 CAPI 的 Advanced Matching,這是一個經過審慎考慮、獲得同意且基於伺服器的選擇 — 請參閱 references/conversions-api.md,而不是要摻入瀏覽器事件中的東西。)

5. 在花費之前進行驗證 — 關鍵關卡

在正式/預覽網站上進行一次真實的轉換,然後確認:

  • 安裝 Meta Pixel Helper Chrome 擴充功能。載入頁面 → 它會顯示 pixel + PageView。提交表單 → 它會顯示 Lead 事件以及你的參數。
  • 或者 Events Manager → 你的 dataset → Test events,輸入網站 URL,然後即時觀看事件到達。
  • 僅在成功時觸發: 製造一個失敗情況,並確認事件沒有觸發。

只有在你能看到轉換事件正確觸發之後,廣告預算才能上線。配線錯誤的轉換會讓 Meta 向錯誤的受眾進行優化,而且你無法從儀表板中分辨出來。完整檢查清單:references/verify-checklist.md。

「你可以幫我設定這個嗎?」

帳戶/頁面/Business-Suite/Pixel 的建立需要使用者的 Meta 登入資訊 — 無法代表他們完成;這是一個簡短的 UI 操作(此技能會引導)。取得 Dataset ID 是使用者的唯一工作。助理可以在取得 ID 後,將基礎程式碼 + 事件寫入網站。按照這個方式分工 — 並根據上述兩個決策,引導他們避開 CAPI 精靈和敏感類別。

參考檔案

  • references/install-by-platform.md — 針對 Next.js、HTML、WordPress、Shopify、GTM 的基礎程式碼安裝方式。
  • references/standard-events.md — 針對常見轉換的 Meta 標準事件名稱和參數。
  • references/conversions-api.md — CAPI 是什麼、何時值得使用,以及在接線前的 PII/同意防護措施。
  • references/verify-checklist.md — 花費前的驗證關卡(Pixel Helper、Test Events、常見失敗原因)。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能