Разметка писем, пиксели, deeplink и предупреждение о cookies в Статистике Sber Ads
Рассылки размечают пикселем-картинкой в коде письма: event_type=email, event_name любое, project_id — номер счётчика, случайные session_id, request_id и event_id, плюс meta с темой письма, блоком, заголовком, картинкой или ссылкой. Пиксели и события из приложений уходят HTTPS-запросом на kraken.rambler.ru/cnt/v2/. На сайте со счётчиком в тексте про cookies нужна ссылка на соглашение и упоминание счётчика и передачи данных трём компаниям.
Цифры
Параметры пикселя письма
| Параметр | Формат | Что передают |
|---|---|---|
| event_name | String | название события, подойдёт любое, например show или send |
| event_type | String | значение email |
| counter_type | String | значение email (так в таблице; в примерах адресов стоит pixel) |
| project_id | Number | номер счётчика |
| session_id | String | идентификатор сессии: случайное значение, одинаковое для всех пикселей одного письма |
| request_id | String | идентификатор просмотра: случайное значение |
| event_id | Number | идентификатор события: случайное числовое значение |
| meta | JSON | дополнительные сведения о рассылке |
Данные в meta
| Параметр | Формат | Что означает |
|---|---|---|
| title | String | тема письма |
| blockName | String | название блока в письме |
| heading | String | заголовок новости, материала или ссылки |
| image | String | наличие картинки: true/false (0/1) |
| url | String | ссылка для перехода (в скобках справка указывает attachment: true/false (0/1)) |
Пиксели для событий в приложении
| Пример | Параметры |
|---|---|
| Сбор показов с креатива | project_id, event_id, request_id, counter_type=pixel, event_type=base, event_name=page_view |
| Просмотр с наименьшим достаточным числом параметров | project_id, session_id, event_id, request_id, counter_type=pixel, event_type=base, event_name=page_view |
Подробности
Разметка писем
Счётчик умеет собирать статистику email-рассылок: по ней оценивают эффективность писем и находят ошибки. В код письма вставляют изображение-пиксель, адрес которого содержит параметры из таблицы выше. Название события выбирают сами, а event_type всегда email.
Параметры, которые идут внутри meta, должны быть закодированы. Справка даёт по одному примеру вставки для каждого из пяти полей meta: title, blockName, heading, image, url.
Пиксели и события из приложений
Данные о событиях в приложении можно отправлять прямо на серверы Статистики от SberAds HTTPS-запросами вида адрес и параметры через знак вопроса. Справка показывает два примера: сбор показов с креатива и просмотр с минимальным набором параметров. В обоих event_type=base и event_name=page_view, а в event_id, request_id и session_id (где он есть) стоят случайные значения.
Deeplink
Deeplink — гиперссылка, которая ведёт сразу в нужный раздел приложения или сайта. Он нужен, чтобы вместо приложения не открывалась веб-версия, а вместо конкретного раздела — главная страница сайта.
При клике ресурс, создавший ссылку, определяет операционную систему и тип программы и направляет в нужный раздел сайта, в приложение или в магазин приложений Google Play либо App Store.
| Откуда открыта ссылка | Что происходит |
|---|---|
| Смартфон, приложение установлено | открывается нужный раздел приложения |
| Смартфон, приложения нет | открывается страница приложения в магазине |
| Десктоп | ссылка открывается в браузере |
Статистика от SberAds поддерживает deeplink. Настройка для iOS и Android описана в отдельных разделах «Отправка событий о переходе по deeplink».
Предупреждение о cookies
Справка даёт пример короткого текста для сайта: сообщение, что используются cookies, и что продолжение работы с сайтом означает согласие с условиями их обработки. К примеру два условия:
1. В словах «условия обработки cookies» нужна гиперссылка на пользовательское соглашение ресурса или на условия обработки cookies, если они оформлены отдельным документом. 2. Владелец ресурса сам добавляет в пользовательские документы информацию об использовании счётчика «Статистики от SberAds» и о передаче пользовательских данных ООО «РА «Индекс 20», ПАО Сбербанк и ООО «Облачные технологии».
Важно знать
- Параметр counter_type в таблице разметки писем описан со значением email, а во всех пяти примерах адресов стоит counter_type=pixel. На странице про пиксели приложений тоже pixel. Какое значение принимается для писем, справка не объясняет, проверять по данным в Статистике. Кроме того, в таблице имя параметра начинается с кириллической «с», в примерах адресов написано латиницей.
- Параметр meta в таблице входит в блок «Дополнительные технические параметры (обязательные)», хотя поля внутри meta названы данными, которые «можно передать». Обязательно ли непустое meta в каждом письме, справка не уточняет.
- Для url описание («ссылка для перехода») и формат записи (true/false, 0/1, в примере True/False) не совпадают: что именно передавать, ссылку или признак, из текста не понять. Для image записи разные тоже: «true/false (0/1)» в таблице и True/False в примере.
- Примеры вставки показаны не в закодированном виде, хотя рядом сказано, что meta должно быть закодировано, а JSON в них записан с закрывающей круглой скобкой. Брать их как образец структуры, не как готовый код.
- В примере для показов креатива нет session_id, а в «наименьшем достаточном» примере он есть; почему так, справка не поясняет.
- Страницы про пиксели и письма не показывают, как выглядят отчёты по этим данным и где их смотреть.
- Раздел про deeplink отсылает к страницам для iOS и Android; самих шагов настройки в этой статье нет. Событие «Переход по ссылке в приложении (deeplink)» по другой странице справки нужно вызывать самостоятельно.