名單表單的 Meta 轉換 API(CAPI):傳送名單又不重複計算

指南 · 轉換追蹤

如何透過像素和轉換 API 同時把名單傳給 Meta 並共用同一個事件 ID、取得存取權杖、在測試事件中驗證,以及處理雜湊聯絡資料的同意問題。

答案:Meta 轉換 API(CAPI)是從你的伺服器傳送事件,而不是從訪客的瀏覽器。把它和像素搭配使用,並讓兩邊使用相同的事件名稱和相同的事件 ID;Meta 就會保留其中一筆、捨棄重複的那筆。像素漏掉的名單(廣告攔截器、瀏覽器追蹤限制、分頁被關掉),伺服器事件仍然會記錄下來。

為什麼只靠像素不夠

像素是在訪客的瀏覽器裡執行的。廣告攔截器、iOS 的追蹤限制,以及送出後馬上關掉分頁,都會讓事件遺失。結果 Meta 回報的轉換偏少,用來優化廣告的資料也變少。從伺服器端再送一份,就能補上這個缺口。

你需要準備

  1. 像素(資料集)ID:在 Meta 事件管理工具 → 資料來源中取得。
  2. 轉換 API 存取權杖:事件管理工具 → 你的資料集 → 設定 → 轉換 API → 產生存取權杖。
  3. 測試事件代碼(選用):顯示在「測試事件」分頁,以 TEST 開頭。

重複資料刪除如何運作

傳送來源 事件名稱 事件 ID
瀏覽器像素 Lead fbq('track', 'Lead', {}, {eventID: 'abc123'})
伺服器(CAPI) Lead "event_id": "abc123"

當兩邊送來相同的名稱和 ID,Meta 只會保留一筆。如果 ID 不同,或名稱不同(例如 Lead 和 SubmitApplication),這筆名單就會被算兩次。請在送出當下於瀏覽器產生一個 ID,再同時傳給兩邊。

伺服器事件要放哪些內容

  • event_name(Lead)、event_time、event_id、action_source: "website"、event_source_url
  • user_data
    • 直接傳送:client_ip_address、client_user_agent、fbc(點擊 ID cookie)、fbp(瀏覽器 ID cookie)
    • 以 SHA-256 雜湊處理:電話(ph,含國碼的數字,例如 821012345678)、電子郵件(em,轉成小寫)、姓名

識別資料越多,事件配對品質越好,但要先處理好同意問題。

同意:雜湊過的資料仍是個人資料

依照韓國 Personal Information Protection Act(以及大多數隱私法規),把電話號碼雜湊處理並不會讓它變成匿名資料,而且 Meta 是境外的接收方。比較安全的設定方式:

  1. 另外加一項可自由選擇的「為廣告成效衡量進行跨境傳輸」同意:接收方(Meta Platforms)、國家、項目、目的、保存期間。
  2. 只有同意的人,才附上雜湊處理後的聯絡資料。
  3. 其他人的事件只傳送 IP、使用者代理程式和點擊 ID。
  4. 絕對不要傳送症狀等健康資訊。

請參考韓國名單表單的同意文字,或用免費同意文字工具產生。

驗證

  1. 加上測試事件代碼,送出一筆測試名單。
  2. 在「測試事件」中應該會看到一筆瀏覽器事件和一筆伺服器事件,其中一筆標示為已刪除重複。
  3. 正式上線前移除測試代碼。

把成果回傳

當名單變成諮詢或成交時,用相同的雜湊識別資料(或外部 ID)送出一個自訂伺服器事件。這樣 Meta 就能學習哪些人不只是填完表單而已。

在 CutLanding 上

在「設定 → 連結」中貼上像素 ID 和存取權杖。名單儲存後,像素事件和伺服器事件會以相同的 ID 送出;只有同意廣告成效衡量的人才會附上雜湊聯絡資料,健康資訊絕不會傳送,傳送失敗的事件則會在 24 小時內自動重試。

FAQ

可以拿掉像素,只用轉換 API 嗎?

Meta 建議兩者搭配重複資料刪除一起使用。瀏覽器資料(fbp 和 fbc cookie)有助於配對,而且一邊失敗時,另一邊仍會記錄名單。

我的名單被算了兩次,為什麼?

像素和伺服器的事件名稱或事件 ID 不一致。每次送出時兩邊都用同一個 ID,並使用相同的事件名稱。

存取權杖外洩了怎麼辦?

到事件管理工具產生新的權杖,並在所有用到的地方替換掉。權杖只能放在伺服器上,絕對不要寫進頁面 HTML。

相關指南