Настройка метрик

Чтобы собирать детальную статистику по работе бота, вы можете настроить собственные метрики для разметки сценария в разделе Настройка метрик.

Вы можете зафиксировать:

• Темы, на которые пользователи общаются с ботом.
• Действия, которые совершаются в диалоге. Например, пользователь оставил контакты или бот перевел диалог на оператора.
• Результаты сессий. Например, вопрос пользователя был решен или бот не смог помочь пользователю. В отличие от действий результат может быть только один за сессию.

подсказка

Статистику по темам и результатам можно просмотреть в разделе Обзор проекта.

Как настроить метрики

Чтобы получать данные по метрикам, создайте их в интерфейсе Настройка метрик и разметьте сценарий с помощью методов сервиса $analytics:

1. Перейдите в раздел Аналитика → Настройка метрик.

2. Выберите вкладку Темы, Действия или Результаты сессий.

3. Заполните поля Ключ в сценарии и Значение для каждой метрики.

   • Ключ — уникальный идентификатор метрики.

     предупреждение

     Вы не сможете изменить ключ или удалить метрику, если по ней уже есть данные в аналитике. Когда вы вызываете из сценария методы setSessionTopic, setScenarioAction и setSessionResult, передавайте в них ключ.

   • Значение — описание или комментарий к метрике, который отображается в разделе Обзор проекта. Вы можете изменить его в любой момент. При этом изменений в существующей статистике не произойдет, и вам не придется менять код сценария.

     подсказка

     Значение метрики можно не задавать. В таком случае оно будет таким же, как ключ.

4. Перейдите в редактор кода.

5. Выберите стейты, на которых вы хотите зафиксировать темы и действия, и добавьте к каждому стейту тег script с вызовом нужного метода:

   • setSessionTopic, чтобы проставить темы диалога;
   • setScenarioAction, чтобы зафиксировать действия в диалоге;
   • setSessionResult, чтобы зафиксировать результат диалога.

Когда бот перейдет в стейт, в котором вызывается метод, метрика зафиксируется в аналитике.

подсказка

Вы можете сначала добавить методы в сценарий. Когда методы будут вызваны, метрики добавятся в раздел Настройка метрик и отобразятся в статистике в разделе Обзор проекта. При этом ключ метрики и ее значение будут одинаковыми.

Пример настройки

Допустим, вы создали чат-бота для поддержки банка. Вам нужно:

• Собрать все обращения по вопросу получения кредита, в которых пользователь оставил контакт для связи.
• Зафиксировать в аналитике, решил ли бот вопрос пользователя.

Для этого добавьте метрики и разметьте сценарий для аналитики:

1. В разделе Настройка метрик создайте новые метрики:

   Метрика	Ключ	Значение
   Тема	Кредитование	Оформлена заявка на кредит
   Действие	Контактные данные	Контакты записаны в CRM
   Результат сессии	Положительный отзыв	Бот помог пользователю

2. Перейдите в сценарий бота.

3. Выберите стейт с темой получения кредита и добавьте к нему тег script с вызовом метода setSessionTopic:

   script:
       $analytics.setSessionTopic("Кредитование");

4. Выберите стейт, в котором вы отправляете контактные данные в CRM, и добавьте к нему тег script с вызовом метода setScenarioAction:

   script:
       $analytics.setScenarioAction("Контактные данные");

5. Выберите стейт, в котором пользователь оставляет положительный отзыв о работе бота, и добавьте к нему тег script с вызовом метода setSessionResult:

   script:
       $analytics.setSessionResult("Положительный отзыв");

6. Сохраните и опубликуйте сценарий.

Теперь, когда пользователь в ходе диалога попадет на эти стейты, в аналитике проекта зафиксируются соответствующие метрики.