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

Теги персоналізації (merge tags) є потужним інструментом в eSputnik, який забезпечує відправлення персоналізованих повідомлень. Вони використовуються для адаптації контенту під кожного контакту, що робить їх більш релевантними та привабливими для отримувачів.

Теги персоналізації в повідомленнях

В повідомленнях ви можете використовувати 2 типи тегів персоналізації:

  • Стандартні: Базові теги персоналізації.
  • Кастомні: Додаткові поля, які ви можете створювати в системі.

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

З цієї статті ви можете дізнатись більше про персоналізацію повідомлень.

Стандартні теги персоналізації

Назва

Тег персоналізації

Як він працює

Ім'я

${firstName}

Підставляє ім’я контакту.

Прізвище

${lastName}

Підставляє прізвище контакту.

Повне ім'я

${firstName}, ${lastName}

Підставляє ім'я та прізвище контакту.

Адреса електронної пошти

${email}

Підставляє email-адресу контакту.

SMS

${sms}

Підставляє номер телефону контакту.

External ID

${externalCustomerId}

Підставляє унікальний ідентифікатор контакту, створений у вашій системі.

Місто

${town}

Підставляє назву міста з блоку "Адреса" картки.

Адреса

${address}

Підставляє адресу контакту з блоку "Адреса" картки.

Область

${county}

Підставляє назву області з блоку "Адреса" картки контакту.

Поштовий індекс

${postcode}

Підставляє поштовий індекс з блоку "Адреса" картки контакту.

Назва повідомлення

${messageName}

Підставляє назву повідомлення.

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

Ви можете використовувати вертикальну риску (|) після змінної і додати альтернативний текст у такому форматі ${firstName|'dear friend'}. Цей текст буде показаний контакту, якщо відповідне поле в картці контакту порожнє.

Приклад:

Якщо в картці контакту введено ім'я, воно буде показано в повідомленні.

Якщо ім'я відсутнє, буде показаний альтернативний текст.

📘

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

  • Назви полів нечутливі до регістру (case-insensitive). Якщо ви додаєте персоналізацію через меню, за замовчуванням підставляється формат ${firstName}. Але назви полів не залежать від регістру, тож усі варіанти нижче працюватимуть однаково (якщо поле є в контексті):
    • ${firstName}
    • ${firstname}
    • ${FIRSTNAME}
  • Різні нотації Velocity для одного й того ж значення. Ви можете звертатися до поля як через $name, так і через ${name}. Фігурні дужки зручні, коли змінна стоїть поруч із текстом:
    • Привіт, $firstName!
    • Привіт, ${firstName}!
    • Привіт, ${firstName}Customer! → дужки допомагають відокремити змінну від тексту