Full Stream Attribution (FSA) в VK Рекламе

Что это

Технология прямой передачи событий с сайта или приложения рекламодателя в рекламную систему VK, без посредников и трекинговых платформ. События FSA не заменяют существующие, а дополняют их: мобильные (из трекера) или веб-события (из пикселя VK Рекламы). Аудиторию динамического ретаргетинга они обогащают и дают более точную атрибуцию.

Где доступна

• Реклама сайтов и мобильных приложений с типом «Динамический ретаргетинг».
• Оптимизация кампании направлена только на Покупку, поэтому аудитория динамического ретаргетинга должна быть достаточно широкой. Отсюда пожелание про аудиторию от 500 000 уникальных пользователей в месяц.

Что даёт и чем ограничено

• Идентификатор пользователя — номер телефона. Работает без cookies и device_id, то есть в обход ограничений Privacy, поэтому учитывается больше действий и конверсий.
• События доходят до профиля за время до 90 секунд, а не за 4–6 часов, как при стандартной интеграции. Алгоритмы быстрее обучаются, оптимизация начинается раньше.
• Больше данных для обучения рекламной модели, выше точность подбора аудитории.
• Ограничение: при интеграции через FSA номер телефона передаётся только на оформлении заказа или покупке, то есть на позднем этапе воронки.

Как подключить и этапы

• Запрос доступа: персональный менеджер VK или обращение в поддержку VK Рекламы. Доступ открывают после завершения технической интеграции и проверки поступления событий.
• Шаг 1, подготовка кабинета: партнёр создаёт отдельный новый кабинет специально для FSA (в нём подключаются форматы для атрибуции по номеру телефона и передачи данных о конверсиях), привязывает мобильные приложения и (или) пиксель VK, добавляет продуктовый фид и передаёт ID кабинета ответственному менеджеру VK.
• Шаг 2, токен: VK генерирует FSA-токен для авторизации при передаче событий и отдаёт его по одноразовой ссылке, которая действует 4 дня.
• Шаг 3, привязка и атрибуция: на стороне VK кабинет связывают с событиями FSA и настраивают окно атрибуции для purchase (по умолчанию 7 дней, другое — по запросу партнёра).
• Шаг 4, события у партнёра: после получения токена настраивают передачу событий. При корректной отправке событие получает статус «200 OK». При ошибках проверяют запрос на своей стороне или обращаются к менеджеру VK.
• Шаг 5, проверка и форматы: VK проверяет поступающие события; при успешной интеграции открывается возможность запускать FSA.
• Шаг 6: партнёр запускает рекламные кампании.

Подготовка кабинета: Web

• Создать отдельный кабинет для FSA; допускается общий кабинет вместе с Mobile-размещением FSA.
• Добавить действующий пиксель VK Рекламы с настроенными событиями динамического ретаргетинга. Нет активного пикселя — создать новый в кабинете; устанавливать его на сайт не нужно, события приходят через FSA.
• Действующий пиксель: оптимизация идёт одновременно по событиям пикселя и по атрибуции FSA, обучение ускоряется. Новый пиксель: оптимизация только по событиям FSA.
• Для динамического ретаргетинга на сайтах желательно брать действующий пиксель с настроенными событиями: телефон приходит только на позднем этапе воронки, и без пикселя аудитория может получиться слишком узкой.
• В пикселе должны быть JS-события viewOffer (просмотр карточки товара), addToCart (добавление в корзину), addToWishlist (добавление в избранное), purchase (покупка). Существующие повторно не создают. Названия строго как в списке.
• В разделе «Центр коммерции» добавить каталог товаров, рекомендуется полный фид со всеми товарами, и связать каталог с источником событий — пикселем VK Рекламы.

Подготовка кабинета: Mobile

• Создать кабинет для интеграции с FSA; допускается общий с Web-размещением.
• Привязать мобильные приложения к кабинету VK.
• В мобильном трекере заранее настроить и держать активными события четырёх категорий: просмотр карточки товара, добавление в корзину, добавление в избранное, покупка. Они нужны динамическому ретаргетингу и должны корректно уходить из трекера.
• Добавить каталог с мобильными параметрами (трекинг-ссылки, диплинки, идентификаторы мобильных приложений), рекомендуется полный фид, и связать каталог с источником событий — мобильными приложениями.

Как отправлять события

• Вся интеграция делается на стороне партнёра, нужен бэкенд-разработчик: собирать события на сайте или в приложении, хэшировать телефоны, формировать JSON, отправлять POST на https://fsa.mail.ru/fsa.
• Каждое событие — отдельный JSON. Массивы и несколько товаров в одном запросе не поддерживаются.
• Все данные в UTC в виде Unix timestamp.
• Авторизация: заголовок Authorization: Token ACCESS_TOKEN, токен приходит от VK по одноразовой ссылке.
• Телефон хэшируют до отправки (MD5 или SHA-256) из формата 79XXXXXXXXX. В открытом виде номера не хранятся; одинаковые номера дают одинаковый хэш, по нему формируется универсальный идентификатор hid.
• Название события передают строго по документации, в productId — ID товара из каталога, по одному товару в запросе.
• Пример purchase из справки: {"phone_md5": "820b5ef76357a7c4eda34c5f9a7f4e06", "platform": "ios", "event": {"customEventName": "purchase", "customEventParams": {"productId": "447358737", "value": "289.00"}, "eventTimestamp": "1732204800"}}

Пакетная отправка

• Адрес: https://fsa.mail.ru/fsa-batch, авторизация та же, что для одиночных событий.
• Формат — массив одиночных JSON-объектов, каждый — обычное сообщение FSA.
• Размер пакета — не более 1 МБ.
• Успешный ответ — 200 OK, тело с полем result со значением ok.

Запуск кампаний

• Когда отправка настроена, партнёр сообщает об этом ответственному менеджеру VK (персональному или назначенному по обращению через форму) для проверки поступления событий.
• Если события принимаются без ошибок, в кабинете открывается доступ к созданию FSA-кампаний.
• При создании кампании включают ползунок «Атрибуция по номеру телефона (FSA)»: он связывает кампанию с передаваемыми событиями.
• Остальные шаги и параметры — как в стандартной схеме создания товарных кампаний VK Рекламы.

Кейсы

В конце страницы справки даны ссылки на кейсы рекламодателей Lamoda и «Читай-город», использовавших FSA.