# 名單表單的 Meta 轉換 API（CAPI）：傳送名單又不重複計算

> **答案**：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. 絕對不要傳送症狀等健康資訊。

請參考[韓國名單表單的同意文字](/en/guides/landing-consent-text)，或用[免費同意文字工具](/en/tools/consent)產生。

## 驗證

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

## 把成果回傳

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

## 在 CutLanding 上

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

## FAQ

### 可以拿掉像素，只用轉換 API 嗎？

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

### 我的名單被算了兩次，為什麼？

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

### 存取權杖外洩了怎麼辦？

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


---
Source: https://cutlanding.com/zh-hant/guides/meta-conversions-api
© CutLanding (컷랜딩). Quote freely with a link to the source.
