고객 정보 매개변수

고객 정보 매개변수는 이벤트 정보와 함께 공유하는 사용자 식별자 세트입니다. 필수 및 권장 매개변수에 대한 자세한 내용은 모범 사례 - 전환 API: 필수 및 권장 매개변수 전송을 참조하세요.

그래프 API v13.0 릴리스에는 유효한 것으로 간주되는 고객 정보 매개변수 조합에 관한 새로운 요구 사항이 있습니다. 모범 사례를 확인하여 전환 API 통합이 중단되지 않도록 하세요.

전환 API를 사용할 때 전송되는 데이터에 대해 알아보려면 Meta 개인정보 보호 및 데이터 사용 가이드를 참조하세요.

Facebook 시스템은 해시되지 않은 연락처 정보에 해당하는 고객 정보는 거부하도록 설계되었습니다. 단, 아래에 별도로 언급한 경우는 예외입니다. 연락처 정보는 이름, 이메일 주소, 전화번호 등 개인을 고유하게 식별하는 정보이며 Facebook에서는 이러한 정보를 매칭 목적으로만 사용합니다. Meta 비즈니스 SDK를 사용하는 중이라면 해시가 자동 처리됩니다.

픽셀 비교

Meta 픽셀을 통해 다양한 고객 정보 매개변수를 전송할 수 있지만 일부(예: client_user_agent)는 인터넷 작동 방식에 따라 자동으로 전송됩니다. 예를 들어 픽셀을 통해 external_id를 전송하려면 다음 코드를 사용하세요.

fbq('init', 'PIXEL_ID', {'external_id': 12345});

픽셀로 전달 가능한 다른 매개변수는 고급 매칭 문서를 참조하세요.

또한 현재 시스템이 브라우저 측에 공유하는 고객 정보 매개변수의 동일한 세트를 서버 측에 적용하세요.

`user_data` 매개변수 형식 지정

요청에 다음 user_data 매개변수 중 하나 이상을 올바른 형식으로 지정하여 제공해야 합니다.

이 CSV 파일을 다운로드

하여

아래의 매개변수에 대해 적절히 정규화되고 해시된 데이터의 예시를 참조하세요.

다운로드(마우스 오른쪽 버튼 클릭 > 다른 이름으로 링크 저장)

매개변수	설명
`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 형식이 허용됩니다. 년: 1900년부터 현재 연도까지 YYYY 형식을 사용합니다. 월: 01~12까지 MM 형식을 사용합니다. 일: 01~31까지 DD 형식을 사용합니다. 예: 입력: 2/16/1997 정규화된 형식: 19970216 예상 SHA256 출력: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c
`ge` 성별 문자열 또는 리스트<string>	해싱 필수. 성별은 소문자 이니셜 형식이 허용됩니다. 예: 여성의 경우 f 남성의 경우 m
`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_id` Facebook 로그인 ID 정수	해시 금지. 사용자가 앱 인스턴스에 처음 로그인했을 때 Meta에서 발급한 ID. 이를 앱 범위 ID라고도 합니다.
`lead_id` 잠재 고객 ID 정수	해시 금지. Meta 잠재 고객 광고에서 생성된 잠재 고객과 연결된 ID.
`anon_id` 문자열	해시 금지. 설치 ID. 이 필드는 고유한 앱 설치 인스턴스를 나타냅니다. 참고: 이 매개변수는 앱 이벤트 전용입니다.
`madid` 문자열	모바일 광고주 ID, Android 기기의 광고주 ID 또는 Apple 기기의 광고 ID(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에서 얻을 수 있습니다.

고객 정보 매개변수

픽셀 비교

user_data 매개변수 형식 지정

기타 참고 자료

`user_data` 매개변수 형식 지정