MMP постбек в CAPI: как событие MMP становится серверным событием платформы
MMP постбек и CAPI-пейлоад описывают одну конверсию на разных языках, и переводит их Conversions API-маппинг, описывающими одну конверсию. Мобильный измерительный партнёр - AppsFlyer, Adjust - говорит на своей грамматике постбеков: свои имена событий, свои атрибутивные идентификаторы, свои поля выручки. Conversions API платформы - Meta, TikTok, Snap, Reddit, Pinterest - ждёт свои имена полей, свои правила хеширования, свои ключи дедупликации. Слой маппинга превращает одно в другое, не теряя идентичность и не удваивая счёт.
Два словаря
| Концепт | MMP-постбек | CAPI-пейлоад платформы |
|---|---|---|
| Идентичность конверсии | Идентификатор события или транзакции MMP | event_id / семейство client_dedup_id |
| Имя события | In-app имя события MMP | Enum-значение платформы или кастомное имя |
| Выручка | Поле revenue и валюта постбека | Поля value и currency пейлоада |
| Идентичность пользователя | Девайс-идентификаторы (GAID/IDFA), хешированные контакты, если собраны | user_data: хешированные email/телефон, мобильные ID |
| Клик-атрибуция | Атрибутивная запись MMP | Собственный клик- или куки-идентификатор платформы |
Маппинг детерминирован по дизайну: для одной измеренной конверсии один и тот же постбек всегда должен давать один и тот же пейлоад. Любое творчество в этом слое - свежие идентификаторы на каждую отправку, плывущие имена событий - всплывает позже как двойной счёт или потери матчинга на стороне платформы.
Какие поля несут основной вес
Идентичность конверсии маппит транзакционный или событийный идентификатор MMP в дедуп-поле платформы - event_id у Meta, client_dedup_id у Snap, conversion_id у Reddit. Это значение, которое потребляет задача дедупликации платформы, и оно обязано совпадать с тем, что посчитал браузерный тег для той же конверсии. Идентификаторы пользователя маппятся в семейство user_data: хешированные email и телефон, где приложение их собрало, и мобильные идентификаторы - Snap документирует madid в lowercase без хеша, плюс idfv и anon_id для app-событий, - которые app-атрибуция потребляет напрямую. Ссылка на клик маппит атрибутивную запись MMP в кликовое поле платформы, где оно есть - например, sc_click_id Snap из URL лендинга.
Где сидит дедупликация
Измеренная app-конверсия может доехать до платформы дважды: пересланная MMP и отправленная вашим собственным серверным пайплайном. Платформы, координирующие многоканальную доставку, - client_dedup_id Snap на пикселе, SDK и API в пределах 48 часов; пара event_id Meta - полагаются на то, что слой маппинга отправит одну и ту же идентичность с обоих путей. Механика по сетям - в событиях Snapchat, мобильные идентификаторы - в app-конверсиях Snapchat через MMP, паттерн Meta - в дедупликации пикселя и CAPI.
Кому владеть маппингом
В ручном исполнении маппинг живёт в вашем сервисе доставки: постбек на входе, пейлоад под каждую платформу на выходе, с хешированием, батчингом и ретраями по каждой сети. Команды, консолидирующие этот слой, используют MOST - один постбек на входе, корректные пейлоады на выходе на шести сетях; Pixel Activator валидирует одиночную конверсию руками. Окружающий стек - трекер, MMP и доставка - разложен в гайде по стеку MMP, трекера и CAPI.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.
