가장 중요한 형식 지정 가이드라인은 고객 데이터 파일의 열 헤더가 영어로 정확하게 작성되었는지 확인하는 것입니다. 나머지 데이터는 어떤 언어로도 표시할 수 있지만, 열 헤더는 반드시 영어로 작성해야 합니다.
이 도움말은 고객 데이터 파일의 형식을 지정하는 데 필요한 사항을 안내합니다.
기본 형식 가이드라인
데이터는 ASCII 또는 UTF-8(UTF-16은 지원되지 않음)로 인코딩된 CSV 파일이어야 합니다. 템플릿을 사용하거나 'Email', 'Phone', 'First Name', 'Last Name', 'Country', 'Zip' 등의 헤더 이름을 조합(영어로 작성)하여 파일을 직접 만들 수 있습니다. 이 템플릿을 사용하여 휴대기기 ID를 업로드할 수 있습니다.
데이터를 안전하게 유지하려면 SHA256 알고리즘을 사용하여 직접 고객 데이터를 해싱하거나 Google Ads에서 동일한 SHA256 알고리즘(업계 표준 단방향 해싱)을 사용하여 해싱하도록 수 있습니다.
고객 데이터는 고객 일치 타겟팅 정책을 준수하여 수집해야 합니다.
업로드 과정에 문제가 발생하면 고객 목록 문제를 해결하는 방법을 알아보세요.
열 헤더 형식 지정 가이드라인(영어만 사용)
이메일 주소 일치: 데이터 파일에서 열 헤더 이름으로 'Email'을 사용합니다.
전화번호 일치: 데이터 파일에서 열 헤더 이름으로 'Phone'를 사용합니다.
우편 주소 일치: 우편 주소 일치를 사용하려면 데이터 파일에 4가지 열 헤더('First Name', 'Last Name', 'Country', 'Zip' )가 모두 포함되어야 합니다. 필수 열 헤더 이름이 누락될 경우 업로드 시 오류가 발생할 수 있습니다.
이메일 주소, 우편 주소, 전화번호 일치의 결합: 'Email' 'Phone' 'First Name' 'Last Name' 'Country' 'Zip'의 6가지 열 헤더가 모두 파일에 포함되어야 합니다. 단일 고객이 여러 이메일 주소, 우편 주소 또는 전화번호를 사용한다면 파일에 'Email', 'Zip' 또는 'Phone' 열이 여러 개 포함될 수 있습니다. 고객과 관련이 있는 데이터 필드만 포함해야 합니다. 이메일 주소와 같은 하나의 데이터 필드 또는 우편 주소 및 전화번호와 같은 여러 개의 데이터 필드를 업로드할 수 있습니다.
휴대기기 ID 일치: 데이터 파일에서 'Mobile Device ID'만 열 헤더로 사용해야 합니다.
데이터 파일의 각 열 헤더는 영어만 포함해야 합니다.
해싱되지 않은 데이터 업로드를 위한 포맷 가이드라인
고객 데이터 파일의 열 헤더 이름은 반드시 영어로 작성해야 합니다. API 업로드를 완료하려면 데이터를 해싱해야 합니다. 해싱된 데이터의 형식 지정 단계를 따릅니다.
이메일
- 모든 이메일 주소에 도메인 이름(예: gmail.com 또는 hotmail.co.jp)을 포함하세요.
- 이메일 주소 안의 공백을 삭제하세요.
예를 들면 다음과 같습니다.
- example@email.com
- test@gmail.com
전화
- 국가 코드를 포함하세요.
- 국가 코드 앞의 더하기 기호(+)는 선택사항입니다.
예를 들면 다음과 같습니다.
- 1 (234) 567-8910
- 81-12-3456-7891
- 02 1234 5678
이름
- 경칭(예: Mrs.)은 포함하지 마세요.
- 부호는 허용됩니다.
예를 들면 다음과 같습니다.
- john
- zoë
성
- 접미명(예: Jr.)은 포함하지 마세요.
- 부호는 허용됩니다.
예를 들면 다음과 같습니다.
- smith
- smith-jones
- pérez
국가
- 2자 또는 3자 ISO 국가 코드를 사용하세요.
- 모든 고객 데이터가 동일 국가의 데이터라도 국가 코드를 포함하세요.
예를 들면 다음과 같습니다.
- 미국의 경우 US 또는 USA
- 싱가포르의 경우 SG 또는 SGP
우편번호
- 미국 및 국제 우편번호가 모두 허용됩니다.
- 미국의 경우:
- 5자리 코드가 허용됩니다.
- 5자리 숫자 뒤에 붙는 4자리 코드도 허용되며 일치율을 향상시킬 수 있습니다.
- 기타 모든 국가:
- 우편번호 확장은 비워 둡니다.
예를 들면 다음과 같습니다.
- 94303
- 94303-5300
- WC2H 8LG
휴대기기 ID
- '휴대기기 ID'라는 단일 열을 사용합니다.
- 파일에는 휴대기기 ID 데이터만 포함되어야 하며, 다른 데이터 유형은 휴대기기 ID 데이터로 사용할 수 없습니다.
- 가입 기간은 최대 540일입니다.
해싱된 데이터 업로드를 위한 포맷 가이드라인
고객 데이터 파일의 열 헤더 이름은 반드시 영어로 작성해야 합니다.
데이터를 안전하게 유지하려면 SHA256 알고리즘을 사용하여 직접 고객 데이터를 해싱합니다.
이메일
- 모든 이메일 주소에 도메인 이름(예: gmail.com 또는 hotmail.co.jp)을 포함하세요.
- 소문자로만 입력하세요.
- 이메일 주소의 앞뒤와 중간의 공백을 모두 삭제하세요.
예:
- example@email.com
- test@gmail.com
전화
이름
- 경칭(예: Mrs.)은 포함하지 마세요.
- 부호는 허용됩니다.
- 소문자로만 입력하세요.
- 앞뒤의 공백을 모두 삭제하세요.
예:
- john
- zoë
성
- 접미명(예: Jr.)은 포함하지 마세요.
- 부호는 허용됩니다.
- 소문자로만 입력하세요.
- 앞뒤의 공백을 모두 삭제하세요.
예:
- smith
- smith-jones
- pérez
국가
국가 데이터는 해싱하지 마세요.
- 두 글자로 된 ISO 국가 코드를 사용하세요.
- 모든 고객 데이터가 동일 국가의 데이터라도 국가 코드를 포함하세요.
예를 들면 다음과 같습니다.
- 미국 대신 US
- 싱가포르 대신 SG
우편번호
- 우편번호 데이터는 해싱하지 마세요.
- 미국 및 국제 우편번호가 모두 허용됩니다.
- 미국의 경우:
- 5자리 코드가 허용됩니다.
- 5자리 숫자 뒤에 붙는 4자리 코드도 허용되며 일치율을 향상시킬 수 있습니다.
- 기타 모든 국가:
- 우편번호 확장은 비워 둡니다.
예를 들면 다음과 같습니다.
- 94303
- 94303-5300
- WC2H 8LG
