События веб-счётчика Статистики от SberAds: просмотр страницы и собственные события

Уведомление о загрузке счётчика

Чтобы код страницы узнал, что счётчик загрузился, в настройки добавляют параметр checkInit со значением true и подписываются на событие страницы с именем «initKraken» и номером счётчика на конце. После срабатывания события можно обращаться к созданному объекту счётчика.

Просмотр страницы в одностраничном сайте

Метод нужен для SPA, чтобы статистика считалась корректно: вызов добавляют в те моменты, когда нужно зафиксировать показ новой страницы.

• Необязательный параметр — URL страницы. Если его не передать, счётчик берёт адрес из location.href без хэша.
• Чтобы хэши учитывались, нужно включить опцию учёта хэшей (отдельная страница справки, в этой статье не разбирается).

Собственные (целевые) события

Метод reachGoal отправляет событие в счётчик, номер которого указан в вызове. Правила из справки:

• Номер счётчика должен принадлежать счётчику, который реально стоит на той же странице, откуда идёт вызов, иначе событие в статистику не попадёт. Номер найдётся на странице «Мои сайты».
• Если вызов может сработать раньше, чем загрузится скрипт счётчика, заранее создают очередь-заглушку window.top100d: накопленные команды выполнятся сразу после загрузки скрипта. Если скрипт уже загружен, команда выполняется сразу.
• Название события с кириллицей или спецсимволами не засчитывается. Пробелы заменяются на нижнее подчёркивание сами, но справка советует называть события без пробелов.
• Минимальный вызов — номер счётчика, `'reachGoal'` и название события; данные события добавляют по необходимости.

Несколько счётчиков на странице

Один вызов отправляет событие ровно в один счётчик, режима «сразу во все» нет. Справка предлагает завести вспомогательную функцию со списком номеров всех установленных счётчиков и в ней вызывать метод по очереди для каждого номера. Список в функции должен совпадать со счётчиками, которые стоят на странице. Блок можно разместить в head или перед закрывающим body. Установка нескольких счётчиков разобрана в отдельной статье.

Цель в кабинете

Для события с таким названием цель нужно создать в кабинете каждого счётчика. Если цели нет, событие дойдёт в лог счётчика, но целевым не станет.

События аналитики блоков: показ и клик

Эта часть относится к отчёту «Аналитика блоков». Собираются только показы блоков и клики по ним.

1. Блоки, по которым нужна статистика, помечают data-атрибутами формата «data-название». Названия атрибутов перечисляют в параметре attributes_dataset кода счётчика — при создании счётчика в интерфейсе или вручную в уже установленном коде. 2. Вложенность строят вложенными контейнерами с одним и тем же data-атрибутом. Клик по вложенному блоку записывается цепочкой: имя атрибута, затем имена контейнеров и блока через «::». 3. Вложенность можно «эмулировать» без привязки к разметке: на один элемент ставят всю цепочку, начиная со 2-го уровня, через «::». 4. Параметр common_attributes отправляет указанные атрибуты сразу во все счётчики на странице. 5. Метод sendBlocks запускает дополнительное сканирование блоков и отправку новых показанных блоков; ему можно передать контейнер, внутри которого искать. 6. Внутри ShadowDOM блоки не отслеживаются. Для таких элементов есть метод trackUBEvent: ему передают действие («show» или «click»), элемент и необязательный флаг принудительной отправки накопленных событий.

Как считаются значения:

• показы блока с дочерними элементами = максимум показов среди дочерних + собственные показы блока;
• клики блока с дочерними элементами = сумма кликов по дочерним + собственные клики;
• CTR считается для каждого уровня отдельно как клики к показам;
• если у родителя и наследника разные data-атрибуты, клик по наследнику засчитывается и родителю (клик «поднимается» вверх по дереву);
• при перерисовке элемента показы отправляются повторно, так как элемент становится новым.

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