Выгрузить статистику по посещениям

GET /stats/users/visits

Запросом можно получить статистику о посещении участниками мероприятий за указанный период.

МЕТОД HTTP

GET

URL

https://userapi.mts-link.ru/v3/stats/users/visits

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • from — дата начала периода выборки. Формат:  yyy-mm-dd+hh:mm:ss. Без этого параметра запрос отработает от текущей даты и времени.

  • email - Email участника, статистику которого необходимо получить (вместо email можно также использовать contactId - ID контакта участника).

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • to — дата окончания периода выборки.  
    Формат: yyy-mm-dd+hh:mm:ss.
    По умолчанию: from + 1 год.

  • eventId — EventID мероприятия. Позволяет получить данные о конкретном мероприятии.
    Внимание! Мероприятие должно проходить в рамках from и to, иначе выборка будет пустой и в ответ придет 404.

.

ПОЛЯ ОТВЕТА

  • registered — информация о мероприятиях, на которые зарегистрирован участник. Формат данных:
    - id — ID eventsession мероприятия;
    - name — название мероприятия;
    - additionalFieldValues — данные регистрационных форм. Где:
                    - label — вопрос регистрационного поля;
                    - value — ответ участника;
                    - referrer — источник перехода на форму регистрации;

  • not_visited — информация о мероприятиях, которые участник не посетил, но на которые его пригласили. Формат данных:
    - id — ID eventsession мероприятия;
    - name — название мероприятия;

  • visited — информация о мероприятиях, которые участник посетил. Информация о каждом мероприятии передается в следующем формате:
    - id — ID eventsession мероприятия;
    - name — название мероприятия;
    - referrer — источник перехода на форму регистрации;
    - userQuestionCount — количество заданных вопросов;
    - userChatMessageCount — количество написанных сообщений;

    - actualParticipantActivityPercent — процент присутствия от активного времени ведущих;

    - usersReactionClicks — количество нажатий на огонёк;

    - percentOfTotalReactionClicks — процент нажатий на огонёк данного участника, от общего количество нажатий;

    - actualInvolvement — фактическая активность (время, которое участник был на мероприятии и не переключался на другие вкладки, другие программы, не выключал звук у ведущих);

    - attentionControl - данные модуля контроля присутствия. Для каждого из участников отображаются следующие данные:
    - percent — процент подтверждённых окон, от общего количества.
    - shownCount — общее количество окон подтверждения;
    - confirmedCount — количество окон, подтверждённых участником;
    - connections — информация о каждом подключении пользователя. Формат:
                    - joined — время подключения;
                    - leaved — время выхода;
                    - duration — продолжительность сессии;
                    - country — страна, из которой было подключение;
                    - city — город, из которого было подключение;
                    - referrer — источник перехода;
                    - platform — устройство, с которого было подключение.

    - rating - рейтинг участника;
    - utms — массив данных о полученных utm-метках. Передаются следующие данные, если они есть:
    - utm_source

    - utm_medium

    - utm_campaign

    - utm_content

    - utm_term

    - utm_custom - все прочие метки.

ПРИМЕР ЗАПРОСА

url: https://userapi.mts-link.ru/v3/stats/users/visits?from=2019-05-17&email=i.ivanov@webinar.ru&eventId=2356719,
method: GET,
headers:
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
};

 

ПРИМЕР ОТВЕТА

200 - OK            
{
  "registered": [
    {
      "id": "2399983",
      "name": "User API",
      "referrer": "mail.google.com"
    }
  ],
  "not_visited": [],
  "visited": [
    {
      "id": "2399983",
      "name": "User API",
      "referrer": "mail.google.com",
      "userQuestionCount": 0,
      "userChatMessageCount": 9,
"actualParticipantActivityPercent": 98.74,
"usersReactionClicks": 0,
"percentOfTotalReactionClicks": "0.00",
"actualInvolvement": "32.77",
"attentionControl": 9 {
"shownCount": 6,
"confirmedCount": 6,
"percent": "100,00"
}
      "connections": [
        {
          "joined": "2019-05-17T16:26:16+0300",
          "leaved": "2019-05-17T16:45:00+0300",
          "duration": 1124,
          "country": "Russia",
          "city": "Moscow",
          "referrer": "mail.google.com",
          "platform": "Web"

        }

                        ],
"rating": 17,
"utms": []
    },
               ]
}            

👆 На этом пока всё