전환 API

페이로드 사양

Meta의 전환 API와 CRM 통합 및 잠재 고객용 광고 사용 - 전환 잠재 고객 최적화 목표는 더 높은 품질의 결과를 얻을 수 있습니다. 현재 이 최적화는 Facebook이나 Instagram에서 생성된 네이티브 잠재 고객용 광고(인스턴트 양식)만 지원합니다.

이 가이드에서는 전환 잠재 고객 최적화를 위해서만 업로드된 CRM의 페이로드 사양을 제공합니다. 이 사양을 이 최적화와 관련이 없는 이벤트에 사용하지 마세요.

API와 다른 유용한 참고 자료로 시작하는 방법에 대한 자세한 내용은 전환 API 문서를 참조하세요.

이벤트 페이로드

매개변수

이름설명

lead_id

정수

필수 항목
모든 잠재 고객에 대해 Facebook에서 생성한 ID입니다. 이는 잠재 고객 확보 Webhooks의 leadgen_id 필드에서 얻어서user_data 매개변수에 포함된 15~16자리 숫자입니다. 자세한 내용은 잠재 고객 ID 찾기를 참조하세요.
매칭에는 고객 정보 대신 잠재 고객 ID를 사용해야 합니다. 변수를 사용하여 CRM에서 ID 값을 전달하세요.
참고: 해시하지 마세요.

event_name

문자열

필수 항목
CRM 내에서 사용하는 단계를 캡처하기 위한 자유 형식 필드입니다.
최초 잠재 고객 단계를 포함하여 업데이트되는 모든 단계를 전송하세요.
예를 들어, 단계에는 다음의 유형이 포함될 수 있습니다. 잠재 고객이 최종 '전환됨' 단계에 도달할 경우, 이전의 모든 단계가 그 전에 전송되었어야 합니다.

  1. Facebook의 초기 잠재 고객
  2. 마케팅 자격을 갖춘 잠재 고객
  3. 영업 기회
  4. 전환됨

변수를 사용하여 CRM에서 단계를 전달하세요. 또는 각 단계에 대해 별도의 API 호출을 생성할 수도 있습니다.

event_time

정수

필수 항목.
CRM에서 잠재 고객 단계 업데이트 이벤트를 업데이트한 시점을 나타내는 Unix 타임스탬프입니다(단위: 초).
변수를 사용하여 데이터베이스에서 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"
    }
}

더 알아보기