var _tmr = window._tmr || (window._tmr = []);
_tmr.push({ type: 'setUserID', userid: "UserID" });
Установите код веб-счётчика на все страницы вашего сайта.
Код должен быть размещён внутри блока HEAD или BODY, как можно ближе к началу страницы.
Вы можете разместить код самостоятельно, использовать Google Tag Manager или официальный плагин для WordPress, 1С-Битрикс, Joomla и OpenCart.
Скопировать код можно со страницы Веб-счётчик приложения в MyTracker.
Для получения статистики не только по устройствам, но и по пользователям сайта, установите параметр UserID.
Это уникальный идентификатор пользователя в вашем проекте,
который должен оставаться неизменным, даже если пользователь авторизуется на другом устройстве.
Установив этот параметр, вы сможете оценить размер и активность аудитории приложения, вне зависимости от того,
сколько устройств использует пользователь.
А также не будете терять историю накопленных по пользователю данных, если он решит сменить устройство. Подробнее см. раздел Трекинг.
Важно установить параметр до трекинга целей,
чтобы передавать идентификатор пользователя с каждым отслеженным действием.
Для установки UserID используйте строку _tmr.push:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({ type: 'setUserID', userid: "UserID" });Чтобы отключить трекинг пользователей удалите UserID:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({ type: 'deleteUserID' });Рекомендуем установить идентификатор описанным выше способом, но если на веб-страницах установлено несколько счётчиков,
то можно передать UserID отдельным параметром в строке _tmr.push:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({id: "counter ID", type: "pageView", start: (new Date()).getTime(), userid: "UserID" })
Если до установки UserID в приложении уже сформирована база зарегистрированных пользователей,
то MyTracker не сможет получить данные о времени их регистрации,
а значит определить дату первого посещения и произвести точный расчёт Lifetime метрик.
Для таких пользователей Lifetime статистика будет считаться на дату первого полученного события с UserID (первой отслеженной цели или просмотра страницы).
Чтобы собирать данные о действиях посетителей на вашем сайте, настройте отправку целей, используя методы JavaScript. Для этого вам необходимо написать скрипт, который определяет факт достижения цели и отправляет информацию об этом на сервер.
Не стоит путать термины Цели и События в Рейтинге Mail.Ru.
Цели соответствуют событиям в MyTracker, это регистрация, авторизация и кастомные события. События, например, доскрол и ошибки на страницах, не фиксируются трекером.
Передавать цели в MyTracker также можно через S2S API
Для сбора данных о регистрации пользователей разместите в начале вашей страницы актуальный код счётчика и в момент регистрации отправьте цель mt_registration, выполнив JavaScript код:
_tmr.push({ id: 'counter ID', type: 'reachGoal', goal: 'mt_registration', userid: 'UserID' });
Для сбора данных об авторизации пользователей разместите в начале вашей страницы актуальный код счётчика и в момент авторизации отправьте цель mt_login, выполнив JavaScript код:
_tmr.push({ id: 'counter ID', type: 'reachGoal', goal: 'mt_login', userid: 'UserID' });Для сбора данных о любом произвольном событии (например, добавление товара в корзину, достижение уровня в игре и пр.) разместите в начале вашей страницы актуальный код счётчика и в момент достижения цели выполните следующий JavaScript код:
_tmr.push({ id: 'counter ID', type: 'reachGoal', goal: 'customEvent' });
Имя цели goal для кастомного события должно состоять из латинских букв или цифр.
Мы рекомендуем использовать то же имя, которое задано для аналогичного события в мобильном SDK,
чтобы упростить анализ данных, полученных с разных платформ вашего проекта.
Готовый JavaScript код можно получить в Рейтинге Mail.ru, подробнее см. раздел документации События из javascript. Если вы хотите передать версию приложения, параметры или ценность кастомного события, то доработайте код вручную, как это описано ниже.
С кастомным событием можно передать параметры цели.
Например, для события «Заказ» это могут быть идентификатор заказа, условия доставки и пр.
Для передачи параметров добавьте поле params:
var EventParams = { logged: true, ... };
_tmr.push({ id: 'counter ID', type: 'reachGoal', goal: 'customEvent', params: EventParams });В качестве значения params может быть передан любой JavaScript-объект с одним уровнем вложенности.
Параметры можно передать только по кастомным событиям, но не по регистрациям и авторизациям пользователей
Для кастомных событий вы можете задать своё значение Ценности.
Передавать ценность можно для любого кастомного события, оно не обязательно должно быть финансовым. Например, достижение определённого уровня в игре может иметь для вас большую ценность, чем социальные действия внутри игры, так как указывает на заинтересованность пользователя.
Передать ценность можно через поле value:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({ id: "counter ID", type: "reachGoal", goal: "customEvent", value: 50 });Статистику по ценности кастомных событий можно получить через Raw API.
Ценность можно передать только по кастомным событиям, но не по регистрациям и авторизациям пользователей
С каждой целью можно передать стандартный параметр — версия приложения. Например, для сбора данных по разным версиям одностраничного приложения (single-page application) и проведения a/b тестов.
Передать версию приложения можно через поле version:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({ id: "counter ID", type: "reachGoal", goal: "customEvent", version: "1.2.3-rc4" });Часть событий веб-счётчик может отправлять в MyTracker автоматически. С вашей стороны не требуется добавления дополнительного кода, достаточно включить настройку в интерфейсе MyTracker:
Если тумблер включён, то счётчик, размещённый на страницах сайта, будет автоматически отслеживать следующие события:
После переключения тумблера для старта или остановки процесса может потребоваться до 4 часов
Проанализировать собранные данные можно с помощью разреза «Название автоматического события», метрик «Автоматические события» и одноимённого фильтра. Подробнее см. раздел Веб-трекинг.
Если ваш сайт — это интернет-магазин или другой сервис электронной торговли, то вы можете настроить трекинг событий Ecommerce: оформление заказа, добавление товара, частичная или полная оплата, отмена и возврат товара.
Для сбора данных нужно добавить дополнительный код на ваш сайт и разметить события. Инструкцию см. в разделе Ecommerce.
Для передачи данных в MyTracker можно использовать S2S API. Например для отправки офлайн событий или неотслеживаемых счётчиком данных.
Чтобы передавать данные через S2S API вам может понадобится
специальный идентификатор устройства — lvid.
Важно как можно раньше начать собирать lvid и отправлять их на ваш сервер,
если вы будете использовать его для S2S API.
Вместо lvid в запросах к API
можно указывать идентификатор пользователя UserID,
но в этом случае данные будут формировать только статистику по пользователю,
а не по устройству. Подробнее
Получить lvid можно с помощью следующего javascript кода:
_tmr.getClientID();
Метод getClientID доступен только после того, как счётчик прогрузится на страницу.
Поэтому рекомендуем использовать функцию callback,
которая вызовет метод лишь при полной загрузке счётчика:
var _tmr = window._tmr || (window._tmr = []);
_tmr.push({
type: 'onready',
callback: function() {
tmrLvid = _tmr.getClientID();
/* здесь ваш код отправки lvid на сервер */
}
});
Вне зависимости от используемого javascript кода,
идентификатор lvid будет передан только в том случае,
если в браузере пользователя не установлен блокировщик рекламы,
и счётчик успел прогрузиться полностью
Чтобы получать данные о просмотрах из регионов, в которых доступ к сервисам VK ограничен, используйте альтернативный CDN — переключите код счётчика на COM домен.
Подробнее см. раздел Альтернативный CDN
