Персоналізація зі змінними

Одним зі способів персоналізації повідомлення є автоматична підстановка персональних даних зі значень полів контакту.

Найпростіший і широко використовуваний приклад персоналізації —  підстановка замість змінної ${firstName} імені контакта. 

У такому вигляді підписник отримає лист.

Заміна відбувається тільки якщо відповідне поле заповнене в картці контакту; якщо поле пусте — значення пропускається.

За необхідності можна створити додаткові поля для використання більш широкого списку персоналізації.

За таким же принципом можна автоматично підставляти інші значення з полів контакту.

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

У додаткових полях може міститися будь-яка інформація про клієнта, яку ви передаєте в eSputnik при імпорті контактів або через API. Перевірити, які дані та додаткові поля вже доступні для використання, можна в особистому кабінеті → Налаштування → Додаткові поля.

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

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

📘

Зверніть увагу

• Назви полів нечутливі до регістру (case-insensitive). Якщо ви додаєте персоналізацію через меню, за замовчуванням підставляється формат ${firstName}. Але назви полів не залежать від регістру, тож усі варіанти нижче працюватимуть однаково (якщо поле є в контексті):

  • ${firstName}
  • ${firstname}
  • ${FIRSTNAME}

• Різні нотації Velocity для одного й того ж значення. Ви можете звертатися до поля як через $name, так і через ${name}. Фігурні дужки зручні, коли змінна стоїть поруч із текстом:

  • Привіт, $firstName!
  • Привіт, ${firstName}!
  • Привіт, ${firstName}Customer! → дужки допомагають відокремити змінну від тексту

• Пріоритет підстановки в повідомленнях. Якщо контекст персоналізації містить і значення із зовнішніх даних (наприклад, "firstname": "Саша"), і значення з картки контакту (наприклад, firstName = "Олександр") для одного й того ж поля, під час підстановки буде використано зовнішнє значення ("Саша").

  Приклад:

  • Картка контакту: firstName = "Олександр"
  • Зовнішні дані: "firstname": "Саша"
  • Шаблон: Привіт, ${firstName}!
  • Результат: Привіт, Саша!

Меню персоналізації в редакторах eSputnik

Email

Щоб використовувати персоналізацію в email-повідомленні: 

1. Перейдіть до розділу Повідомлення, клікніть вкладку Email та відкрийте повідомлення у редакторі.

2. Натисніть текстовий блок повідомлення. На боковій панелі редактора з’явиться вкладка Merge-тег.

   

3. У випадаючому списку виберіть поле для підстановки або знайдіть необхідне через пошук.

SMS, Web Push, Mobile Push, Viber, App Inbox

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

Розглянемо персоналізацію на прикладі мобільних пушів.

1. Перейдіть до розділу Повідомлення, клікніть вкладку Mobile Push та відкрийте повідомлення у редакторі.

2. Перейдіть до поля, позначеного іконкою з чоловічком та натисніть її.

   

3. У випадаючому списку виберіть поле для підстановки або знайдіть необхідне через пошук.

Використання сталого значення при відсутності даних у додаткових полях

Якщо необхідно додати альтернативне значення для додаткових полів у яких немає інформації, після символу | вкажіть потрібний текст, формат: ${email|'alt'}.

Контакт отримає повідомлення:

• З персоналізованим зверненням, якщо відомо його ім'я.

• Альтернативне звернення, якщо ім’я відсутнє. 

  

Приклади використання змінної для персоналізації

Розглянемо приклад листа з підстановкою даних таких значень полів з картки контакту, де: 

• ${firstName} — ім'я клієнта. 

• ${personal.bonus} — кількість персональних бонусів на картці клієнта.

• ${manager.phone} — телефон менеджера.

• ${manager.name} — ім'я менеджера.

• ${personal.promocode} — персональний промокод клієнта.

  

Змінні залежать від назв додаткових полів, тому можуть відрізнятися від наведених в прикладі.

Для підстановки посилання на зображення потрібно виділити блок картинки та у відповідному полі зліва замість шляху до картинки вказати змінну персоналізації. У нашому прикладі це ${qrcode}.

Або ж при редагуванні коду повідомлення записати змінну в атрибут зображення src:

📘

Важливо

Значенням змінної повинно бути посилання на зображення, яке являє собою повний шлях до картинки, включаючи протокол, наприклад: https://example.com/qr_code.png

Підстановка даних з події

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

Іноді через відсутність кількох параметрів в листі втрачається цінність цілого блоку. Якщо відомостей про контакт не вистачає, підстановка даних не відбудеться. Наприклад, в блоці, де повинен бути виведений промокод і QR-код, можуть бути пропуски:

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