這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:今天
中文(香港) 更新時間:2023年6月23日

最佳作法 - 轉換 API

使用這些最佳作法做為一般建議,以成功整合轉換 API。這些建議旨在協助您最有效地使用轉換 API。請遵循實作方式後期實作方式建議,以確保在與 Meta 分享資料時能夠順利整合並獲得最佳結果。

除了下列最佳作法之外,也建議您觀看這部影片,瞭解實際操作轉換 API 的教學導覽。這部影片會逐步指引您如何:

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

實作方式

設定行銷活動時,請簡化帳號架構並使用下列已建立的行銷活動最佳作法:

設定備援事件

建議您,除了 Meta 像素之外,還可使用轉換 API,將這兩種工具並用以分享相同的事件。我們將此作法稱為備援事件設定。例如,如果您使用 Meta 像素分享 PurchaseInitiate CheckoutContact 事件,也應使用轉換 API 從伺服器分享這些相同的事件。

轉換 API 可讓您分享因網路連線問題或頁面載入錯誤而導致像素可能遺失的網站事件。轉換 API 還可用於分享其他類型的重要事件和資料,這些事件和資料發生在離線或之後像素無法分享的時候。

確認可以刪除備援事件的重複項目

使用 Meta 像素和轉換 API 傳送備援事件時,請確認兩個事件皆使用相同的 event_name,並包含 event_id,或是 external_idfbp 的組合。建議您包含所有這些參數,以協助 Meta 正確刪除重複事件,並減少對相同事件的重複分析報告。深入瞭解刪除重複項目及其使用時機和設定方式。

傳送必要和建議的參數

下列伺服器事件顧客資訊參數皆為必要:

參數類型必要時機

action_source

伺服器事件

所有事件

event_source_url

伺服器事件

所有網站事件

client_user_agent

顧客資訊

所有網站事件

使用轉換 API,即表示您同意 action_source 參數就您所知是正確的。同時也建議您為所有事件加入 external_idevent_id 事件參數。

傳送其他顧客資訊參數可能有助於提升事件配對品質。只有相符的事件才能用於廣告歸因和廣告投遞最佳化,配對品質越高越好。雖然不相符的事件不可用於歸因或廣告投遞最佳化,但仍可用於基本成效衡量。高品質的顧客資訊參數範例包括:

  • 電子郵件地址(em
  • IP 位址(client_ip_address
  • 名稱(fnln
  • 電話號碼(ph

配對的基本要求

圖形 API 13.0 版發佈後,我們將會更新基本要求,指出哪些是視為對轉換 API 事件有效的顧客資訊參數組合。這些變更有助於我們在事件包含的顧客資訊參數組合如此廣泛,以至於無法有效配對時,提供更好的意見回饋。

如果事件僅包含由以下任一組合(或其子集)組成的顧客資訊參數,則該事件視為無效。

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

例如,如果事件只有顧客資訊參數 gectstcountry(此組合可能對應於男性、位在 Menlo Park、加州、美國),可能會遭到拒絕,因為這些顧客資訊參數是上述組合之一的子集。

確認 fbpfbc 參數已重新整理

fbpfbc 參數為 Cookie 值,通常設定在與 Meta 的第一方 Cookie 解決方案相關的網站訪客瀏覽器上,且可能會變更。如果您將其做為用戶參數傳送,則應定期重新整理其值。

當 Meta 像素實作在您的網站上,並可供擷取用於轉換 API 要求時,這些值將會設為第一方 Cookie。

以接近即時的方式分享事件

在事件發生時分享事件有助於行銷活動達到最佳成果。您可以使用轉換 API 即時分享或接近即時批次分享伺服器事件。

使用測試事件

建議您使用「測試事件」工具驗證轉換 API 連線。通常,開發人員應使用自己的顧客資訊參數(例如名稱、電子郵件地址、電話號碼)提供給測試事件,因為如果這些事件與 Facebook 或 Meta 帳號不符,可能會遭到捨棄。

您可以使用「測試事件」工具來執行下列作業:

  • 確認您已正確設定伺服器事件,且我們已收到那些事件。
  • 查看哪些事件已處理並刪除重複事件,以確認您已正確刪除重複事件。
  • 針對任何異常活動進行偵錯。

瞭解如何使用「測試事件」工具測試伺服器事件。

使用承載協助工具

請在承載協助工具中填入所有必要和建議的資料參數欄位,以瞭解應如何建構承載,並取得應加入哪些參數的建議。

使用我們的 Business SDK

我們文件中的程式碼範例包括使用 Python、Java、Ruby、PHP 和節點的 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 廣告策略。部分測試選項包括:

  • 轉換提升研究:瞭解使用伺服器事件對成效增幅的影響。

  • 分組測試:瞭解哪個行銷活動策略可達到最佳且最有效的結果來最佳化成效。