轉換 API 端對端執行

轉換 API 可以協助廣告客戶為消費者帶來合宜的資料透明度和控制權，同時繼續提供個人化體驗。透過這個 API，您可以直接從伺服器（而非瀏覽器）分享資料。

整合的好處

• 深入查看漏斗：比起 Meta 像素，轉換 API 可讓您分享更廣泛的資料。透過這個 API，您可以將更多資訊納入考量來作出決定，例如 CRM 資料、下層漏斗事件（包括合資格的潛在顧客），以及網站和實體店面的多站轉換路徑。

• 資料控管：透過僅限伺服器執行方式使用時（例如不使用 Meta 像素），轉換 API 可以讓您對分享的資料握有更大的控制權。您可以選擇為事件附上洞察報告，以便提供產品利潤或歷來資訊（如顧客價值分數）等資料。

• 訊號可靠性和韌性：透過轉換 API 分享資料的方式，可能比只使用瀏覽器導向方法（例如 Meta 像素）更可靠。此 API 遇到瀏覽器當機或連線出狀況等問題的機率較小。新的業界資料傳輸限制可能會導致 Cookie 和像素追蹤的效益降低，因此轉換 API 有助於您對分享像素可能無法再擷取到的訊號握有控制權。

概覽

您可以將轉換 API 的整合視為包含兩個主要階段：

• 準備階段：選擇適合您的整合類型、定義要傳送的事件，以及查看適用的優化選項。

• 執行：了解如何執行 API。在此階段，您也可以使用合作夥伴整合。

以下是整個整合流程的概覽：

現有像素用戶

如果您已有 Meta 像素整合，轉換 API 整合就必須以像素整合延伸（而非截然不同的連線）的形式來建立。

一般同意聲明

如果您在分享像素資料方面對控制同意聲明有自己的一套邏輯，透過轉換 API 分享資料時也必須使用同一套邏輯。

替代方案

• 如果您想針對應用程式事件優化廣告，請使用應用程式事件 API。

準備工作

選擇整合類型

首先，選擇您想執行的整合選項：

定義要傳送的事件

選定整合做法後，您可以定義要傳送的事件。訊號在與 Meta 用戶編號完成配對的情況下最實用，因此請務必徹底想一想您要將哪些參數與事件一併傳送給我們，以及您希望的傳送頻率。

事件選項

傳送與您企業最相關的事件。查看受支援的標準和自訂 Meta 事件的完整清單。

事件參數

您可以在每個事件內傳送多個參數。若要進一步了解這些欄位，請查看轉換 API 使用的參數。

您可以將多種編號加到事件，包括 event_id、external_id 和 order_id。了解這些參數之間的差別非常重要：

資料更新間隔

我們建議您透過轉換 API，即時傳送或根據特定時間表分批傳送事件。即時或在 1 小時內傳送事件，可確保讓事件用於歸因分析並針對廣告刊登優化。

如果在事件發生 2 小時後才傳送，則針對這些事件優化的廣告成效可能就會大幅降低。經過 24 小時或更長時間之後才傳送的事件，在歸因分析和廣告刊登優化時可能會遇到重大問題。

如果您要傳送轉換期間較長的事件，請儘量在整個轉換完成當刻立即傳送。

做好以下準備後，請繼續下一步：

• 待傳送事件的清單。
• 您要與每個事件一併傳送的特定欄位。
• 定義好事件的傳送頻率。

可用的優化類型

轉換 API 提供下列優化類型：

執行

執行整合的方式有兩種：

• 直接整合：身為廣告客戶的您直接執行轉換 API。
• 以平台形式整合：身為營銷合作夥伴的您將轉換 API 作為服務提供給客戶。

直接整合

第 1 步：設定條件

使用轉換 API 前，請設定下列資產：

準備好資產後，請繼續前往執行 API。請記得儲存資產的編號，以便在呼叫 API 時使用。

第 2 步：執行 API

達成上述條件後，即可開始執行程序。使用轉換 API 作為基礎時，請記得查看開發人員文件。

測試呼叫（選用步驟）

如果這是您第一次使用 API，請先以測試呼叫開始。要做到這一點，您需要有裝載和方法來呼叫 API。呼叫完成後，請前往事件管理工具確認呼叫如常運作。

{
  "data": [
   {
    "event_name": "Purchase",
    "event_time": 1601673450,
    "user_data": {
      "em": "7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068",
      "ph": null
     },
    "custom_data": {
      "currency": "USD",
      "value": "142.52"
    }
   }
  ]
}

{
  "events_received": 1,
  "messages": [],
  "fbtrace_id": <FB-TRACE-ID>
}

完成第一次呼叫後，請前往事件管理工具 > 您的像素 > 概覽驗證事件。

在事件管理工具中檢查測試事件後，請繼續前往傳送並驗證事件。

傳送並驗證事件

若要開始傳送事件，請向 API 的 /events 關係連線發出 POST 要求。將裝載附在呼叫上（若要了解如何產生裝載，請前往裝載協助工具）。如需更多資訊和程式碼範例，請瀏覽以下資源：

• 使用 API > 傳送要求
• 棄置事件
• 上載時間與事件交易時間之比較
• 批量要求
• 雜湊

開始傳送事件後，請前往事件管理工具確認我們已收到您傳送的事件。了解如何驗證您的事件。

如果您的執行方式與瀏覽器像素互補，請繼續前往刪除重複項目設定。如果不是的話，一切現已準備就緒！如果還有疑問，請聯絡支援團隊。

第 3 步：新增參數以刪除重複項目

如果您要透過像素和轉換 API 傳送相同事件，便需透過這兩個渠道為事件設定刪除重複項目的功能。首先，請參閱開發人員文件來了解刪除重複項目功能的運作方式。

根據事件刪除重複項目

如果我們發現在 48 小時內有相同的伺服器金鑰組合（event_id、event_name）和瀏覽器金鑰組合（eventID、event）傳送到相同的像素編號，就會捨棄之後才傳送的重複事件。

若要進一步確保重複事件皆已刪除：

• 對於相應事件，請確認下列參數已設為相同的值：

  • event_id（來自伺服器事件）和 eventID（來自瀏覽器事件）
  • event_name（來自伺服器和瀏覽器事件）
• 傳送重複事件後，請前往事件管理工具確認要棄置的事件是否正確。
• 確認每個同時透過像素和轉換 API 傳送的不重複事件都有自己的 event_id。這個編號不應與其他事件共用。

根據事件刪除重複項目的替代方案

雖然事件編號總是刪除重複事件的最佳方法，但在執行方面卻很複雜。您可以使用 external_id 或 fbp 參數作為替代解決方案。如果您已將 external_id 或 fbp 參數設為同時透過瀏覽器和伺服器傳遞，且我們在 48 小時內發現擁有相同 external_id 或 fbp 參數的同一個事件，就會自動刪除重複的事件。

第 4 步（選用步驟）：探索 Business SDK 功能

Meta Business SDK 提供了專為轉換 API 用戶所設計的進階功能：

• 非同步要求：如果您不想阻止程式執行來等待要求完成，就可以使用這項功能。透過這種做法，您可以提出要求，並在要求完成後取得伺服器回傳的訊號。在您等候回應時，程式可以繼續執行。
• 同時批量處理：有效利用資源，善用非同步要求來提高輸送量。建立分批要求，以便支援事件要求工作線程和排程工作等使用案例。
• HTTP 服務介面：覆寫 Business SDK 的預設 HTTP 服務，並使用您偏好的方法或資料庫來執行自訂服務。

以平台形式整合

以下指示適用於將轉換 API 作為服務提供給廣告客戶的合作夥伴。

第 1 步：設定條件

您的應用程式應取得下列功能和權限：

• 存取權級別：進階存取權限
• 功能：廣告管理一般存取權限
• 權限：ads_management、pages_read_engagement 和 ads_read。

第 2 步：代替客戶傳送事件

首先，依照直接整合步驟測試整合。接著，您可以要求代替客戶傳送事件的授權。您會看到以下驗證選項：

Meta Business 擴充功能方法（建議選項）

Meta Business 擴充功能會透過下列程序，傳回代替客戶傳送事件所需的一切必要資訊。Meta Business 擴充功能會提供端點來檢索客戶企業管理平台所建立的系統用戶存取憑證。這個程序包含傳送伺服器事件的權限，且會自動透過安全的方式完成。

端點需要用戶存取憑證作為輸入參數。如果是第一次使用 Meta Business 擴充功能，請在設定 Meta Business 擴充功能後呼叫此端點來擷取系統用戶存取憑證。現有用戶需要先要求重新驗證，再呼叫新的 API 端點。

客戶系統用戶存取憑證

請客戶在「像素設定」內透過轉換 API 手動建立系統用戶存取憑證。接著，使用該憑證傳送事件到廣告客戶的像素。

系統用戶或管理員系統用戶必須安裝用來產生存取憑證的應用程式。使用這項設定後，您的應用程式便可代替此系統用戶或管理員系統用戶呼叫 API。

客戶分享像素到合作夥伴的企業管理平台

透過這個選項，客戶會透過企業管理平台設定或透過 API 分享像素給合作夥伴，之後您就可以將合作夥伴系統用戶指派給客戶像素，並產生存取憑證來傳送伺服器事件。

第 3 步：將事件歸因給平台

若要將轉換 API 歸因給您的平台，請使用 partner_agent 欄位。這樣，您就能在代替客戶傳送事件時，自行設定平台識別碼。如果您是受管控的合作夥伴，請與 Meta 業務代表一同議定您平台的識別碼。此值的格式應符合以下要求：長度不得超過 23 個字元，且必須包含最少兩個英數字元。接著，請與每個伺服器事件一併傳送該值。

支援

所有合作夥伴

了解如何除錯並查看企業商家幫助中心文章。

受管控的合作夥伴

請向您的 Meta 業務代表提供下列資訊，讓他們能協助您測試整合並解決問題：企業管理平台編號、應用程式編號、像素編號。

API 文件

• 新手指南：透過您的企業管理平台測試 API
• 使用 API
• 最佳操作實例：轉換 API
• 設定轉換 API 作為平台
• 標準 Meta 事件
• 自訂 Meta 事件
• 參數
• 裝載協助工具
• 轉換 API 和離線轉換 API 的資料處理選項
• 如果您想針對應用程式事件進行優化，請使用應用程式事件 API
• 如果事件是店內銷量，請使用離線轉換 API：店內銷量以外的事件符合資格使用轉換 API