Если вы привлекаете пользователей через веб-воронку или лендинг, веб-пиксель Adapty связывает каждый визит с рекламным объявлением, которое его привело. Пиксель присваивает каждому посетителю идентификатор клика. Когда посетитель совершает оплату, вы передаёте этот идентификатор вместе с транзакцией, и Adapty Attribution сопоставляет покупку с конкретной кампанией, группой объявлений и объявлением.

Пиксель доступен для кампаний Meta Ads, TikTok for Business и Google Ads. В Google Ads он доступен для кампаний типа Other, но не для App-кампаний.

Как это работает

При загрузке страницы пиксель:

• Присваивает посетителю click_id и сохраняет его в браузере на 7 дней.
• Захватывает рекламные сигналы из URL страницы: идентификаторы кликов Meta (fbclid), TikTok (ttclid) и Google (gclid, gbraid, wbraid), идентификаторы и названия кампаний, групп объявлений и самих объявлений, а также параметры utm_*.
• Отправляет click_id и захваченные сигналы в Adapty в фоновом режиме.

При оформлении заказа вы прикрепляете к транзакции только click_id. Adapty автоматически сопоставляет его с сигналами, которые уже отправил пиксель, и определяет рекламный канал.

Перед началом работы

Подключите Meta Ads, TikTok for Business или Google Ads к атрибуции Adapty и добавьте конфигурацию кампании. Adapty генерирует фрагмент пикселя для каждой конфигурации кампании, поэтому он нужен вам, чтобы скопировать этот фрагмент.

Пиксель считывает данные объявлений из URL вашей лендинговой страницы, поэтому ваши объявления должны содержать параметры отслеживания Adapty. Без них Adapty атрибутирует покупку сети, но не кампании, группе объявлений или конкретному объявлению. Смотрите раздел Разметка URL объявлений для веб-воронок.

Установите пиксель

1. В Adapty Attribution откройте конфигурацию кампании Meta Ads, TikTok или Google Ads.
2. Разверните раздел Web funnel и скопируйте значение поля Pixel snippet. В конфигурациях Meta Ads и TikTok этот раздел находится на вкладке General.

3. Вставьте сниппет в <head> каждой страницы вашей воронки:

<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

Значение data-code идентифицирует ваше приложение и кампанию. Это публичный идентификатор, не секрет.

Управление согласием

Пиксель записывает куки первой стороны и запись в localStorage, а также считывает идентификаторы кликов по рекламе при загрузке страницы. Вы являетесь контролёром данных для вашей воронки и несёте юридическую ответственность за это.

По умолчанию пиксель запускается при загрузке страницы. Чтобы включить его только после получения согласия, добавьте data-consent="denied" в сниппет — пиксель не будет ничего сохранять и отправлять, пока вы не предоставите согласие из вашего баннера с куки:

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'

Сниппет загружается асинхронно, поэтому window.adaptyPixel не существует на строке сразу после тега <script>. Вызывайте API согласия из колбэка баннера согласия или защитите ранний вызов проверкой if (window.adaptyPixel) { ... }.

Примечания по использованию

• Одностраничные воронки: Клиентская навигация сохраняет тот же click_id, поэтому воронка, построенная как одностраничное приложение, работает без дополнительной настройки.
• Стабильность Click ID: Чтение click_id при загрузке страницы или на этапе оформления заказа возвращает одно и то же значение. Если посетитель заходит в воронку повторно по новому объявлению, побеждает последний клик по рекламе.
• Продления: Прикрепляйте click_id только к первой транзакции. Атрибуцию конверсий из триала и продлений подписки Adapty отслеживает через саму подписку.