Веб-счётчик Sber Ads: параметры, методы, debug-режим, сплиты и хэши

Как устроен веб-счётчик

Базовый набор отслеживаемых событий настраивается в интерфейсе Статистики. Чтобы расширить состав, например добавить отслеживание кликов по нужным элементам интерфейса, правят сгенерированный код счётчика: добавляют вызов нужных функций и определяют нужные атрибуты. Для каждого экземпляра счётчика на странице можно вызывать разные методы и переопределять разные параметры из числа поддерживаемых.

Перед вызовом любого метода нужно убедиться, что экземпляр счётчика создан и доступен. Если его ещё нет, данные не собираются: их не с чем связать.

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

Справка выделяет четыре вида идентификаторов:

Авторизованного пользователя передают методом syncUserId: он принимает идентификатор и отправляет его в счётчик, так что можно переопределить user_id из настроек инициализации. Если человек вышел из аккаунта, передают null. Чтобы статистика строилась в разрезе пользователей, им нужно присвоить уникальные идентификаторы и включать их в данные, которые уходят в счётчик.

Передача user_id создаёт базовое событие login, передача null — базовое событие logout.

Условие для syncUserId: параметр user_id должен быть указан в коде счётчика при инициализации. Если пользователь на тот момент неизвестен, указывают null. Без этого при вызове метода в консоли появится предупреждение.

Три сценария из справки:

1. Человек вышел из аккаунта: вызывают syncUserId с null. 2. Пришёл незалогиненным и вошёл на сайте: при инициализации user_id равен null, после входа через syncUserId передают нужный идентификатор. 3. Пришёл залогиненным, вышел и вошёл снова: при инициализации указан исходный идентификатор, затем через syncUserId передают null (если нужно) и после повторного входа новый идентификатор.

Остальные идентификаторы (например ramblerId) передают методом updateOptions. pub_id и pub_scope можно задать и в параметрах счётчика при инициализации. Чтобы прочитать идентификатор площадки и его область применения, служит getPublisherId: он возвращает строковые значения id и scope.

Другие методы

• updateOptions принимает объект с параметрами, которые нужно обновить. Метод обновляет ограниченное число параметров конкретного счётчика; с его помощью можно также установить email пользователя. В примерах справки им задают pub_id и email.
• getAdtechId возвращает first-party идентификатор, сформированный счётчиком.
• sendBlocks дополнительно ищет на странице элементы, размеченные для аналитики блоков, и отправляет по ним данные. В метод можно передать DOM-элемент: контейнер, внутри которого ищутся показанные блоки.
• drawLogoTo вызывают на каждой странице, где нужен виджет, передавая идентификатор элемента, в который он рисуется. Тот же идентификатор можно задать параметром element при инициализации.

Цвет виджета

Параметр widgetColor задают в параметрах счётчика, по умолчанию виджет синий. В справке есть таблица готовых значений: код цвета и картинка с вариантом виджета. Всего в таблице 113 кодов, например 000000, 0c797d, 4c5ad4, 9f0500, ab149e, fcdc00.

Debug-режим

Debug проверяет, как работает счётчик и какие у него параметры. Его включают, добавив в адрес страницы GET-параметр ?_top100_debug=1. После этого:

• на странице появляется эмблема кракена;
• в DevTools, вкладка Console, идёт журнал событий: название счётчика, его параметры и действия;
• если используется аналитика блоков, по клику на иконку кракена можно выбрать, показывать ли блоки.

Выключают режим параметром _top100_debug=0. Справка предупреждает, что при включённом блокировщике рекламы функции могут работать нестабильно.

Сплиты

Отчёты Статистики можно разбивать по сплитам. Для этого в параметре splits передают массив активных сплитов: одно или несколько значений, например два названия в массиве. События на странице соотносятся с этим набором.

Названия сплитов: символы a-z, A-Z, 0-9 и «_», длина не более 64. Если названия не подходят, данные сервер не обсчитывает.

Учёт хэшей

Чтобы хэши из навигации по сайту попадали в статистику, в настройках счётчика включают trackHashes со значением true. После этого данные о хэшах появляются во всех отчётах, где показаны полные URL страниц, например: «Популярное», «Страницы входа», «Страницы выхода», «Разделы сайта».

Хэш в URL учитывается, если на странице нет элемента с id, равным хэшу (иначе считается, что это якорная ссылка). Поэтому mysite.com#hash1 и mysite.com#hash2 считаются разными страницами.