event_name문자열 | 필수 항목.
표준 이벤트 또는 맞춤 이벤트 이름. 이 필드는 웹(Meta 픽셀 사용) 또는 앱(SDK 또는 앱 이벤트 API 사용)과 전환 API에서 보낸 이벤트에서 중복을 제거하는 데 사용합니다. event_id 매개변수도 중복을 제거하는 데 사용합니다.
동일한 고객 행동의 경우 브라우저 또는 앱 이벤트의 event는 서버 이벤트의 event_name과 일치합니다. 전송 간격이 48시간 이내인 이벤트 사이에서 일치를 발견할 경우 첫 번째 것만 고려합니다. 서버와 브라우저/앱 이벤트가 거의 동시에(즉, 5분 이내의 간격으로) 도착할 경우 브라우저/앱 이벤트를 우선합니다. 픽셀 및 서버 이벤트의 중복 제거에 대해 자세히 알아보세요. |
event_time정수 | 필수 항목.
실제 이벤트가 발생한 시점을 나타내는 Unix 타임스탬프(초). 지정된 시간은 Facebook에 이벤트를 전송하는 시간보다 이를 수 있습니다. 이는 일괄 처리 및 서버 성능 최적화를 위해서입니다. 이 날짜는 GMT 시간대를 기준으로 전송해야 합니다.
event_time은 Facebook에 이벤트를 전송하는 시점에서 최대 7일까지 가능합니다. data에 최근 7일보다 이전인 event_time이 있을 경우 전체 요청에 대해 오류가 반환되고 이벤트가 처리되지 않습니다.
|
user_data개체 | 필수 항목.
고객 정보 데이터가 포함된 지도. 옵션은 고객 정보 매개변수를 참조하세요. Meta 픽셀을 통해 전송된 데이터에 대해 사용 가능한 유사한 옵션은 고급 매칭을 참조하세요. |
custom_data개체 | 선택 항목.
이벤트에 대한 추가적 비즈니스 데이터가 포함된 지도. 자세한 내용은 맞춤 데이터 매개변수를 참조하세요. |
event_source_url문자열 | 선택 항목.
이벤트가 발생한 브라우저 URL. URL이 인증된 도메인과 일치해야 합니다.
참고: 전환 API를 사용하여 공유된 웹사이트 이벤트에는 event_source_url이 필요합니다. |
opt_out부울 | 선택 항목.
이 이벤트를 광고 전송 최적화에 사용하지 말아야 한다는 것을 나타내는 플래그. true로 설정할 경우 기여에 대해서만 해당 이벤트를 사용합니다. |
event_id문자열 | 선택 항목.
이 ID는 광고주가 선택한 모든 고유 문자열일 수 있습니다. event_id 및 event_name 매개변수는 웹(Meta 픽셀 사용) 또는 앱(SDK 또는 앱 이벤트 API 사용)과 전환 API에서 보낸 이벤트에서 중복을 제거하는 데 사용합니다. event_id가 선택 항목으로 표시되기는 했지만 이벤트 중복 제거에 사용하는 것이 좋습니다.
중복을 제거하려면 브라우저 또는 앱 이벤트의 eventID가 해당 서버 이벤트의 event_id와 일치해야 합니다. 중복 픽셀 및 전환 API 이벤트 처리에 대해 자세히 알아보세요.
주문 번호 또는 거래 ID는 event_id에 사용할 수 있는 두 가지 잠재적 식별자입니다. 예를 들어 고객이 주문 번호 123과 456으로 웹사이트에서 두 번 구매할 경우 각 전환 API 호출에 event_id에 대한 각각의 주문 번호를 포함해야 합니다. 이렇게 하면 두 개의 구매 이벤트를 각각의 주문으로 적절히 구분할 수 있습니다. 또한 두 개의 해당 브라우저 픽셀 구매 이벤트는 eventID 매개변수에서 동일한 주문 번호를 전송해야 Facebook에서 네 개의 고유한 구매가 아니라 두 개의 이벤트만 발생한 것을 확인할 수 있습니다.
내부 ID 번호가 없는 다른 이벤트의 경우 무작위 번호(동일한 무작위 번호를 브라우저와 서버 이벤트 사이에 전송하는 경우에만 해당)를 사용할 수 있습니다. |
action_source문자열 | 필수 항목.
이 필드에서는 전환이 발생한 위치를 지정할 수 있습니다. 이벤트가 발생한 곳이 어디인지 알면 광고를 적절한 사용자에게 노출하는 데 도움이 됩니다. 전환 API를 사용하면 본인이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하게 됩니다.
action_source 필드에서 보낼 수 있는 값은 다음과 같습니다.
email — 전환이 메일에서 발생했습니다.
website — 전환이 웹사이트에서 발생했습니다.
app — 전환이 모바일 앱에서 발생했습니다.
phone_call — 전환이 전화에서 발생했습니다.
chat — 전환이 메시지 앱, SMS 또는 온라인 메시지 기능을 통해 발생했습니다.
physical_store — 전환이 오프라인 매장에서 직접 발생했습니다.
system_generated — 전환이 자동으로 발생했습니다(예: 매월 자동 결제에 설정된 구독 갱신).
business_messaging — 전환이 Messenger, Instagram 또는 WhatsApp 연결 광고에서 발생했습니다.
other — 전환이 나열되지 않는 방식으로 발생했습니다.
참고: 모든 행동 출처 값은 광고 측정 및 맞춤 타겟 생성 기능을 지원합니다. physical_store를 제외한 모든 행동 출처는 광고 최적화 기능을 지원합니다. |
data_processing_options배열 | 선택 항목.
특정 이벤트에 대해 활성화하고자 하는 처리 옵션. 현재 허용되는 값은 제한된 데이터 사용을 나타내는 LDU입니다. 빈 배열을 전송하여 이 이벤트에 대해 '제한된 데이터 사용' 제한을 적용하여 처리해서는 안 된다는 사항을 명시적으로 지정할 수 있습니다. 데이터 처리 옵션에 대해 자세히 알아보세요. 전환 API 구현의 예시를 참조하세요. |
data_processing_options_country정수 | 필수 항목(data_processing_options에서 LDU를 전송하는 경우).
이 데이터 처리 옵션과 연결하고자 하는 국가. 현재 허용되는 값은 미국의 경우 1, 해당 이벤트의 위치를 확인하도록 요청하는 경우 0입니다. 데이터 처리 옵션에 대해 자세히 알아보세요. 전환 API 구현의 예시를 참조하세요. |
data_processing_options_state정수 | 필수 항목(경우에 따라). (자세한 내용은 아래의 내용을 참조하세요.)
이 데이터 처리 옵션에 연결하고자 하는 주. 현재 허용되는 값은 캘리포니아주의 경우 1000, 해당 이벤트의 위치를 요청하는 경우 0입니다.
참고: 데이터 처리 옵션에 대해 자세히 알아보세요. 전환 API 구현의 예시를 참조하세요. |
app_data
개체 | 앱 이벤트에 필수 앱 데이터와 기기 정보를 전환 API에 공유하기 위한 매개변수. extinfo는 app_data의 하위 매개변수입니다.
|
extinfo
개체 | 앱 이벤트에 필수
확장된 기기 정보(예: 화면 너비와 높이). 이 매개변수는 배열이고 값은 쉼표로 구분됩니다. extinfo를 사용할 때는 모든 값이 필수 항목이고 아래에 색인 생성된 순서를 지켜야 합니다. 값이 없는 경우 빈 문자열을 자리 표시자로 채우세요.
참고:
Android의 경우 version은 a2여야 합니다. iOS의 경우 version은 i2여야 합니다.
|
0
문자열 | 필수 항목 extinfo 버전
예: i2 |
1
문자열 | 앱 패키지 이름
예: com.facebook.sdk.samples.hellofacebook |
2
문자열 | 짧은 버전(정수 또는 문자열)
예: 1.0 |
3
문자열 | 긴 버전
예: 1.0 long |
4
문자열 | 필수 항목 OS 버전
예: 13.4.1 |
5
문자열 | 기기 모델명
예: iPhone5,1 |
6
문자열 | 로캘
예: En_US |
7
문자열 | 시간대 약어
예: PDT |
8
문자열 | 이동통신사
예: AT&T |
9
int64 | 화면 너비
예: 320 |
10
int64 | 화면 높이
예: 568 |
11
문자열 | 화면 밀도
예: 2 |
12
int64 | CPU 코어
예: 2 |
13
int64 | 외장 스토리지 용량(GB)
예: 13 |
14
int64 | 외장 스토리지의 빈 공간(GB)
예: 8 |
15
문자열 | 기기 시간대
예: USA/New York |
referrer_url문자열 | 선택 사항.
전환 API 또는 Meta 픽셀 이벤트를 트리거하는 페이지에서 관찰된 HTTP 리퍼러 헤더. 일반적으로 브라우저에서 선행하는 페이지에 해당합니다. |
original_event_data개체 | 선택 사항.
광고주가 '지연된' 이벤트가 과거 확보 이벤트와 어떻게 연결되어야 하는지 지정하기 위해 사용할 수 있는 모든 메타데이터 필드입니다. 이벤트 전송 시점과 연결해야 할 과거 확보 이벤트 사이에 지연이 있는 경우 original_event_data를 사용하는 것이 좋습니다. 자세한 내용은 원본 이벤트 데이터 매개변수를 참조하세요. |
