承載規格

將您的 CRM 與 Meta 的轉換 API 整合，並使用「名單型廣告 - 採取轉換動作的潛在顧客」最佳化目標，可產生更高品質的成果。目前，此最佳化僅支援在 Facebook 或 Instagram 上產生的原生名單型廣告（即時表單）。

本指南提供的承載規格僅適用於為了「採取轉換動作的潛在顧客」最佳化而上傳的 CRM 事件。請勿將此規格用於無關此最佳化的事件。

如需有關開始使用 API 的詳細資訊和其他實用資源，請參閱轉換 API 說明文件。

事件承載

參數

名稱	說明
`lead_id` 整數	必要項目。 Facebook 會為每個潛在顧客產生編號。此編號為 15 或 16 碼數字，擷取自開發潛在顧客 Webhook 中的 `leadgen_id` 欄位，並包含在 `user_data` 參數之下。如需更多資訊，請參閱尋找潛在顧客編號。進行配對時，需要使用潛在顧客編號，而不是顧客資訊。請使用變數從您的 CRM 傳入編號值。注意：請勿進行雜湊處理。
`event_name` 字串	必要項目。自由格式欄位，可用來擷取您在 CRM 中使用的階段。請務必傳送已更新的所有階段，包括初始潛在顧客階段。例如，您的階段可能包括以下類型。如果潛在顧客到達最後的「已轉換」階段，則先前的所有階段都應已預先傳送。 Facebook 提供的初始潛在顧客符合行銷資格的潛在顧客銷售機會已轉換請使用變數從您的 CRM 傳入各個階段。或者，您可以為每個階段建立個別的 API 呼叫。
`event_time` 整數	必要項目。 Unix 時間戳記（以秒為單位），指示 CRM 更新潛在顧客階段更新事件的時間。請使用變數從資料庫傳入 Unix 時間戳記值。注意：`event_time` 參數值可以是您將事件傳送到 Meta 之前最多 7 天。此外，時間戳記必須出現在開發潛在顧客時間之後，否則該事件可能會被捨棄。
`action_source` 字串	必要項目。請針對所有「採取轉換動作的潛在顧客」事件，將此參數設定為 `system_generated` 這個值。對於「採取轉換動作的潛在顧客」整合工具，這會指定系統產生轉換的位置。
`lead_event_source` 字串	必要項目。將此參數設定為產生潛在顧客的工具名稱（例如 Hubspot、SAP、Oracle、Dynamics、內部 CRM 等），包含在 `custom_data` 參數之下。
`event_source` 字串	必要項目。請針對所有「採取轉換動作的潛在顧客」事件，將此參數設定為 `crm` 這個值。對於「採取轉換動作的潛在顧客」整合工具，這會在 `custom_data` 參數之下將事件來源指定為您的 CRM。

範例

此範例說明在 API 呼叫中傳送之事件承載的格式。

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

瞭解詳情

企業商家使用說明：為採取轉換動作的潛在顧客設定 CRM
企業商家使用說明：關於名單型廣告投遞最佳化