# Зарезервированные переменные

Переменные, с некоторыми именами нельзя создать. Но можно использовать :)&#x20;

Зарезервированная переменная - это переменная, которая создается платформой автоматически. Например, имя подписчика, его идентификатор, utm-метка, по которой он перешел. Эти данные фиксируются платформой, и в дальнейшем ты можешь использовать их.&#x20;

Список таких переменных :point\_down:&#x20;

### Часто используемые переменные&#x20;

| Переменная              | Описание переменной                                                                                                                                                                      |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| first\_name             | имя подписчика                                                                                                                                                                           |
| last\_name              | <p>фамилия подписчика <br>(если фамилии не было - может быть пустой)</p>                                                                                                                 |
| id                      | идентификатор подписчика **в платформе**                                                                                                                                                 |
| user\_id                | идентификатор подписчика **в мессенджере**                                                                                                                                               |
| gender                  | <p>пол пользователя</p><p><code>возможные значения:</code> </p><p><code>FEMALE - женщина,</code> </p><p><code>MALE - мужчина,</code> </p><p><code>NULL - не известно</code></p>          |
| created\_at             | дата создания подписчика в платформе                                                                                                                                                     |
| nickname                | Никнейм пользователя в Telegram                                                                                                                                                          |
| last\_request           | В этой переменной хранится вся входящая информация от мессенджера в случае активации триггера или получения сообщения. Чтобы включить работу переменной, нужно обратиться в техподдержку |
| photo\_max\_orig        | Cсылка на аватар пользователя (если аватара нет - будет null)                                                                                                                            |
| incoming\_message\_text | В этой переменной хранится текст последнего сообщения написанного пользователем                                                                                                          |

### JSON-переменные

Так же существуют JSON-переменные.&#x20;

| Переменная               | Описание переменной                                                                                                                                                                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| channel                  | <p>JSON-объект с информацией о канале<br>пример:</p><p><code>{</code><br>  <code>"id":"1945495217",</code><br>  <code>"name":"example\_channel",</code><br>  <code>"resource":"TG",</code><br>  <code>"token":"1945495217:AAF9shqpZPum62KweE7VsWVHrigBDDKg3U"</code><br><code>}</code></p> |
| channel.id               | ID канала                                                                                                                                                                                                                                                                                  |
| channel.name             | имя канала                                                                                                                                                                                                                                                                                 |
| channel.resource         | <p>код мессенджера</p><p><code>возможные значения:</code></p><p><code>VK - ВКонтакте</code></p><p><code>FB - Facebook</code></p><p><code>INST - Instagram</code></p><p><code>TG - Telegram</code></p><p><code>VIBER - Viber</code></p><p><code>EMAIL - Email</code></p>                    |
| channel.token            | токен канала                                                                                                                                                                                                                                                                               |
| last\_comment            | <p><strong>JSON-объект</strong> с информацией о комментарии пользователя<br><br><code>{</code><br><code>"id": "18110358151664656",</code><br><code>"text": "text",</code><br><code>"source\_id": "18195934504223416"</code><br><code>}</code></p>                                          |
| last\_comment.id         | ID комментария пользователя                                                                                                                                                                                                                                                                |
| last\_comment.text       | Текст комментария пользователя                                                                                                                                                                                                                                                             |
| last\_comment.source\_id | ID Поста                                                                                                                                                                                                                                                                                   |

### Переменные аналитики

| Переменная           | Описание переменной                                                                                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tracking             | <p>URL-params строка собранная из всех utm\_\* меток подписчика</p><p><code>пример:</code></p><p><code>utm\_source=yandex\&utm\_campaign=example</code></p> |
| utm\_source          | UTM Source метка подписчика                                                                                                                                 |
| utm\_medium          | UTM Medium метка подписчика                                                                                                                                 |
| utm\_campaign        | UTM Campaign метка подписчика                                                                                                                               |
| utm\_content         | UTM Content метка подписчика                                                                                                                                |
| utm\_term            | UTM Term метка подписчика                                                                                                                                   |
| first\_utm\_source   | Первая UTM Source метка подписчика                                                                                                                          |
| first\_utm\_medium   | Первая UTM Medium метка подписчика                                                                                                                          |
| first\_utm\_campaign | Первая UTM Campaign метка подписчика                                                                                                                        |
| first\_utm\_content  | Первая UTM Content метка подписчика                                                                                                                         |
| first\_utm\_term     | Первая UTM Term метка подписчика                                                                                                                            |

#### Небольшой комментарий для простоты понимания

Предвижу немой вопрос, что ещё за **first\_utm\_\*** переменные?&#x20;

Всё дело в том, что платформа фиксирует ВСЕ касания с клиентом. И первое, и второе, и пятое.

Например, подписчик зашёл на подписную страницу с меткой utm\_source=yandex. После чего снова увидел нашу рекламу, и подписался в другого бота с меткой utm\_source=google.&#x20;

В переменной first\_utm\_source будет значение yandex;

В переменной utm\_source будет значение google;

#### tracking переменная

tracking переменная собирается из всех актуальных utm\_\* переменных в строку формата url параметров.

Звучит немного пугающе, но на практике всё просто. Рассмотрим пример.&#x20;

Есть задача - вести трафик с рекламных сетей на бота, прогревать подписчика в боте, и уводить на свой итоговый лендинг. Так же мы хотим, чтобы при переходе на итоговый лендинг передавались все utm-метки, которые были у подписчика, для аналитики.

Мы можем собрать подобную конструкцию:

> <https://example.com/page\\_1?utm\\_source=({utm\\_source})\\&utm\\_mediium=({utm\\_medium})\\&utm\\_campaign=({utm\\_campaign})\\&utm\\_term=({utm\\_term})\\&utm\\_content=({utm\\_content})>

Она будет выполнять нашу задачу, но выглядит как-то громоздко и неудобно.

С помощью переменной tracking мы можем сократить эту конструкцию до такой:

> example.com/page\_&#x31;**?**({tracking})

Если у нашей ссылки уже были какие-то параметры, просто добавь перед этой переменной символ &

> example.com/page\_1?parameter=valu&#x65;**&**({tracking})

## Остались вопросы?

Если тебе что-то не понятно - напиши нам в поддержку, мы с радостью тебе всё объясним и решим твой вопрос :)

{% content-ref url="../kak-zadat-vopros-v-podderzhku" %}
[kak-zadat-vopros-v-podderzhku](https://docs.leadconverter.su/kak-zadat-vopros-v-podderzhku)
{% endcontent-ref %}
