Помощен център на KWIGA Услуги, интеграции, API, настройки Общи настройки Използване на променливи в проекта, списък с наличните променливи

Използване на променливи в проекта, списък с наличните променливи

Статии:

преди 10 месеца • Обновено

Тази статия обяснява как да използвате променливи в проекта си – къде да ги прилагате, какви данни са налични и как да ги използвате за автоматизация и персонализация. Включва списък с описания и примери за имейли, уебкуки, бутони, уроци и други.

Обща информация за променливите

Променливите са удобен начин да вмъквате персонализирани данни в различни елементи на вашия проект. Те могат да се използват на места като:

1. Webhook-и в автоматизациите

Променливите могат да се вмъкват:

в URL адреса на webhook-а, например:
https://example.com/hook?user={user.email}
в параметрите на тялото на заявката
в заглавките

Това позволява лични данни да се изпращат автоматично към услуги на трети страни.

2. CTA (призив за действие)

В бутоните и връзките променливите могат да се използват за:

персонализиране на текста на бутона
предаване на данни чрез връзки, като потребителски ID или UTM тагове

3. В параметрите

Променливите могат да се използват в параметрите на формуляри или други елементи:

имейл на потребителя
ID на абонамента
уникални кодове и тагове
всяка друга променлива, налична в контекста

4. Във връзката за пренасочване (ако не използвате преход към плащане)

Променливите могат да се добавят ръчно към връзката за пренасочване:

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

5. Във връзката за пренасочване при успешно плащане на оферта

Във връзката за пренасочване след успешно плащане на оферта са налични променливи от блоковете contact.*, order.* и payment.*

Пример: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. В информационните блокове на урока

Променливите и условните блокове работят в текстовете на информационните полета. Например:

Обръщение по име: Здравейте, {user.first_name}!
Показване на име на курс, дата, статус и др.
Данни за контакт: {contact.name}, {contact.email} и други полета
Данни за текущия урок: {lesson.title}, {lesson.slug} и други полета на урока
Условни блокове @if/@endif: показват различно съдържание в зависимост от това дали контактът има таг, достъп до офертата и др.

6. В имейли

Използването на променливи в имейлите прави комуникацията по-персонализирана и ефективна. С променливи като {name}, {date} или {course_name} имейлът изглежда като лично адресиран до клиента. Това повишава доверието, ангажираността и вероятността потребителят да прочете имейла докрай или да предприеме желаното действие. Освен това променливите улесняват автоматизирането на масови имейл кампании, без да се губи индивидуалният подход.

7. В известия

При настройване на известия в действията за автоматизация променливите ви позволяват динамично да вмъквате информация в известията, като потребителско име, номер на поръчка или име на оферта. Това улеснява и ускорява процеса по създаване на известия, като ги прави по-интуитивни и адаптивни за различни сценарии.

Списък с налични променливи

Списък с налични променливи, достъпни на всички места, където могат да се използват променливи.

Променлива	Стойност
contact.id	ID на контакта
contact.user_id	ID на потребителя
contact.first_name	Име на контакта
contact.last_name	Фамилия на контакта
contact.middle_name	Бащино име на контакта
contact.name	Пълно име на контакта
contact.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
contact.visit_source	Източник на посещението
Тези променливи са налични в линка за пренасочване при успешно плащане на оферта.

Персонализирани полета

{contact.field_<id>}

Пример {contact.field_123}

<id>- ID на полето, което може да бъде получено в настройките на полето за контакт (пример https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Как да промените стойността на променлива

Можете да добавяте опции след променлива, за да промените начина, по който изглежда: да добавите текст, да направите буквите главни или да форматирате датата.

Общ вид: {variable|option:value|option}. Например: {order.id|prefix:ORDER-} или {payment.paid_at|format:DD.MM.YYYY}.

Какво искате да получите	Какво да напишете
Добавяне на текст преди стойността	`{order.id\|prefix:ORDER-}` -> резултатът ще бъде `ORDER-123`
Добавяне на текст след стойността	`{order.id\|suffix:-EU}` -> резултатът ще бъде `123-EU`
Задаване на фиксирана дължина на числото	`{payment.number\|pad:6}` -> резултатът ще бъде `000001`
Допълване със собствен символ вместо нули	`{payment.number\|pad:6\|padchar:_}` -> резултатът ще бъде `_____1`
Преобразуване на всички букви в главни	`{contact.city\|upper}` -> `KYIV`
Преобразуване на всички букви в малки	`{contact.city\|lower}` -> `kyiv`
Главна само първата буква	`{contact.city\|ucfirst}` -> `Kyiv`
Показване на датата в необходимия формат	`{payment.paid_at\|format:DD.MM.YYYY}` -> резултатът ще бъде `24.12.2026`

Ако искате собствен шаблон за формат на датата, можете да проверите готовите токени в публичната документация: за формати като DD.MM.YYYY, MMMM YYYY, dddd ще ви помогне документацията на Carbon. За формати като Y-m-d и H:i:s използвайте официалната PHP документация.

Важно: ако се използва pad, стойността първо се допълва до необходимата дължина и едва след това се прилагат останалите опции.

Условни блокове @if / @endif

Позволяват да показвате или скривате част от текста в зависимост от условие. Ако условието е изпълнено, блокът се показва; ако не, се премахва изцяло.

Синтаксис: @if(condition)...text...@endif

Пример:
@if({contact.has|offer:123})Получете достъп до материалите@endif

Условието в @if() е всяка променлива, която връща true или false. В момента се поддържа {contact.has|...} (проверка за принадлежност на контакт).

Условие contact.has — проверка на контакт

Позволява да проверите дали даден контакт отговаря на определени условия. Връща true или false. Обикновено се използва заедно с условните блокове @if/@endif.

Синтаксис: {contact.has|type:value}

Тип	Стойност	Описание
`offer`	ID на офертата	Контактът има достъп до офертата
`order`	ID на поръчката	Контактът има поръчка с този ID
`product`	ID на продукта	Контактът има достъп до продукта
`tag`	ID или име на етикета	Контактът има етикет (поддържат се кирилица и интервали в името)
`list`	ID на списъка	Контактът е в списъка
`course`	ID на курса	Контактът е записан в курса
`bootcamp`	ID на курса	Псевдоним за курс (bootcamp е подтип на курс)
`уебинар`	ID на уебинара	Контактът има достъп до уебинара
`затворена_група`	ID на затворената група	Контактът има достъп до затворената група

Можете да зададете няколко условия, разделени с | — всички трябва да са изпълнени едновременно (логика И). Например: {contact.has|offer:123|tag:VIP}

Примери за употреба:

{contact.has\|offer:123}	проверява за наличие на оферта с ID 123
{contact.has\|tag:VIP}	проверява таг по име
{contact.has\|tag:тест тег}	таг с интервал и на кирилица
{contact.has\|offer:123\|tag:VIP}	и двете условия едновременно (И)

Променливи, които могат да се използват допълнително в CTA

в параметрите
в връзката за пренасочване (ако не се използва преход към плащане)

Променлива	Стойност
first_name	Собствено име от заявката
last_name	Фамилия от заявката
middle_name	Бащино име от заявката
name	Пълно име от заявката
email	Имейл от заявката
phone	Телефон от заявката
field_<id>	Персонализирани полета Телефон от заявката (описанието е по-долу)
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	Източник на препращане, който е бил на целевата страница при изпращането на кандидатурата
Също така в определени формуляри може да са достъпни променливите, описани по-долу в „Променливи, налични в уебкуки за автоматизация“ По поръчка ({order.}) - Ако е избрана опцията на формуляра „Достъп до продукт“ (Пълен достъп/По оферта) По продукт ({product.}) - Ако е избрана опцията на формуляра „Достъп до продукт + Пълен достъп“ По оферта ({offer.*}) - Ако е избрана опцията на формуляра „Достъп до продукт + По оферта“

Персонализирани полета

{field_<id>}

Пример {contact.field_123}

<id>- ID на полето, което може да бъде получено в настройките на полето за контакт (пример https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Ако на страницата, на която е поставен CTA или скриптът за проследяване на Kwiga, е имало посещения с UTM тагове, а клиентът е изпратил заявка на лендинг страницата без UTM тагове, те няма да присъстват в тези променливи. Но ще бъдат налични в променливите {contact.utm_...}, които са описани по-горе.

Променливи, налични в уебхуковете за автоматизация (url, параметри, имейли)