Передача clickid через PWA

Передача clickid через PWA — узкое место, о которое чаще всего спотыкается атрибуция: параметр легко потерять именно в момент установки, когда пользователь уходит из браузера в отдельное приложение. Разбираем, где clickid обычно теряется и как выстроить передачу так, чтобы постбек всегда находил, к какому клику привязать конверсию.

Что такое clickid и почему без него не работает атрибуция

Clickid — это уникальный идентификатор, который трекер или рекламная площадка присваивает конкретному клику, чтобы позже связать с ним конверсию через постбек. Без clickid партнёрка технически может подтвердить, что конверсия произошла, но не может сказать, с какого именно клика, кампании и объявления она пришла — а значит, невозможно посчитать честный ROI по крео и аудиториям.

Обычный путь clickid: от клика до лендинга

В классической схеме без PWA clickid передаётся через query-параметр в URL — пользователь кликает по объявлению, попадает на трекер, который редиректит на лендинг, сохраняя параметр в адресной строке. Пока пользователь остаётся в одной вкладке браузера, параметр просто путешествует по цепочке редиректов без дополнительных усилий.

Где всё усложняется с установкой PWA

Проблема начинается в момент установки: пользователь ставит PWA на экран и в следующий раз открывает его как отдельное приложение, а не по исходной ссылке из объявления — то есть без query-параметров в URL вообще. Если clickid не был сохранён где-то до этого момента, при следующем открытии приложения у него просто нет способа узнать, с какого клика пришёл этот конкретный пользователь.

Как clickid сохраняется на стороне PWA

Решение — сохранить clickid на устройстве в момент первого визита или установки (например, в localStorage или IndexedDB service worker'а), пока параметр ещё доступен в URL, и потом прикреплять его к любому событию внутри приложения — открытие, регистрация, деп. Именно так параметр «переживает» переход из контекста браузерной вкладки в контекст установленного приложения без адресной строки.

Путь обратно: от события в PWA до постбека в трекер

Когда внутри PWA происходит целевое действие (регистрация в оффере, деп), это событие должно унести с собой сохранённый clickid — либо через прямой вызов постбек-URL с этим параметром, либо передав его партнёрке при регистрации, чтобы она сама отправила S2S-постбек с привязкой к тому же clickid. Если на этом шаге параметр не передан или искажён (например, обрезан или перепутан с другим саб-айди), конверсия придёт, но не сматчится с исходным кликом.

Как это устроено в APEX

В APEX передача clickid через установку и всю дальнейшую жизнь PWA встроена в платформу: параметр подхватывается при первом визите, переживает установку и прикрепляется к событиям внутри приложения автоматически, без ручной сборки логики сохранения на стороне байера. Это напрямую влияет на точность S2S-постбеков — включая связку с Keitaro↔FB CAPI — потому что трекер получает конверсию с тем же clickid, что был на исходном клике.

Частые вопросы

Что произойдёт, если clickid потеряется при установке PWA?
Конверсия всё равно может прийти в партнёрку, но постбек не сможет привязаться к исходному клику и рекламной кампании — статистика по ROI станет неполной именно в этом месте.
Почему обычная ссылка с параметром не работает после установки PWA?
Потому что установленное приложение открывается как отдельная точка входа, а не по исходному URL с query-параметрами — без сохранения clickid до этого момента параметр физически негде взять при повторном открытии.
Нужно ли байеру самому программировать сохранение clickid в APEX?
Нет — APEX подхватывает и сохраняет clickid при первом визите и прикрепляет его к событиям внутри установленного PWA автоматически.
Можно ли передавать несколько параметров вместе с clickid (например, саб-айди)?
Да, обычно clickid передаётся в связке с дополнительными саб-параметрами (гео, крео, плейсмент), и вся эта цепочка должна сохраняться так же, как сам clickid, чтобы аналитика оставалась детальной.
Как проверить, что clickid доходит до постбека без потерь?
Проще всего — тестовый клик с известным clickid до конверсии внутри PWA и сверка, что тот же clickid пришёл в постбеке на стороне трекера или партнёрки.
Собери своё PWA в APEX за пару минут

Клоака, антибот, пуши, сплит-тесты и свои домены — в одном сервисе.

Начать бесплатно

Читайте также