Guides

Завантаження CSV-файлу

У цій статті ми розглянемо ключові аспекти завантаження CSV-файлу користувачів та надамо рекомендації щодо правильного формату та структури даних.

Suggest Edits

Завантаження списку користувачів у систему є важливим кроком для ведення ефективних маркетингових кампаній та тригерних відправок. Правильне форматування та структура CSV-файлу, який містить дані користувачів, можуть спростити цей процес.

1. Обов'язкові поля: Project ID, Client User ID та канал зв'язку

Першим кроком у підготовці CSV-файлу є включення обов'язкових полів: Project ID (у таблиці: projectid), Client User ID (у таблиці: ClientUserId), де Project ID є унікальним ідентифікатором Проєкту, а Client User ID – ідентифікатором користувача у вашій базі даних, а також даних каналу комунікації.

🚧

Довжина параметру Client User ID має складати не більше 36 символів.

Зазначення даних для каналу зв'язку

Для ефективної комунікації з користувачами система повинна мати їхні контактні дані. У цьому контексті важливо включити один із можливих каналів зв'язку для кожного користувача. Це може бути:

  • електронна адреса користувача;
  • номер телефону користувача;

Заповнення одного з цих полів для кожного користувача є обовʼязковим. Додавайте цю інформацію для кожного користувача у відповідний стовпчик CSV-файлу.

📘

Ви можете зазначати інформацію про одразу декілька каналів комунікації для одного користувача за потреби.

❗️

Ці поля повинні бути включені у перших стовпцях вашого CSV-файлу, щоб забезпечити правильну ідентифікацію користувачів у системі при завантаженні даних.

2. Формат і назви стовпців

Для того, щоб ваш CSV-файл був готовий до завантаження, та не виникало проблем з його опрацюванням, важливо слідувати певним правилам формату даних та назв стовпців:

  • Обовʼязкова інформація – назви стовпців мають бути написані точно так, як вказано нижче справа, без будь-яких змін чи спеціальних символів. Це допоможе системі правильно ідентифікувати та розпізнавати дані:
    • Project ID – projectid;
    • Client User ID – clientuserid;
    • Email – email;
    • Phone Number – phonenumber;

📘

Для використання цих даних в шаблонах в якості змінних необхідно використовувати синтаксис {{ user.НазваЗмінної }}, наприклад: {{user.email}}.

  • Інші дані – усі інші стовпці таблиці після обов'язкових полів є даними про користувачів (user fields). Це імена, адреси, інтереси тощо, які можна використовувати як змінні у шаблонах маркетингових кампаній та тригерних відправок. Такі дані повинні бути записані одним словом або через нижнє підкреслення, без використання крапки чи пробілу. Наприклад, "First Name" можна записати як "FirstName" або first_name". Назви цих стовпців можна буде використовувати як змінну за допомогою синтаксису {{ user.camp\_НазваЗмінної }}, як-от: {{ user.camp_first_name }}.

📘

У CSV-файлі можна використовувати як ;, так і ,в якості символів розділення.

3. Результат завантаження CSV-файлу

Завантажити CSV-файл можна під час створення статичного сегменту.

👍

Більше інформації – у статті Як створити сегмент?.

Після опрацювання CSV-файлу на електронну пошту, яку ви вказували при його завантаженні, прийде лист із результатами. Це може бути:

  • Успішне опрацювання – усі користувачі, зазначені у CSV-файлі, були створені в системі;
  • Частково успішне опрацювання – CSV-файл був опрацьований, але є користувачі, яких ми не змогли створити через брак даних чи невірно надану інформацію / неправильний формат даних;
  • Неуспішне опрацювання – ми не змогли опрацювати файл та не створили користувачів у системі.

📘

Інформація про користувача, який вже існує в системі, оновлюється під час завантаження CSV-файлу.

Цей процес дозволяє підтримувати актуальність та точність даних користувачів, синхронізуючи їх із інформацією, наданою у CSV-файлі. При імпорті файлу система перевіряє наявні записи користувачів та оновлює їхні дані у випадку виявлення змін.

4. Причини, через які CSV-файл може бути неопрацьовано

  1. Недійсні дані – перевірте, чи вкзано атрибути цих користувачів (ідентифікатор Проєкту та ідентифікатор користувача на боці Клієнта), та чи надані дані є правильними;
  2. Відсутній канал зв’язку– переконайтеся, що для кожного користувача вказано принаймні один канал зв’язку, як-от: адреса електронної пошти або номер телефону.

📘

Після усунення проблем із CSV-файлом, завантажте його ще раз.

Ретельно підготуйте свій CSV-файл, дотримуючись вищезазначених рекомендацій. Це допоможе вам ефективніше взаємодіяти з вашими користувачами.

Updated 7 months ago