# UTM-метки в LiveChat

> [HTML Version](livechat-utm.html)

При создании новой сессии с пользователем, обратившимся в линию через [LiveChat](livechat.md), в ELMA365 автоматически фиксируются следующие UTM-метки: 

- **utm\_source** — источник перехода; 

- **utm\_medium** — тип трафика; 

- **utm\_campaign** — название рекламной кампании; 

- **utm\_content** — дополнительная информация, которая помогает различать объявления; 

- **utm\_term** — ключевая фраза. 

С помощью этих меток вы можете отслеживать, откуда приходит наибольшее количество потенциальных клиентов и какие темы наиболее востребованы. Зафиксированные метки отображаются на [странице сессии](working_in_chat.md#session-page) на правой боковой панели чата. 

Также вы можете передавать значения меток в [бизнес-процесс](chat-lines-processes.md). Для этого воспользуйтесь блоком [Скрипт](360027203731.md). Например, вы можете настроить процесс, в котором значения UTM‑меток будут выводиться в карточку [лида](leads.md) после его автоматического создания. Подробнее о написании скриптов читайте в [справке ELMA365 TS SDK](https://tssdk.elma365.com/ru/latest/modules/_09_lines_.html). 

## Пример использования UTM-меток в бизнес-процессе 

Рассмотрим пример, в котором при создании новой сессии с пользователем из LiveChat в ELMA365 будет автоматически создаваться новый [лид](leads.md) с помощью бизнес-процесса. При этом в карточке лида будут отображаться зафиксированные UTM‑метки. 

1. Перейдите в приложение **Лиды** из раздела [CRM](360012584940.md). 

2. Нажмите на значок шестерёнки напротив названия приложения и выберите **Бизнес-процессы**. 

3. В правом верхнем углу нажмите кнопку **+ Процесс**. В открывшемся окне введите название процесса, например, **Создание лида из сессии**. 

4. В открывшемся дизайнере бизнес-процесса откройте вкладку **Контекст** и добавьте переменную со следующими параметрами: 

- **Отображаемое имя\* **— **Лид**; 

- **Имя свойства\*** — **opportunity**;

- **Тип\* **— одиночное **Приложение**; 

- **Приложение\*** — **Лиды**. 

5. Затем создайте ещё одну переменную: 

- **Отображаемое имя\*** — **Идентификатор сессии**; 

- **Имя свойства\*** — **session\_id**;

- **Тип\*** — **Строка**.

6. Перейдите на вкладку **Скрипты** и добавьте следующий код: 

````
async function createOpportunity(): Promise<void> \{  
      
    if(Context.data.session\_id) \{  
          
        const session = await System.lines.sessions.search().where(item => item.\_\_id.eq(Context.data.session\_id\!)).first();  
        if(session \&\& session.data.\_clients \&\& session.data.\_clients.length > 0) \{  
              
            const client = await System.lines.clients.search().where(item => item.\_\_id.eq(session.data.\_clients\!\[0\].id)).first();  
            if(client) \{  
  
                if(client.data.\_applicationItem) \{  
                    
                    const new\_opportunity = await Context.fields.opportunity.app.create();  
  
                    new\_opportunity.data.\_contacts = \[client.data.\_applicationItem as any\];  
                    new\_opportunity.data.utm\_source = (<any>client.data.\_extraData).utm\_source;  
                    new\_opportunity.data.utm\_medium = (<any>client.data.\_extraData).utm\_medium;  
                    new\_opportunity.data.utm\_campaign = (<any>client.data.\_extraData).utm\_campaign;  
  
                    await new\_opportunity.save();  
  
                    Context.data.opportunity = new\_opportunity;  
                \}  
            \}  
        \}  
    \}  
\}

7. ````
Перейдите на вкладку **Схема** и вынесите на поле для моделирования элемент [Скрипт](360027203731.md). Дважды нажмите на него и в открывшемся окне настроек в поле **Функция** укажите функцию `createOpportunity`, созданную на вкладке **Скрипты**. Нажмите **Сохранить**. 

В нашем примере для автоматического создания лида и получения UTM-меток достаточно только элемента **Скрипты**, поэтому схема процесса может выглядеть следующим образом:

**(livechat-utm-1.png)**

8. На верхней панели дизайнера бизнес-процессов нажмите **Сохранить**, а затем **Опубликовать**. 

9. Вынесите свойства для UTM‑меток в карточку просмотра лида. Для этого нажмите на значок шестерёнки справа от названия приложения **Лиды** и выберите **Настройка формы**. В открывшемся окне перейдите на вкладку **Просмотр** и перенесите свойства для UTM‑меток, расположенные в левой панели, на форму: 

**(livechat-utm-2.png)**

10. Сохраните форму и перейдите в раздел **Администрирование > Линии**. 

11. Откройте вкладку** Бизнес-процессы**. Напротив события **При создании новой сессии** нажмите **Выбрать** и укажите созданный ранее процесс **Создание лида из сессии**. 

12. В столбце **Входные параметры** нажмите **Настроить**. В открывшемся окне нажмите кнопку **+ Поле** и выберите свойство **Идентификатор сессии**, созданное на шаге 5. В столбце **Поле приложений Линии** укажите **Сессия > Идентификатор**. 

**(livechat-utm-3.png)**

13. Нажмите кнопку **Сохранить**. После закрытия окна сохраните изменения, внесённые на вкладку **Бизнес-процессы**. 

После этого при создании новой сессии с пользователем из LiveChat в разделе **CRM** будет создан новый лид, в карточке которого будут отображаться зафиксированные UTM метки.