em이메일 문자열 또는 리스트<string> | 해싱 필수.
앞뒤 공백을 모두 삭제합니다. 모든 문자를 소문자로 변환합니다.
예: 입력: John_Smith@gmail.com
정규화된 형식: john_smith@gmail.com
예상 SHA256 출력: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
ph전화번호 문자열 또는 리스트<string> | 해싱 필수.
기호, 문자 및 모든 앞에 붙은 0을 삭제합니다. 전화번호에는 매칭에 사용할 국가 번호를 포함해야 합니다(예: 미국의 전화번호 앞에는 숫자 1을 추가해야 함). 모든 데이터가 같은 국가에서 비롯된 것이라 하더라도 항상 국가 번호를 고객 전화번호의 일부로 포함합니다.
예: 입력: US phone number (650)555-1212
정규화된 형식: 16505551212
예상 SHA256 출력: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176 |
fn이름 문자열 또는 리스트<string> | 해싱 필수.
로마자 a-z 문자를 사용하는 것이 좋습니다. 구두점 없이 소문자만 사용합니다. 특수 문자를 사용하는 경우 텍스트는 UTF-8 형식으로 인코딩해야 합니다.
예:
입력: Mary
정규화된 형식: mary
예상 SHA256 출력: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec
입력: 정
정규화된 형식: UTF-8 문자 "정"
예상 SHA256 출력: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14
입력: Valéry
정규화된 형식: valéry
예상 SHA256 출력: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c |
ln성 문자열 또는 리스트<string> | 해싱 필수.
로마자 a-z 문자를 사용하는 것이 좋습니다. 구두점 없이 소문자만 사용합니다. 특수 문자를 사용하는 경우 텍스트는 UTF-8 형식으로 인코딩해야 합니다.
예를 들어 이름(fn)을 참조하세요. |
db생년월일 문자열 또는 리스트<string> | 해싱 필수.
구두점이 포함되거나 포함되지 않은 여러 월, 일, 연도의 조합을 수용하는 YYYYMMDD 형식이 허용됩니다.
예: 입력: 2/16/1997
정규화된 형식: 19970216
예상 SHA256 출력: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c |
ge성별 문자열 또는 리스트<string> | 해싱 필수.
성별은 소문자 이니셜 형식이 허용됩니다.
예: |
ct시/군 문자열 또는 리스트<string> | 해싱 필수.
로마자 a-z 문자를 사용하는 것이 좋습니다. 구두점, 특수 문자 및 공백 없이 소문자만 사용합니다. 특수 문자를 사용하는 경우 텍스트는 UTF-8 형식으로 인코딩해야 합니다.
예:
paris
london
newyork |
st주/도 문자열 또는 리스트<string> | 해싱 필수.
소문자로 된 2자 ANSI 약어 코드를 사용합니다. 미국 이외의 주는 구두점, 특수 문자 및 공백 없이 소문자로 정규화합니다.
예:
az
ca |
zp우편번호 문자열 또는 리스트<string> | 해싱 필수.
공백 및 대시 없이 소문자를 사용합니다. 미국 우편번호의 경우 처음 5자리만 사용합니다. 영국의 경우 지역, 구, 지구 형식을 사용합니다.
예:
미국 우편번호: 94035
오스트레일리아 우편번호: 1987
프랑스 우편번호: 75018
영국 우편번호: m11ae |
country국가 문자열 또는 리스트<string> | 해싱 필수.
ISO 3166-1 alpha-2 형식의 소문자로 된 2자 국가 코드를 사용합니다.
중요 참고: 모든 국가 코드가 같은 국가에서 비롯된 것이라 하더라도 항상 고객 국가를 포함합니다. 전 세계적인 규모로 매칭이 이루어지므로 이 간단한 단계를 통해 리스트에서 최대한 많은 계정 센터 계정을 대상으로 매칭을 진행할 수 있습니다.
예:
입력: 미국
정규화된 형식: us
예상 SHA256 출력: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621 |
external_id외부 ID 문자열 또는 리스트<string> | 해싱 권장.
광고주의 모든 고유한 ID(예: 로열티 멤버십 ID, 사용자 ID, 외부 쿠키 ID). 특정 이벤트에 대해 하나 이상의 외부 ID를 보낼 수 있습니다.
외부 ID를 다른 채널을 통해 전송할 경우 해당 형식은 전환 API를 통해 전송할 때와 동일해야 합니다. |
client_ip_address클라이언트 IP 주소 문자열 | 해싱 금지.
이벤트에 상응하는 브라우저의 IP 주소는 유효한 IPV4 또는 IPV6 주소여야 합니다. IPV6를 지원하는 사용자의 경우 IPV4보다는 IPV6를 권장합니다. client_ip_address 사용자 데이터 매개변수를 해시 처리해서는 안 됩니다.
공백을 포함해서는 안 됩니다. 항상 실제 IP 주소를 제공하여 이벤트를 정확히 보고하세요.
참고: 이 정보는 브라우저를 통해 전송된 이벤트에 자동으로 추가되지만 서버를 통해 전송된 이벤트에는 수동으로 구성해야 합니다.
예:
IPV4: 168.212.226.204
IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
client_user_agent클라이언트 사용자 에이전트 문자열 | 해시 금지.
이벤트에 상응하는 브라우저의 사용자 에이전트. 전환 API를 사용하여 공유된 웹사이트 이벤트에는 client_user_agent가 필요합니다. 전환 API를 통해 전송하는 모든 이벤트에 client_ip_address 및 client_user_agent 매개변수를 보내면 이벤트 매칭을 개선하는 데 도움이 될 뿐만 아니라, 전환 API를 통해 전송하는 이벤트를 최적화하는 모든 광고 캠페인의 광고 전송을 개선하는 데도 도움이 될 수 있습니다.
참고: 이 정보는 브라우저를 통해 전송된 이벤트에 자동으로 추가되지만 서버를 통해 전송된 이벤트에는 수동으로 구성해야 합니다.
예:
Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 (Gecko와 같은 KHTML)
Chrome/87.0.4280.141
Safari/537.36 |
fbc클릭 ID 문자열 | 해시 금지.
Facebook 클릭 ID 값은 도메인 아래의 _fbc 브라우저 쿠키에 저장됩니다. 이 값을 가져오거나 fbclid 쿼리 매개변수에서 이 값을 생성하는 방법은 fbc 및 fbp 매개변수 관리를 참조하세요. 형식은 fb.${subdomain_index}.${creation_time}.${fbclid}입니다.
예:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 |
fbp브라우저 ID 문자열 | 해시 금지.
Facebook 브라우저 ID 값은 도메인 아래의 _fbp 브라우저 쿠키에 저장됩니다. 이 값을 가져오는 방법은 fbc 및 fbp 매개변수 관리를 참조하세요. 형식은 fb.${subdomain_index}.${creation_time}.${random_number}입니다.
예:
fb.1.1596403881668.1116446470 |
subscription_id구독 ID 문자열 | 해시 금지.
이 트랜잭션의 사용자에 대한 구독 ID. 이는 개별 제품에 대한 주문 ID와 유사합니다. |
fb_login_idFacebook 로그인 ID 정수 | 해시 금지.
사용자가 앱 인스턴스에 처음 로그인했을 때 Meta에서 발급한 ID. 이를 앱 범위 ID라고도 합니다. |
lead_id잠재 고객 ID 정수 | 해시 금지.
Meta 잠재 고객 광고에서 생성된 잠재 고객과 연결된 ID. |
anon_id문자열 | 해시 금지.
설치 ID. 이 필드는 고유한 앱 설치 인스턴스를 나타냅니다.
참고: 이 매개변수는 앱 이벤트 전용입니다. |
madid문자열 | 해시 금지.
모바일 광고주 ID, Android 기기의 광고 ID, Apple 기기의 광고 식별자(IDFA).
참고: 이 매개변수는 앱 이벤트 전용입니다. |
page_id문자열 | 해시 금지.
페이지 ID. 이벤트와 연결된 페이지 ID를 지정합니다. 봇과 연결된 페이지의 Facebook 페이지 ID를 사용합니다. |
page_scoped_user_id문자열 | 해시 금지.
이벤트를 로깅하는 Messenger 봇과 연결된 페이지 범위 사용자 ID를 지정합니다. Webhooks에 제공된 페이지 범위 사용자 ID를 사용합니다. |
ctwa_clid문자열 | 해시 금지.
Meta가 WhatsApp 연결 광고에 대해 생성하는 클릭 ID. |
ig_account_id문자열 | 해시 금지.
비즈니스와 연결된 Instagram 계정 ID. |
ig_sid문자열 | 해시 금지.
Instagram과 상호작용하는 사용자는 Instagram 범위 사용자 ID(IGSID)로 식별됩니다. IGSID는 이 Webhooks에서 얻을 수 있습니다. |
