Перейти к содержанию

Настройка Событий

В данной статье мы расскажем, как настраивать и отслеживать события:

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

Как настроить событие

На сайте

Обратите внимание:

Чтобы передавать события на сайте, установите счетчик Roistat.

  1. Откройте в меню раздел События, перейдите во вкладку Настройка и нажмите на кнопку Добавить событие:

    1-1.png

  2. В открывшейся форме укажите название события.

  3. Выберите одно из условий срабатывания: Переход на страницу сайта или Передается через JavaScript.

    Переход на страницу сайта:

    При выборе данного условия событием считается переход по указанной ссылке. Для настройки события добавьте нужную ссылку в поле URL. Можно использовать регулярные выражения (нажмите на поле, чтобы увидеть подсказку):

    2-1.png

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

    Для каждого срабатывания на вкладке История срабатываний отображаются дата и время, когда пользователь перешел по ссылке.

    Передается через JavaScript:

    С помощью JavaScript можно настроить прочие виды отслеживания. Например, можно отслеживать следующие действия:

    • Пользователь кликнул по кнопке;
    • Пользователь отправил товар в корзину;
    • Пользователь провел на сайте определенное количество секунд.

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

    3-1.png

    Нажмите Добавить, чтобы сохранить событие.

    Затем в JavaScript-коде на странице сайта вставьте соответствующую строку с кодом типа roistat.event.send('cart_view', data), где cart_view – это указанный ранее ID события, data – необязательный аргумент вида ключ: значение с любыми дополнительными параметрами.

    Например:

        roistat.event.send('cart_view')
        roistat.event.send('register', {'name':'товар'})
    

    Отслеживание события начнется сразу после добавления кода на сайт.

    Вы также можете настроить отправку событий через API Roistat.

  4. Уже созданные события можно отредактировать или удалить на странице настроек:

    4-1.png

  5. При необходимости вы можете настроить отчет по воронке событий.

В мобильном приложении

  1. Откройте в меню раздел События, перейдите во вкладку Настройка и нажмите на кнопку Добавить событие:

    1-1.png

  2. В открывшейся форме укажите название события.

  3. Выберите условие срабатывания Передается через JavaScript и укажите произвольный ID события:

    3-1.png

  4. В коде приложения настройте отправку события через API Roistat, используя метод /project/events/send. Запрос должен отправляться из приложения в момент совершения целевого действия (например, при клике по кнопке).

    После добавления запроса в код приложения начнется отслеживание события. Каждое срабатывание будет отображаться в Истории срабатываний.

  5. Уже созданные события можно отредактировать или удалить на странице настроек:

    4-1.png

  6. При необходимости вы можете настроить отчет по воронке событий для вашего приложения:

    5-1.png

В рассылках (открытие писем)

  1. Откройте в меню раздел События, перейдите во вкладку Настройка и нажмите на кнопку Добавить событие:

    1-1.png

  2. В открывшейся форме укажите название события.

  3. Выберите условие срабатывания Передается через JavaScript и укажите произвольный ID события:

    3-1.png

  4. Чтобы отслеживать открытие письма, в его HTML-код нужно добавить невидимый пиксель, отправляющий POST-запрос на сервер Roistat. Например, это можно сделать следующим образом:

    • Загрузите изображение размером 1x1 на свой сервер.

    • На этом же сервере добавьте PHP-скрипт для загрузки картинки и отправки POST-запроса на сервер Roistat. Для передачи данных о событии используйте метод /project/events/send. Пример простого скрипта для загрузки изображения tracking.gif:

      <?php
      
      //Скрипт для загрузки картинки
      header('Content-Type: image/gif');
      readfile('tracking.gif');
      
      //Скрипт для отправки POST-запроса
      file_get_contents(
          'https://cloud.roistat.com/api/v1/project/events/send?key={API_KEY}&project={PROJECT_ID}',
          false,
          stream_context_create([
              'http' => [
                  'method'  => 'POST',
                  'header'  => 'Content-Type: application/json',
                  'content' => json_encode([
                      'name'  => 'Открытие письма',
                      'visit' => '100001',
                      'data'  => [
                          'region' => 'Москва',
                      ],
                  ]),
              ],
          ])
      );
      
      ?>      
      
    • Добавьте пиксель в HTML-код письма: <img src='.../tracking.php?tracking.gif' width=1 height=1>

    Теперь при каждом открытии письма в Истории срабатываний будет появляться новое срабатывание.

  5. Уже созданные события можно отредактировать или удалить на странице настроек:

    4-1.png

В CRM

  1. Откройте в меню раздел События, перейдите во вкладку Настройка и нажмите на кнопку Добавить событие:

    1-1.png

  2. В открывшейся форме укажите название события.

  3. Выберите условие срабатывания Передается через JavaScript и укажите произвольный ID события:

    3-1.png

  4. Настройте отправку POST-запроса в Roistat при совершении действия со сделкой в CRM, используя метод /project/events/send. В разных CRM настройка событий по сделкам может отличаться. Пример настройки в amoCRM:

    • В личном кабинете перейдите в раздел Сделки → Настроить и кликните по этапу, на котором вы хотите настроить событие:

      6-1.png

    • Выберите опцию Отправить Webhook, укажите условия срабатывания события и URL, на который будет отправлен вебхук amoCRM:

      7-1.png

    • На указаном URL нужно создать обработчик, который должен получать вебхук от amoCRM и отправлять POST-запрос с данными из вебхука на сервер Roistat. Для отправки данных о событии используйте метод /project/events/send. При необходимости обратитесь за помощью к разработчику.

    Каждое срабатывание события будет отображаться в Истории срабатываний.

  5. Уже созданные события можно отредактировать или удалить на странице настроек:

    4-1.png

Передача события через API

При необходимости вы можете настроить отправку события через API:

  1. Создайте событие с любым условием срабатывания. Например, можно использовать условие Передается через JavaScript – это не значит, что обязательно нужно настраивать передачу через JavaScript. В данном случае нужно только создать событие с уникальным названием, которое затем будет использоваться в теле запроса.
  2. Настройте отправку POST-запроса при совершении целевого действия. Для этого используйте метод /project/events/send.

Как проанализировать события

С помощью предустановленных отчетов по событиям можно проанализировать взаимодействие пользователей с сайтом, чтобы повысить его удобство.

Доступны следующие отчеты:

Также вы можете смотреть статистику по Событиям в отчетах Аналитики. Доступны следующие показатели:

  • Название события – показывает, сколько раз произошло событие (в том числе учитываются повторные действия, совершенные одним и тем же пользователем).

  • Название события (пользователи) – количество уникальных пользователей, вызвавших событие.

    Пример для события Клик по кнопке: Клиент 1 кликнул по кнопке три раза, а Клиент 2 – один раз. В этом случае показатель Клик по кнопке будет равен 4, а Клик по кнопке (пользователи) – 2 (по количеству уникальных пользователей).

  • Конверсия в Название события – доля события от общего числа визитов. Рассчитывается по формуле: Название события / Визиты * 100%

  • Стоимость Название события – стоимость привлеченного события. Рассчитывается по формуле: Расходы / Название события

  • Всего событий – общее количество срабатываний всех событий, настроенных в проекте.

  • Всего событий (с уникальным пользователем) – общее количество срабатываний всех событий с уникальным номером визита.

Если в отчете выбрана группировка по дате события, будет учитываться дата, в которую сработало событие (независимо от того, когда был совершен визит на страницу).

Если выбрана группировка по дате визита, показатели по событиям будут отображаться с пометкой (по дате события). Будет учитываться дата, в которую был совершен визит, связанный с событием (даже если событие сработало позднее даты визита). Если к событию не привязан визит, будет учитываться дата срабатывания события.

Как просмотреть историю срабатываний

История срабатывания событий отображается на вкладке История срабатываний:

8-1.png

Для каждого срабатывания отображается следующая информация:

  • Название – уникальное название события в системе Roistat;
  • Дата и время – дата и время срабатывания события;
  • Условие – способ передачи данных о событии;
  • Параметр – ID события или регулярное выражение;
  • ID визита – номер визита на сайте (из куки roistat_visit);
  • Доп. поля – дополнительные данные о событии: URL ссылки или значение параметра data. Например, http://example.comтовар.

Вы можете быстро скопировать содержимое ячейки, кликнув по тексту в ней.