Meta 轉換 API 怎麼串?事件去重與驗收指南

紅髮女子在辦公室專注看著兩台顯示程式碼的螢幕
阿提拉有限公司 ODIGI 標誌

電商企業最強的行銷推手

阿提拉有限公司

每一個廣告活動是否能成功賺錢,和產品、市場和廣告操作都有關係,阿提拉有限公司擅長幫企業主利用數位廣告找到對的受眾,並透過長期累積的數據和經驗將廣告費盡可能降低,讓企業主能專心創造產品的顧客價值與競爭優勢,攜手阿提拉有限公司一起找出成功方程式!

文章目錄
  1. 阿提拉有限公司
  2. Meta 轉換 API 怎麼串?先選整合方式,再驗收事件
    1. 像素與伺服器,是不同的事件傳送路徑
  3. 平台內建、合作夥伴整合、自行開發怎麼選?
    1. 平台內建:先查商店自己的文件
    2. 合作夥伴整合:別把工具當成驗收結果
    3. 自行開發:適合需要掌握資料流程的商店
  4. 串接前先對齊事件、資產與責任
    1. 直接整合要先確認哪些準備?
    2. 資料能取得,不代表能直接分享
  5. 事件去重怎麼做?先看名稱,再看識別碼
    1. 瀏覽器與伺服器的欄位,名稱不完全相同
    2. 最容易忽略的是識別碼如何產生
    3. 去重也有時間與來源限制
  6. 測試事件怎麼驗?不要只截「收到事件」
    1. 瀏覽器事件與伺服器事件要分開確認
    2. 不要把測試動態與分析報告混為一談
  7. 驗收清單:診斷、覆蓋率與事件配對品質
    1. 覆蓋率、配對品質、去重,回答不同問題
    2. 事件配對品質該怎麼看?
  8. 串接正確,不等於廣告成效必然提升
    1. 要求廠商分開交付結論
  9. 常見問題
    1. 串接轉換 API 後,可以移除像素嗎?
    2. 後台收到事件,就代表串接正確嗎?
    3. event_id 相同,就一定能去重嗎?
    4. 事件配對品質高,就代表廣告一定賺錢嗎?
    5. 找不到產生存取權杖的連結,怎麼辦?

Meta 轉換 API 怎麼串?先選整合方式,再驗收事件

Meta 轉換 API 應先選整合方式,再驗證事件。官方的建置流程包含選方法、完成準備、實作與驗證。

對電商老闆來說,重點不是拿到「已串接」通知。你要知道資料從哪裡送出,以及如何確認正確。驗收也不能停在後台出現購買事件。

轉換 API 能連結伺服器、網站平台或 CRM 的行銷資料。資料可用於 Meta 的衡量、報告及最佳化。

像素與伺服器,是不同的事件傳送路徑

像素透過使用者瀏覽器傳送網站行為。轉換 API 則能由網站後台伺服器傳送資料。

可以把它理解成商店的不同回報管道。管道增加後,還得辨認哪些回報是相同動作。否則,你看到更多事件,也可能只是重複資料。

Meta 建議搭配使用像素與轉換 API。若共同傳送相同事件,就必須設定去重方法。

建議把委外需求寫成可驗收的問題:

  • 哪些商店行為會傳送給 Meta?
  • 哪些由瀏覽器送,哪些由伺服器送?
  • 相同動作如何共用識別碼?
  • 用什麼紀錄證明設定正確?
  • 上線後由誰處理異常?

若還不熟悉像素,可先閱讀FB Pixel 像素的功能與安裝方式。先理解資料路徑,再討論串接範圍。

平台內建、合作夥伴整合、自行開發怎麼選?

先確認現有商店系統提供什麼功能。不要還沒問平台,就直接另找工具重做。

官方指出,整合方法的投入、成本與功能各有差異。因此,選擇重點是適配需求,不是名稱聽起來多進階。

選擇方向先確認什麼要求提供的驗收內容
電商平台內建功能平台是否提供轉換 API 串接啟用範圍、事件清單、測試紀錄
合作夥伴整合網站與整合工具是否適配資料流向、參數對照、去重證據
自行開發直接整合是否有開發及維護資源傳送內容、事件識別邏輯、異常處理紀錄

這張表是採購與詢問廠商的框架。不要只問「能不能接」,也要問交付內容。

平台內建:先查商店自己的文件

WACA 文件提供像素編號與存取權杖設定方式;串接轉換 API 後,網頁事件記錄會直接從 WACA 伺服器傳送給 Meta。

SHOPLINE 則說明可透過商業擴充套件串接;已安裝套件的店家,可點選「更新權限」啟用轉換 API。

這些是各平台自己的整合方式。不應把不同平台的操作路徑混用。請廠商先確認適用文件,再提出施工範圍。

合作夥伴整合:別把工具當成驗收結果

合作夥伴整合可透過支援的平台或工具完成連接。

採用現成工具時,仍建議問清楚責任分工:

  • 誰負責網站端設定?
  • 誰負責檢查伺服器事件?
  • 去重異常由誰修正?
  • 商店功能變更後,由誰重新測試?

工具能協助連接,不代表責任自然有人承擔。合約最好列出交付證據,而不只列工具名稱。

自行開發:適合需要掌握資料流程的商店

直接整合會建立廣告主伺服器與 Meta 轉換 API 端點的連線。

如果選擇自行開發,應把維護也納入討論。不要只估初次串接的工作。請工程端說明事件如何形成、如何驗證與排錯。

串接前先對齊事件、資產與責任

正式施工前,先做事件規格表。老闆不用寫程式,但要確認商業動作的定義。

例如你想追蹤「購買」,就請廠商說清楚觸發時機。不要只在文件寫下事件名稱。名稱相同,不代表團隊對完成條件理解相同。

規格欄位請廠商填寫的內容
商店動作實際追蹤哪個行為
觸發條件什麼情況下產生事件
傳送來源瀏覽器、伺服器或共同傳送
事件名稱各來源使用的名稱
事件識別碼如何產生,以及如何共用
顧客資訊傳送哪些合法可用的資料
驗證方式用什麼測試與紀錄確認
維護責任異常通知及修正窗口

直接整合要先確認哪些準備?

官方列出的準備包括 Pixel ID、Meta Business Suite 與存取權杖。

若網站已設像素,瀏覽器與伺服器事件應使用相同 Pixel ID。

請廠商在交付文件寫明使用哪個資產。避免討論時只用「公司的像素」代稱。未來換窗口,也應能追溯設定對象。

資料能取得,不代表能直接分享

Meta 要求商家具備蒐集、使用及分享資料的合法權利。分享前也須取得必要同意。

聯絡資料須依開發文件進行雜湊處理。Meta 也禁止分享包含敏感資訊的資料。

因此,規格討論不能只剩「多傳資料」。也應請廠商說明資料來源與處理方式。涉及合規判斷時,再與法律顧問確認。

事件去重怎麼做?先看名稱,再看識別碼

去重要回答的問題是:這些回報是否來自相同動作?不要把「相同事件類型」誤當成「相同事件」。

官方建議以事件 ID 與事件名稱進行去重。

瀏覽器與伺服器的欄位,名稱不完全相同

核對項目瀏覽器像素轉換 API驗收依據
事件名稱eventevent_name對應事件名稱須一致,官方說明
事件識別碼eventIDevent_id對應識別碼須一致,官方說明

老闆不必背欄位拼法。你只要要求廠商展示對應事件的實際值。不要只接受「程式已加參數」這種回答。

event_id 是能唯一區分相似事件的識別碼。驗收時,既要檢查對應動作是否一致,也要檢查不同動作能否區分。

最容易忽略的是識別碼如何產生

前端與後端各自產生識別碼,可能造成值不一致。A7 的文章也將這類問題列為排錯重點。

建議直接問工程端:

  • 識別碼由哪裡產生?
  • 瀏覽器與伺服器如何取得相同值?
  • 不同交易如何避免誤用相同識別碼?
  • 如何提供對應事件的紀錄供核對?

不要只看測試畫面有沒有事件。識別邏輯若未說清楚,仍難判斷設定是否可靠。

去重也有時間與來源限制

相同識別碼的對應事件,須於首筆接收後 48 小時內送達,才會被去重。

官方也提供 fbp 或 external_id 的替代方法。該方法通常只適用於瀏覽器先送、伺服器後送的事件。

替代方法不處理僅有相同來源的重複事件。因此,別把跨來源去重當成所有重複問題的解法。

測試事件怎麼驗?不要只截「收到事件」

官方將驗證設定列為建置流程的一環。驗證內容包含接收、去重與正確配對。

建議要求廠商陪同測試實際商店動作。每個測試都留下條件、畫面與結果。這樣才能知道截圖證明的是哪段流程。

瀏覽器事件與伺服器事件要分開確認

像素的瀏覽器事件,可透過測試事件工具驗證接收。工具也能檢查已處理及已刪除重複的事件。

轉換 API 的伺服器事件,也應使用測試事件工具驗證,此工具可檢查伺服器事件裝載是否正確設定。

驗收紀錄建議包含:

  • 測試的商店動作與完成條件。
  • 對應的事件名稱與來源。
  • 瀏覽器及伺服器的識別碼。
  • 工具呈現的處理結果。
  • 異常原因及修正後的重測結果。

不要把測試動態與分析報告混為一談

網站測試動態只會在測試事件網頁開啟時記錄。

官方也說明,設定事件後,資料可能需 30 分鐘以上才顯示於分析,等待期間請使用測試事件工具驗證事件。

因此,驗收文件應寫明查看的是哪個畫面。不要把分析尚未更新,直接判定為事件未傳送。也不要因為測試有動態,就省略後續檢查。

驗收清單:診斷、覆蓋率與事件配對品質

收到事件,只回答了「資料是否抵達」。官方仍建議定期檢查去重、診斷、配對與更新間隔。

你可以把下表交給廠商填寫。每個項目都附上結果與證據。若有異常,請另列修正方式與負責窗口。

驗收項目核對問題可要求的交付證據
事件接收預定事件是否抵達?測試動作及接收紀錄
事件內容名稱與參數是否符合規格?規格表及傳送內容
跨來源去重對應事件能否正確辨認?欄位對照及處理結果
問題診斷是否存在待處理異常?診斷紀錄及修正說明
事件覆蓋率伺服器回報範圍如何?覆蓋率畫面及解讀
事件配對品質顧客資料是否有效?事件別分數及改善建議
資料更新間隔發生至接收的落差如何?更新間隔紀錄

覆蓋率、配對品質、去重,回答不同問題

事件覆蓋率用來比較 API 與不重複瀏覽器事件。官方建議將覆蓋率目標設為 75%。

事件配對品質則反映顧客資料的配對有效程度。它不是刪除重複事件的評分。

去重判斷的是回報是否對應相同事件。所以,不應拿配對品質分數取代去重驗證。

事件配對品質該怎麼看?

官方評分範圍是 0 至 10 分。計算使用最近 48 小時的資料。

適用對象是透過轉換 API 傳送、且動作來源參數設定為網站的網站事件。

電子郵件與點擊編號被列為高優先順序參數。手機、外部編號及瀏覽器編號則列為中等。

請廠商說明哪些資料可合法取得。再核對實際傳送內容及改善建議。不要為了追分,要求傳送不應分享的資訊。

Triple Whale 提醒,應重視完整且一致的轉換資料。不要只追求漂亮的配對品質分數。平台適用範圍與規則,仍以官方文件為準。

串接正確,不等於廣告成效必然提升

建議把技術驗收與營運評估分開。前者確認資料流程,後者判斷預算是否有效。不要用相同結論概括不同問題。

官方說明,伺服器事件可能用於衡量、報告或最佳化。這是工具用途,不是個別商店的成果承諾。

要求廠商分開交付結論

技術驗收報告建議回答:

  • 事件是否依規格傳送?
  • 對應事件是否完成去重?
  • 診斷異常是否已處理?
  • 還有哪些資料品質待改善?

營運觀察報告則建議回答:

  • 報表變化應如何解讀?
  • 是否與商店成交紀錄一起檢視?
  • 下一步要觀察什麼,而不是急著下結論?

資料檢查可延伸閱讀電商經營人的 GA4 報表健檢邏輯。討論預算效益時,也可搭配損益兩平 ROAS 與 POAS 的判讀文章。

最後,請廠商留下未解決事項。清楚知道哪些已驗證,哪些仍待觀察,比收到「全部正常」更有用。交接文件應讓後續負責人看得懂。

常見問題

串接轉換 API 後,可以移除像素嗎?

不建議為了串接 API 就直接移除像素。Meta 建議搭配使用;兩邊送出相同事件時,就必須設定去重方法。

請先確認目前事件規格。不要把新增回報管道,誤解成必須撤掉原有管道。

後台收到事件,就代表串接正確嗎?

不代表。官方建議的驗證步驟,除了確認 Meta 已收到事件,也要確認事件已去重並正確配對。

請要求完整測試紀錄。單張接收畫面不足以交代整個資料流程。

event_id 相同,就一定能去重嗎?

不一定,還須符合事件名稱與接收時間等條件。

驗收時應核對對應來源的完整欄位。不要只挑識別碼相同的畫面作為結論。

事件配對品質高,就代表廣告一定賺錢嗎?

不代表,它評估的是顧客資料的配對有效程度。

技術資料品質與營運成果應分開檢視。不要把配對分數當成獲利報告。

找不到產生存取權杖的連結,怎麼辦?

先確認帳號是否具備商家的開發人員權限。官方說明該連結只對具備此權限者顯示。

請商家管理員與串接廠商共同確認。不要只反覆更換操作路徑,卻未釐清權限。

想讓廣告預算花得更有效率?歡迎聯絡阿提拉有限公司。帶著現有串接方式、事件規格與驗收紀錄,一起釐清資料問題與後續投放方向。

更多精選文章

搜尋更多優質好文

更多精選文章

本周熱門文章