Перейти к основному содержимому

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

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

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

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

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

Чтобы получать данные по метрикам, создайте их в интерфейсе Настройка метрик и разметьте сценарий с помощью методов сервиса $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. Сохраните и опубликуйте сценарий.

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