轉換 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 傳送相同的事件，則需要針對同時透過這兩個管道傳送的事件設定刪除重複事件。首先，請參閱開發人員文件，以瞭解刪除重複事件的邏輯。

刪除重複的事件

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

為了協助確保您的重複事件已刪除，請執行以下操作：

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

  • 伺服器事件的 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 服務介面：覆寫商業 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