Змінні: їхні види та відмінності

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

💬

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

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

Давайте розглянемо основні типи змінних:

• User Defaults (типові дані користувачів) та User Fields (індивідуальні дані для кожного Клієнта / Проєкту);
• Динамічні змінні (змінні, що не зберігаються в системі Sendios та використовуються тільки в тому листі, для якого вони були передані);
• Проєктні змінні (змінні, які стосуються певного Проєкту);
• Змінні, створені із завантаженого CSV-файлу;
• Змінні з автологіном.

👍

Щоб ознайомитися із синтаксисом для використання різних типів змінних, перегляньте статтю Використання змінних у шаблонах.

User default та user fields

User default – це набір змінних користувача, які автоматично записуються в базу даних Sendios, починаючи з першої відправки через АРІ-точку Send system / trigger email. Ці змінні є універсальними для всіх клієнтів та проєктів і зберігаються в системі. Вони також оновлюються при використанні цієї ж АРІ-точки або АРІ-точок для оновлення даних користувача (Add and update user data by project id and email, або Add and update user data by user_id у майбутньому, якщо дані змінюються. До таких змінних належать:

Параметр	Опис
Namе	Ім'я користувача;
Age	Вік користувача;
Gender	Стать користувача;
Country	Назва країни;
City	Назва міста;
Language	Двосимвольний код мови (наприклад: "uk");
Channel Id	Використовується для передачі каналу трафіку верхнього рівня, із якого користувач потрапив на продукт (наприклад, paid search);
Subchannel Id	Використовується для передачі підканалу трафіку, з якого користувач потрапив на продукт (наприклад, facebook);
VIP	Використовується для передачі статусу користувача з огляду на те платник (1) він чи не платник (0).

User fields – набір змінних користувача, що складається з індивідуального набору значень для кожного Клієнта / Проєкту. На відміну від user default, ці дані не зберігаються автоматично. Для того, щоб їх зберегти в системі Sendios, вони мають бути відправлені через окрему API-точку:

• Add and update user data by project id and email, або
• Add and update user data by user_id.

Після цього дані будуть збережені в базі Sendios, і їх можна буде використати так само, як user default.

Використання

Змінні user default та user fields використовуються в маркетингових кампаніях та транзакційних відправках для персоналізації повідомлень. Вони дозволяють вставляти інформацію, персоналізовану під кожного окремого користувача, у текстові блоки, заголовки, посилання тощо. Це допомагає краще взаємодіяти з аудиторією.

📘

Змінні user default та user fields можна використовувати в маркетингових кампаніях та транзакційних відправках.

Перегляд

В адмін-панелі Sendios ці дані можна переглянути на сторінці User у вкладці User attributes. Тут ви зможете побачити список доступних змінних, їхні значення для кожного користувача, а також використовувати їх для налаштування персоналізованих кампаній.

Динамічні змінні

Динамічні змінні – це змінні, які передаються в масиві "data" під час відправки листа через АРІ-точку Send system / trigger email. Вони не зберігаються на боці Sendios і найчастіше використовуються для окремого листа, де необхідно вставити конкретну інформацію для кожного одержувача.

Використання

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

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

🚧

Динамічні змінні передаються для кожного листа заново і не зберігаються в базі Sendios, тому не можуть використовуватись у маркетингових відправках.

Проєктні змінні

Проєктні змінні – це змінні, які використовуються для універсальної інформації, спільної для всіх листів у межах Проєкту. Ці змінні можуть включати назву Проєкту, логотип, назву Домену, юридичну адресу та інші дані, які залишаються незмінними для всіх листів. Створити нову проєктну змінну можна у налаштуваннях відповідного Проєкту.

👍

Детальніше про створення нових проєктних змінних читайте у статті Редагування вашого Проєкту.

Використання

📘

Проєктні змінні зберігаються у базі Sendios і можуть використовуватись у маркетингових кампаніях.

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

Створення змінної для юридичної адреси

Змінні для юридичної адреси дозволяють створювати структуровані дані для юридичних адрес. Створення окремої проєктної змінної дозволяє вставляти дані про юридичну адресу в різні листи без необхідності написання вручну кожного разу, а також їх можна легко оновити, якщо адреса змінюється.

👍

Приклад заведення змінної для юридичної адреси можна побачити у статті Редагування вашого Проєкту – Персоналізовані проєктні змінні.

Перегляд

Переглядати наявні проєктні змінні та створювати нові можна на сторінці Редагування вашого Проєкту в адмін-панелі. Детальніше про це – у відповідній статті Редагування вашого Проєкту.

Змінні, створені у системі шляхом завантаження CSV-файлу

Одним із способів завантаження змінних в систему Sendios є використання CSV-файлу зі списком користувачів.

Для успішного завантаження сегменту в кампанію, CSV-файл має містити обов'язкові колонки project_id, clientuserid та інформацію про один із каналів комунікації (електронна адреса користувача або номер телефону). Кожна наступна колонка у файлі розглядається як змінна, що буде використовуватись для персоналізації повідомлень у листі.

👍

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

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

Використання

📘

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

Змінні з автологіном

Змінні з автологіном розширюють можливості персоналізації листів для користувачів, не потребуючи додаткових запитів до сервера або передачі JSON-даних. Для використання цих змінних, потрібно передати нам параметр ak (авторизаційний ключ) для кожного користувача.

Передати ak-параметр можна вже під час першої відправки через АРІ-точку Send system / trigger email чи за допомогою використання АРІ-точок оновлення даних користувача:

• Add and update user data by project id and email, або
• Add and update user data by user_id.

Перевірити, чи був переданий ak-параметр для певного користувача можна в адмін-панелі: розділ Users -> User attributes -> ak. У цілях безпеки даних сам ключ відображатися не буде, але з'явиться позначка hidden. Якщо передача цього параметру не налаштована, тоді ви побачите прочерк.

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

Пріоритетність змінних

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

Наприклад, якщо у вас налаштована проєктна змінна {{ legal_address }}, що має значення "London", і у JSON-файлі ви також передаєте змінну {{ legal_address }, але вже зі значенням "USA", то при використанні змінної {{ legal_address }} у шаблоні буде відображатися саме значення "USA", що підставляється із JSON-файлу.