Макросы и clickid: справочник
Макросы и clickid — параметры, которые трекер подставляет в ссылку вместо статичного текста: клик по одному и тому же креативу у разных пользователей превращается в разные, уникальные URL. Без них постбек не сможет сказать, какой именно клик привёл к депозиту, а аналитика по гео, саб-источникам и стоимости клика просто не соберётся. Ниже — справочник по самым частым макросам и то, как их провести через PWA-витрину без потерь.
Что такое макрос и как он работает
Макрос — это плейсхолдер вида {clickid} или {sub_id} в шаблоне ссылки, который трекер или источник трафика заменяет на реальное значение в момент клика. Из ссылки на объявление такой параметр переходит в адрес PWA-витрины как часть query string, а дальше должен долететь до события конверсии — иначе постбек придёт «пустым» и не свяжется с исходным кликом.
{clickid} — обязательный макрос
{clickid} — уникальный идентификатор конкретного клика, который трекер, например Keitaro, присваивает при переходе и использует, чтобы позже сопоставить постбек о конверсии с этим же кликом. Без clickid трекер физически не может понять, какая именно конверсия к какому клику относится, — вся оптимизация по крео, плейсменту и гео становится невозможной. Это единственный макрос из списка, без которого связка вообще не работает.
{sub_id}, {geo}, {cost} и другие частые параметры
{sub_id} обычно несёт дополнительную метку — конкретный креатив, плейсмент или адсет — и позволяет резать статистику мельче, чем просто «кампания». {geo} передаёт страну клика и полезен, когда одна кампания идёт на несколько гео одновременно и нужно разделить конверсии по рынкам. {cost} прокидывает стоимость самого клика в момент показа — на нём строится микро-биддинг и расчёт ROI почти в реальном времени, без ожидания сводных отчётов из рекламного кабинета.
Как прокинуть макросы через PWA
Макросы подставляются источником трафика в кампании ещё на этапе формирования ссылки на PWA — в APEX эта ссылка генерируется в настройках проекта и уже содержит нужные параметры в виде query string. Витрина должна прочитать эти параметры при открытии и сохранить их, например вместе с push-подпиской или локально в браузере, чтобы позже приложить те же значения к любому событию или постбеку, отправленному с этой сессии.
Частые ошибки при работе с макросами
Первая ошибка — источник трафика не поддерживает конкретный макрос, и в ссылку попадает буквально строка «{clickid}», а не реальное значение; это нужно проверять тестовым кликом перед запуском, а не постфактум. Вторая — редирект или переписывание ссылки где-то в цепочке теряет query string целиком, и все параметры обрываются до того, как долетят до витрины. Третья — имена макросов в трекере и в источнике трафика не совпадают буква в букву, из-за чего подстановка просто не срабатывает.
Частые вопросы
- Что будет, если источник не поддерживает нужный макрос?
- Он передастся как обычный текст — буквально сама строка вида {clickid} — вместо реального значения, поэтому список поддерживаемых макросов конкретного источника стоит проверять до запуска, а не после.
- Обязательно ли передавать все макросы сразу?
- Нет, но {clickid} нужен всегда — без него не работает сопоставление конверсии с кликом; {sub_id}, {geo} и {cost} добавляют глубину аналитики, но не критичны для самого факта трекинга.
- Где смотреть список макросов конкретного источника трафика?
- В документации самого источника (Facebook, TikTok, Google Ads) и в разделе кампании внутри трекера — наборы поддерживаемых макросов у разных источников не совпадают.
- Как APEX работает с этими параметрами на стороне витрины?
- APEX подхватывает параметры из ссылки при открытии PWA и сохраняет их вместе с сессией пользователя, так что они автоматически прикладываются к событиям и долетают до постбека без ручной доработки.
Клоака, антибот, пуши, сплит-тесты и свои домены — в одном сервисе.
Начать бесплатно