轉換 API

最佳操作實例—轉換 API

您可以將這些最佳操作實例用作一般建議，助自己成功整合轉換 API。這些建議旨在幫助您最有效地使用轉換 API。按執行及執行後建議操作，確保在與 Meta 分享資料時順利整合和優化結果。

除了以下最佳操作實例以外，我們還建議您觀看此影片的實踐教學，了解如何使用轉換 API。此影片將指導您執行以下動作：

使用轉換 API 分享的網站、應用程式和實體商店事件需要使用特定參數。此處載有所需參數的清單。

落實執行

設定宣傳活動時，簡化帳戶結構，並使用以下既定宣傳活動最佳操作實例：

設定冗餘事件

除了 Meta 像素之外，我們還建議您使用轉換 API，並使用這兩種工具分享相同的事件。我們將之稱為冗餘事件設定。例如，在使用 Meta 像素分享 Purchase、Initiate Checkout 和 Contact 事件時，您還應使用轉換 API 從伺服器分享這些相同的事件。

一些網站事件透過像素分享時，可能會因網絡連接問題或頁面載入錯誤而遺失，此時您便可使用轉換 API 分享這些事件。此外，部分其他類型的重要事件和資料會在離線時出現，或在之後無法使用像素時出現，您亦可使用轉換 API 分享這些內容。

確保可刪除重複的冗餘事件

使用 Meta 像素和轉換 API 傳送冗餘事件時，請確保兩個事件都使用相同的 event_name，並且包括 event_id 或者 external_id 和 fbp 的組合。我們建議包括所有這些參數，以幫助 Meta 恰當刪除重複事件和減少相同事件的重複報告。進一步了解有關刪除重複事件的資訊、何時需要刪除以及如何設定。

傳送必要參數和建議參數

以下伺服器事件和顧客資訊參數為必要項目：

參數類型何時為必要項目

action_source

伺服器事件

全部事件

event_source_url

伺服器事件

全部網站事件

client_user_agent

顧客資訊

全部網站事件

使用轉換 API，即表示您同意 action_source 參數據您所知正確無誤。我們亦建議包括所有事件的 external_id 和 event_id 事件參數。

傳送額外顧客資訊參數可能有助於提高事件配對品質。只有已配對的事件才能用於廣告歸因和優化廣告刊登，配對品質越高，效果越好。雖然未配對的事件不能用於歸因或優化廣告刊登，但仍可用於衡量基本成效。高品質顧客資訊參數的範例包括：

  • 電郵地址（em）
  • IP 位址（client_ip_address）
  • 姓名（fn 和 ln）
  • 手機號碼（ph）

配對基本條件

隨著 Graph API 13.0 版本的發佈，我們將會更新基本條件，以便確定被視為對轉換 API 事件有效的顧客資訊參數組合。如果某個事件的顧客資訊參數組合太過廣泛，以至無法進行有效配對，這些變更便有助我們提供更有效的意見。

如果某個事件僅包含由以下其中一種組合（或其子集）構成的顧客資訊參數，則將視為無效。

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

例如，如果某個事件僅包含顧客資訊參數 ge、ct、st 與 country（可對應為美國加州門洛公園的一名男子），此事件將會遭拒，因為該等顧客資訊參數是以上其中一種組合的子集。

確保已重新整理 fbp 和 fbc 參數

fbp 和 fbc 參數是 Cookie 值，通常設於網站訪客的瀏覽器中，並連接至 Meta 的第一方 Cookie 解決方案，而且可能會有所更改。如果將其作為用戶參數傳送，您應定期更新該值。

如果 Meta 像素已在您的網站上執行，而且可供檢索以用於轉換 API 要求，這些值將被設為第一方 Cookie。

以近乎即時的速度分享事件

在發生事件時將之分享，有助您在宣傳活動中取得最佳效果。您可以使用轉換 API 即時分享伺服器事件，或以近乎即時的速度分批分享伺服器事件。

使用測試事件

我們建議使用測試事件工具驗證轉換 API 的連線狀態。開發人員通常應該使用其顧客資訊參數（例如姓名、電郵地址、手機號碼）來測試事件。因為如果系統無法將這些事件配對至任何 Facebook 或 Meta 帳戶，便會將之捨棄。

測試事件工具可用於：

  • 驗證您是否已正確設定伺服器事件，以及我們是否已接收這些事件。
  • 透過查看已處理和已刪除重複版本的事件，驗證是否已正確刪除重複事件。
  • 為任何異常活動偵錯。

了解如何使用測試事件工具測試伺服器事件。

使用裝載協助工具

在裝載協助工具中填寫必要和建議的資料參數欄位，以查看構建裝載的方式，以及了解建議加入哪些參數。

使用 Business SDK

我們文件中的代碼範例包括 Python、Java、Ruby、PHP 和 Node 中的 Business SDK 範例。這些範例可以省卻一些開發工作，例如雜湊用戶參數（可在 Business SDK 中自動完成）。

如果您不打算使用 Business SDK，則我們建議您執行雜湊處理。

針對離線事件使用轉換 API

轉換 API 支援所有離線事件，而且應該用作這類事件的綜合容器。此類離線事件的例子包括實體店的店內銷量、來電、在智能電視或遊戲主機等裝置上執行的動作，以及離線訂閱。

傳送離線事件時，請確保包括 action_source 事件參數並選擇適當的值，其不應為 website。系統需要透過用戶操作來源來確定事件適用於哪項宣傳活動目標。

使用轉換 API，即表示您同意 action_source 參數據您所知正確無誤。

合作夥伴可參考的其他最佳操作實例

代理商：傳送 partner_agent 字串

代廣告客戶分享事件的合作夥伴或代理商應傳送不重複的 partner_agent 字串，並在當中加入記錄在案的平台名稱。請與您的 Meta 代表一同決定合適的代理商字串（如適用）。

網站平台：協助廣告客戶開始使用

在預設情況下，網站平台合作夥伴可考慮是否選擇性提供轉換 API，或者讓廣告客戶自行選擇。Meta 像素和轉換 API 使用相同的商業條款，我們建議您讓顧客自行選擇是否在設定 Meta 像素時也使用轉換 API 分享他們的資料。雖然我們相信使用這兩種工具能夠長期加強和確保資料分享的安全性，但仍建議您向顧客提供有關轉換 API 和 Meta 像素的資訊，以協助他們作出明智選擇。

執行後

檢查事件配對品質

如果您使用轉換 API 分享伺服器事件，便可以在事件管理工具中查看每個事件的事件配對品質（EMQ）。事件的 EMQ 分數滿分為 10 分，用以表示伺服器事件的顧客資訊在與 Facebook 或 Meta 帳戶配對時的成效。請在此進一步了解 EMQ 的最佳操作實例。

事件配對品質目前僅適用於網站事件。至於離線和實體商店事件、應用程式事件、採取轉換動作的潛在顧客，或任何正處內部或公開測試階段的整合方面，請聯絡 Meta 代表以了解如何提升事件配對品質。

進行測試

使用轉換 API 時，我們建議您測試並優化 Meta 廣告策略。部分測試選項包括：

  • 轉換提升研究：了解使用伺服器事件對廣告成效的提升效果。

  • 分組測試：了解哪種宣傳活動策略可取得最佳和最有效率的成效優化效果。

了解詳情