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

Команды для отправки событий через Web SDK

Краткое содержание

User Id
Устанавливает идентификатор пользователя для отслеживания действий. Используется команда ma('setUserId', '<USER_ID>').

Pageview
Отправляет данные о просмотре страницы. Пример: ma('pageview', { category: "Videos", action: "View", label: "Toy Story" }).

Custom message
Отправляет произвольное событие, например, youtube_video, с параметрами, такими как категория, действие и метка.

Trigger message
Используется для триггерных событий, например, ma('trigger', 'START', { time: 3600 }). Позволяет управлять таймером (START, STOP, DONE).

Параметры сообщения
Содержит специальные поля для дополнительной информации:

  • location — URL страницы (по умолчанию document.location.href).
  • title — заголовок страницы (по умолчанию document.title).
  • notInteraction — указывает, является ли событие интерактивным (по умолчанию true).
  • external — флаг для событий из внешних источников (например, iFrame).

Вы можете задать команды отправки событий в библиотеку МТС Аналитики и внести их напрямую в код.

User Id​

Задает идентификатор пользователя

ma('setUserId', '<USER_ID>');

USER_ID — идентификатор пользователя.

Pageview​

Отправляет информацию о просмотре страницы

ma('pageview', <MESSAGE_PARAMS>);

MESSAGE_PARAMS — произвольные объект. Например, { category: "Videos", action: "View", label: "Toy Story" }.

Custom message​

Отправляет произвольное событие, которое определяет взаимодействие пользователя с интерфейсом

ma('message', <EVENT_NAME>, <MESSAGE_PARAMS>);

EVENT_NAME — имя события. Например, youtube_video.

MESSAGE_PARAMS — параметры события, задаются произвольно. Например: { category: "Videos", action: "View", label: "Toy Story" }.

Trigger message​

Команда отправки триггерных событий

ma('trigger', <TRIGGER_NAME>, <TRIGGER_PARAMS>);

TRIGGER_NAME — имя триггера.

TRIGGER_PARAMS — объект типа { status: "DONE", time: 3600 }, где

  • status — cтатус триггера, например «START», — начать отсчёт таймера, «STOP» — остановить отсчёт таймера, «DONE» — триггер сработал.
  • time — время до тайм-аута, передается в секундах (необязательный параметр).

Параметры сообщения​

MESSAGE_PARAMS — произвольные параметры для каждого события.

Ниже перечислены специальные поля, при установке они будут передаваться с каждым событием в специальном поле мета-информации.

location​

Позволяет указать URL страницы. Если параметр не задан, берется текущее значение document.location.href

ma('pageview', {location: 'http://mts.ru'});

title​

Позволяет указать заголовок страницы. Если параметр не задан, берется текущее значение document.title

ma('pageview', {title: 'YourBrand'});

notInteraction​

Указывает, событие интерактивное или неинтерактивное. По умолчанию все события передаются со значением true. false — обозначает, что событие не интерактивно (не связано с действиями пользователя)

ma('pageview', {notInteraction: true});

external​

Указывает, что событие пришло из внешнего источника, например, из iFrame. По умолчанию — false

ma('pageview', {external: true});