Українська
USD - $
Зв'язатися з підтримкою Підтримка
KWIGA центр підтримки Сервіси, інтеграції, API, Налаштування кабінету Загальні налаштування Використання змінних на проекті, список доступних змінних

Використання змінних на проекті, список доступних змінних

Статті:

2 тижні тому • Оновлено

У цій статті пояснюється, як використовувати змінні у вашому проєкті — де їх застосовувати, які дані доступні та як використовувати їх для автоматизації й персоналізації. Містить список із описами та прикладами для листів, вебхуків, кнопок, уроків та інших елементів.

У цій статті:

Загальна інформація про змінні

Змінні - це зручний спосіб підставляти персоналізовані дані в різні елементи вашого проєкту. Вони можуть використовуватися в таких місцях:

1. Вебхуки в автоматизаціях

Змінні можна підставляти:

  • в URL вебхука, наприклад:
     https://example.com/hook?user={{user.email}}
    у параметрах тіла запиту або заголовках

Це дає змогу передавати персональні дані в сторонні сервіси автоматично.

2. CTA (Call to Action)

У кнопках і посиланнях змінні можна використовувати для:

  • персоналізації тексту кнопки

  • передавання даних через посилання, наприклад ID користувача або UTM-мітки

3. У параметрах

Змінні можна використовувати в параметрах форм або інших елементів:

  • email користувача

  • ID підписки

  • унікальні коди та теги

  • будь-яка інша змінна, доступна в контексті

4. У посиланні редиректу (якщо не використовується перехід на оплату)

Можна додати змінні вручну в посилання редиректу:

https://my.site.com/thanks?email={{user.email}}&course={{course.title}}

5. В інфоблоках уроків

Змінні працюють усередині текстів інфоблоків. Наприклад:

  • Звернення на ім'я: Привіт, {{user.first_name}}!

  • Виведення назви курсу, дати, статусу тощо.

6. У листах 

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

Список доступних змінних

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

Змінна

Значення

{contact.id}

Id контакту

{contact.user_id}

Id користувача

{contact.first_name}

Ім'я контакту

{contact.last_name}

Прізвище контакту

{contact.name}

Повне ім'я контакту

{contact.email}

Email контакту

{contact.phone}

Телефон контакту

{contact.country}

Країна контакту. Наприклад: Україна

{contact.timezone}

Тайзмон контакту. Наприклад: Europe/Kyiv

{contact.currency}

Валюта контакту. Наприклад: USD

{contact.city}

Місто контакту

{contact.utm_source}

Список унікальних utm_source контакту (роздільник ", ")

{contact.utm_medium}

Список унікальних utm_medium контакту (роздільник ", ")

{contact.utm_campaign}

Список унікальних utm_campaign контакту (роздільник ", ")

{contact.utm_term}

Список унікальних utm_term контакту (роздільник ", ")

{contact.utm_content}

Список унікальних utm_content контакту (роздільник ", ")

{contact.field_<id>} 

Кастомні поля (опис нижче)

{datetime}

Дата і час в UTC у форматі YYYY-MM-DD HH:mm:ss у форматі YYYY-MM-DD HH:mm:ss

Кастомні поля

{contact.field_<id>}

Приклад {contact.field_123}

<id> - id поля, яке можна отримати в налаштуваннях полів контакту (приклад https://sampleschool.kwiga.com/expert/crm/contacts?view=settings )


Змінні, які можна додатково використовувати в CTA

  • у параметрах

  • у посиланні редиректу (якщо не використовується перехід на оплату)

Змінна

Значення

{first_name}

Ім'я з заявки

{last_name}

Прізвище з заявки

{name}

Повне ім'я з заявки

{email}

Email із заявки

{phone}

Телефон із заявки

{utm_source}

utm_source - конкретно того відвідування, з якого було залишено заявку

{utm_medium}

utm_medium - конкретно того відвідування, з якого було залишено заявку

{utm_campaign}

utm_campaign - конкретно того відвідування, з якого було залишено заявку

{utm_term}

utm_term - конкретно того відвідування, з якого було залишено заявку

{utm_content}

utm_content - конкретно того відвідування, з якого було залишено заявку

{widget_landing}

Url лендінгу, з якого відправили заявку

{widget_landign_referer}

Referer, який був на лендингу, коли відправили заявку

Також у певних формах можуть бути доступні змінні, які описані нижче в Перемінних доступних у вебхуках автоматизації


На замовлення ({order.*}) - Якщо обрано варіант форми Доступ до продукту (Повний доступ/За пропозицією)

За продуктом({product.*}) - Якщо обрано варіант форми Доступ до продукту + Повний доступ

За пропозицією ({offer.*}) - Якщо обрано варіант форми Доступ до продукту + За пропозицією

Якщо на сторінці, де розміщений CTA або скрипт Kwiga для трекінгу відвідувань, були відвідування з utm мітками, і клієнт залишив заявку на лендингу вже без utm міток, то в цих змінних вони будуть відсутні. Але вони будуть доступні в змінних {contact.utm_...}, які описані вище.

Змінні доступні у вебхуках автоматизації (url, параметри)

Змінна

Значення

{referrer}

Referrer з першого відомого відвідування контакту (Kwiga / лендінг з CTA)

{initial_page}

Url першого відомого відвідування контакту (Kwiga / лендінг з CTA)

{reg_from}

Url сторінки, з якої відбулася реєстрація (Kwiga / лендінг з CTA)

{tags}

Теги контакту (роздільник ", ")

{description}

Опис події, за якою спрацювала автоматизація. Наприклад: Контакту додано тег test_tag

Змінні продукту

Змінна

Значення

{product.id}

Id продукту

{product.title}

Назва продукту

{product.productable_type}

Тип продукту. Можуть бути такі варіанти: course, webinar, closed_group, custom_product

{product.productable_id}

Id курсу/вебінару/закритої групи/кастомного продукту

Доступні при спрацьовуванні таких подій:

  • Доступ до продукту відкритий

  • Доступ до продукту закрито

  • Зареєструвався на вебінар

  • Курс завершено

  • Проходження квізу

  • Анулювання попереднього результату квізу

  • Квіз перейшов у статус

  • Доступ до продукту відкритий

  • Старт доступу за передплатою

  • Кінець доступу за передплатою

  • Почав дивитися урок

  • Подивився урок

  • Відкрито доступ до уроку

  • Практику на уроці завершено

Змінні замовлення

Змінна

Значення

{order.id}

Id замовлення

{order.price}

Фінальна ціна. Приклад 10.99

{order.currency_code}

Валюта замовлення в кодовому форматі. Приклад: USD

{order.currency_symbol}

Валюта замовлення у форматі символу. Приклад: $

{order.currency_short_title}

Валюта замовлення в скороченій назві. Приклад: usd

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Підписку розпочато

  • Підписку продовжено

  • Успішна оплата замовлення

  • Нове замовлення

  • Успішна оплата пропозиції

  • Повернення платежу за пропозицією

  • Доступ до продукту відкритий

  • Старт доступу за передплатою

  • Кінець доступу за передплатою

Змінні платежі

Змінна

Значення

{payment.id}

Id платежу

{payment.price}

Ціна платежу

{payment.currency_code}

Валюта платежу в кодовому форматі. Приклад: USD

{payment.currency_symbol}

Валюта платежу у форматі символу. Приклад: $

{payment.currency_short_title}

Валюта платежу в скороченій назві. Приклад: usd

{payment.created_at}

Дата створення платежу. Формат YYYY-MM-DD HH:mm:ss HH:mm:ss

{payment.paid_at}

Дата оплати. Формат YYYY-MM-DD HH:mm:ss HH:mm:ss

{payment.schedule_payment_at}

Запланована дата оплати. Формат YYYY-MM-DD HH:mm:ss HH:mm:ss

{платіж.номер}

Порядковий номер платежу в замовленні

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Успішна оплата пропозиції

  • Повернення платежу за пропозицією

Змінні пропозиції

Змінна

Значення

{offer.id}

Id пропозиції

{offer.title}

Назва пропозиції

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Успішна оплата пропозиції

  • Повернення платежу за пропозицією

  • Прийнято безкоштовну пропозицію

  • Підписку розпочато

  • Підписку продовжено

  • Успішна оплата замовлення

  • Нове замовлення

  • Доступ до продукту відкритий

  • Старт доступу за передплатою

  • Кінець доступу за передплатою

Змінні підписки на продукт

Змінна

Значення

{subscription.id}

Id підписки на продукт

{subscription.start_at}

Дата початку передплати. YYYY-MM-DD HH:mm:ss

{subscription.end_at}

Фінальна дата закінчення передплати. YYYY-MM-DD HH:mm:ss

{subscription.order_end_at}

Дата закінчення передплати, враховуючи тільки оплачені платежі. YYYY-MM-DD HH:mm:ss

{subscription.paid_at}

Дата першої оплати передплати передплати. YYYY-MM-DD HH:mm:ss

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Доступ до продукту відкритий

  • Старт доступу за передплатою

  • Кінець доступу за передплатою

Змінні спроби проходження квізу

Змінна

Значення

{quiz_attempt.id}

Id спроби

{quiz_attempt.number_version}

Номер версії проходження

{quiz_attempt.quiz_id}

Id квізу

{quiz_attempt.course_id}

Id курсу

{quiz_attempt.course_lesson_id}

Id уроку

{quiz_attempt.status_id}

Id статусу

{quiz_attempt.status}

Статус у текстовому вигляді

{quiz_attempt.scores}

Набрано балів

{quiz_attempt.created_at}

Початок спроби. Формат YYYY-MM-DD HH:mm:ss

{quiz_attempt.finished_at}

Кінець спроби. Формат YYYY-MM-DD HH:mm:ss

{quiz_attempt.count_questions}

Кількість запитань у квізі

{quiz_attempt.count_questions_incorrect}

Кількість запитань, на які неправильно відповіли

{quiz_attempt.count_questions_correct}

Кількість правильно відповіли на запитання

{quiz.title}

Назва квізу

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Проходження квізу

  • Анулювання попереднього результату квізу

  • Квіз перейшов у статус

Змінні уроку

Змінна

Значення

{lesson.id}

Id уроку

{lesson.title}

Назва уроку

Список може доповнюватися.

Доступні при спрацьовуванні таких подій:

  • Проходження квізу

  • Анулювання попереднього результату квізу

  • Квіз перейшов у статус

  • Почав дивитися урок

  • Подивився урок

  • Відкрито доступ до уроку

  • Практику на уроці завершено