Насамперед потрібно переконатися, що заголовки стовпців у файлі даних клієнтів вказано англійською мовою точно як у вказівках. Решта даних може бути будь-якою мовою.
У цій статті наведено вказівки щодо форматування файлу даних клієнтів.
Основні вказівки щодо форматування
Дані мають міститися у файлі CSV з кодуванням ASCII або UTF-8 (UTF-16 не підтримується). Скористайтеся шаблоном або створіть власний файл із такими заголовками стовпців англійською мовою: Email (Електронна адреса), Phone (Номер телефону), First Name (Ім'я), Last Name (Прізвище), Country (Країна) та Zip (Поштовий індекс). Щоб завантажити ідентифікатори мобільних пристроїв, використовуйте цей шаблон.
Щоб захистити дані клієнтів, ви можете прохешувати їх самостійно за допомогою алгоритму SHA256 (галузевого стандарту одностороннього хешування), або Google Ads зробить це за вас.
Дані клієнтів потрібно збирати відповідно до Правил щодо списків електронних адрес.
Якщо під час завантаження списків електронних адрес виникають проблеми, їх можна виправити, дотримуючись вказівок із цієї статті.
Вказівки з форматування заголовків стовпців (використовуйте лише англійську мову)
Зіставлення електронних адрес. У файлі з даними використовуйте заголовок стовпця Email (електронна адреса).
Зіставлення номерів телефонів. У файлі з даними використовуйте заголовок стовпця Phone (номер телефону).
Зіставлення поштових адрес. Файл із даними має містити чотири заголовки стовпців: First Name (ім'я), Last Name (прізвище), Country (країна) і Zip (поштовий індекс). Якщо використовувати не всі заголовки стовпців, дані навряд чи вдасться завантажити.
Зіставлення комбінацій електронних адрес, поштових адрес і номерів телефонів. Файл має містити шість заголовків стовпців: Email (електронна адреса), Phone (номер телефону), First Name (ім'я), Last Name (прізвище), Country (країна) і Zip (поштовий індекс). Якщо в одного клієнта кілька електронних або поштових адрес чи номерів телефону, файл може містити кілька стовпців Email (електронна адреса), Zip (поштовий індекс) чи Phone (номер телефону). Додавайте лише ті поля даних, які стосуються ваших клієнтів. Ви можете завантажити як одне поле даних (наприклад, електронні адреси), так і кілька (як-от поштові адреси й номери телефонів).
Зіставлення ідентифікаторів мобільних пристроїв. У файлі з даними використовуйте один заголовок стовпця 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
Ім’я
- Не вводьте форми звертання (наприклад, пан або пані).
- Ставити наголоси дозволяється.
Приклади
- Іван
- Зоя
Last Name (Прізвище)
- Не вводьте зайві пояснення (наприклад, "молодший").
- Ставити наголоси дозволяється.
Приклади
- Карпенко
- Карпенко-Щербина
- Щербина
Country (Країна)
- Використовуйте двобуквені або трибуквені коди країн за стандартом ISO.
- Вводьте код країни, навіть якщо всі дані ваших клієнтів з однієї країни.
Приклади
- US або USA – Сполучені Штати Америки
- SG або SGP – Сінгапур
Zip (Поштовий індекс)
- Дозволяється вводити американські та міжнародні поштові індекси.
- Для США:
- використовуються 5-значні індекси;
- Також дозволяється вводити 4-значне розширення після 5-значного коду, що може збільшити коефіцієнт збігу.
- Для інших країн:
- не використовуйте розширення для поштового індексу.
Приклади
- 94303
- 94303-5300
- WC2H 8LG
Mobile Device ID (Ідентифікатор мобільного пристрою)
- Використовуйте один стовпець із заголовком Mobile Device ID (Ідентифікатор мобільного пристрою).
- Файл має містити лише ідентифікатори мобільних пристроїв. Файли, які включають інші дані, не приймаються.
- Максимальна тривалість членства становить 540 днів.
Вказівки щодо форматування для завантаження хешованих даних
Заголовки стовпців у файлі даних клієнтів має бути вказано англійською мовою.
Щоб захистити дані клієнтів, ви можете самостійно хешувати їх за допомогою алгоритму SHA256.
Електронна адреса
- Указуйте доменне ім’я для всіх електронних адрес (наприклад, gmail.com або hotmail.co.jp).
- Вводьте всі символи з малої літери.
- Вилучайте зайві пробіли перед електронною адресою, після неї чи всередині.
Приклади
- example@email.com
- test@gmail.com
Телефон
- Номери телефонів мають бути у форматі E.164.
- Номери телефонів слід указувати з кодом країни та знаком "+".
Приклади
- +12345678910
- +811234567891
- +0212345678
Ім’я
- Не вводьте форми звертання (наприклад, пан або пані).
- Ставити наголоси дозволяється.
- Вводьте всі символи з малої літери.
- Вилучайте зайві пробіли перед іменем та після нього.
Приклади
- Іван
- Зоя
Last Name (Прізвище)
- Не вводьте зайві пояснення (наприклад, "молодший").
- Ставити наголоси дозволяється.
- Вводьте всі символи з малої літери.
- Вилучайте зайві пробіли перед іменем та після нього.
Приклади
- Карпенко
- Карпенко-Щербина
- Щербина
Країна
Не хешуйте дані про країну.
- Використовуйте дволітерні коди ISO для назв країн.
- Вводьте код країни, навіть якщо всі дані ваших клієнтів з однієї країни.
Приклади
- UА для України
- LV для Латвії
Zip (Поштовий індекс)
- Не хешуйте дані поштового індексу.
- Дозволяється вводити американські й міжнародні поштові індекси.
- Для США:
- використовуються 5-значні індекси;
- Також дозволяється вводити 4-значне розширення після 5-значного коду, що може збільшити коефіцієнт збігу.
- Для інших країн:
- не використовуйте розширення для поштового індексу.
Приклади
- 94303
- 94303-5300
- WC2H 8LG
