API конверсий

1. Зачем серверная отправка?

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

MousePlayer уже знает о достижении целей. API конверсий просто пересылают этот факт рекламной сети с нашего сервера.

2. Что передаётся и что никогда

Единственный способ идентификации посетителя в вызовах — cookie или ID клика, заданные самой сетью. Другие сведения о человеке сервер не покидают.

Сеть	Идентификатор	Источник
Meta	_fbp, _fbc	Собственные cookie пикселя Meta
LinkedIn	li_fat_id	Собственный cookie LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp — cookie, ttclid — из URL рекламного клика
Google Ads	gclid, wbraid, gbraid	Из URL рекламного клика или затем из cookie _gcl_aw
Microsoft Advertising	msclkid	Из URL рекламного клика или cookie _uetmsclkid тега UET

Только с согласием

Каждый вызов под той же проверкой согласия, что и запись. Сеанс без согласия не сообщает конверсии независимо от переключателя проекта.

3. У Google Ads три идентификатора

Google использует gclid для отдельного рекламного клика. Когда защита Apple не позволяет атрибуцию клика, Google передаёт wbraid или gbraid для группы кликов.

Эти три взаимно исключаются: Google отклонит конверсию с двумя. Мы передаём ровно один; gclid имеет приоритет при наличии нескольких как самый точный.

В URL они лишь однажды

ID есть в адресе только на первой странице после рекламного клика. Затем тег Google хранит его в cookie _gcl_aw . Мы читаем cookie как резерв: иначе конверсия на третьей странице не нашла бы ID.

4. Настройка

Meta, LinkedIn и TikTok

По два поля: ID пикселя или правила конверсии и токен доступа из интерфейса сети. Оба хранятся с шифрованием AES-256-GCM и не показываются после сохранения.

Google Ads нужно шесть полей

Google — исключение: простой токен доступа не выдаётся. Доступ через OAuth с токеном обновления, а Ads API дополнительно требует токен разработчика.

Поле	Где найти
ID клиента	Справа вверху Google Ads. Только цифры без дефисов.
ID действия-конверсии	Цели и конверсии, затем нужное действие.
Токен разработчика	Управляющий аккаунт Google Ads, API Center.
ID и секрет клиента OAuth	Google Cloud Console, Учётные данные, клиент OAuth типа «настольное приложение».
Токен обновления	Вы создаёте его один раз для области adwords.

У LinkedIn два пути — выбирайте короткий

В менеджере кампаний: Данные, Signals Manager, Direct API, Создать токен доступа. Это путь рекламодателей со своими данными, без приложения разработчика и проверки. Токен бессрочный и повторно не показывается; скопируйте сразу.

Приложение разработчика через LinkedIn Developer Portal — путь платформ, отправляющих за многих рекламодателей. Нужны проверка страницы компании и одобренный сценарий; здесь это лишнее.

Microsoft Advertising — самый простой

После Google Ads ожидаются OAuth, токен разработчика и одобрение. Наоборот: два поля. Браузерный ID тега UET и токен из Microsoft Advertising: тег UET, «Использовать Conversions API», «Копировать токен». Подавать заявку не нужно.

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

5. Когда сообщается конверсия

Ровно один раз на цель и сеанс. MousePlayer устраняет дубли до отправки; данные также содержат ID для повторной дедупликации сетью. Пять добавлений в корзину дают одну конверсию.

Что видно в рекламном аккаунте

Конверсия содержит имя цели, её ценность и валюту при задании и время. В обычной работе приходит в течение минуты.

Если ничего не приходит

• Нет ID клика. Посетитель пришёл не из рекламы сети или раньше установки cookie пикселем. Ничего не отправляется — ожидаемо, не ошибка.
• Нет согласия. Проверка сработала раньше.
• Сеть приняла вызов, но отклонила конверсию. Google, TikTok и другие отвечают HTTP 200 с ошибкой в теле. Мы читаем тело, а не только статус; причина есть в журнале доставки.