Документация
Справочник по работе с CPA-платформой
На этой странице
Tracking-ссылки
Статус: draft
Назначение
В этом разделе партнёр получает личную tracking-ссылку для оффера и использует её для отправки трафика так, чтобы клики и конверсии правильно связывались между собой.
Где находится
Кабинет партнёра → Карточка оффера
Что такое tracking-ссылка
Tracking-ссылка — это специальная ссылка трекера, через которую должен проходить трафик партнёра.
Именно она нужна, чтобы платформа могла:
- зафиксировать клик;
- связать клик с конкретным оффером;
- понять, какой партнёр привёл трафик;
- позже связать конверсию с этим кликом.
Зачем использовать tracking-ссылку
Без tracking-ссылки система не сможет корректно учитывать:
- клики;
- конверсии;
- выплаты;
- статистику по офферу;
- статистику по партнёру.
Если партнёр отправляет трафик напрямую на посадочную страницу без этой ссылки, клик и конверсия могут не попасть в кабинет.
Что видит партнёр
- базовый адрес трекера на dashboard;
- личную ссылку в карточке оффера;
- кнопку
Скопировать; - кнопку
Открыть.
Как получить ссылку
Tracking-ссылка доступна только в карточке оффера при полном доступе.
Получить tracking-ссылку
- Откройте список офферов.
- Перейдите в карточку нужного оффера.
- Убедитесь, что оффер активен и у вас уровень доступа
full. - Найдите блок
Личная ссылка. - Скопируйте ссылку кнопкой
Скопировать.
Результат: у вас есть личная ссылка, которую можно использовать для запуска трафика.
Из чего состоит tracking-ссылка
По подтверждённой реализации ссылка строится на базе адреса трекера и пути /click.
Подтверждённый шаблон:
{TRACKING_BASE_URL}/click?offerId={offerId}&affiliateId={affiliateId}
Где:
offerId— идентификатор оффера;affiliateId— идентификатор партнёра.
Точный публичный домен трекера зависит от окружения проекта.
Параметры ссылки
| Параметр | Что означает | Можно ли менять |
|---|---|---|
offerId | Идентификатор оффера | Нет |
affiliateId | Идентификатор партнёра | Нет |
sub1 | Дополнительная метка трафика | Да, если вы используете свою разметку |
sub2 | Дополнительная метка трафика | Да, если поддерживается в вашем сценарии |
sub3 | Дополнительная метка трафика | TODO: уточнить по реализации |
sub4 | Дополнительная метка трафика | TODO: уточнить по реализации |
sub5 | Дополнительная метка трафика | TODO: уточнить по реализации |
Поддержка sub1-sub5 подтверждена как минимум в данных кликов и административных фильтрах. Полный формат передачи этих параметров в partner UI:
TODO: уточнить точный формат tracking-ссылки по реализации.
Click ID
click id — это уникальный идентификатор клика, который создаётся после перехода пользователя по tracking-ссылке.
Он нужен, чтобы:
- найти клик в системе;
- связать конверсию с конкретным переходом;
- передать идентификатор дальше в цепочку трекинга;
- сравнить клик и postback.
Если click id потерян, изменён или не дошёл до рекламодателя, конверсия может не связаться с кликом.
Sub-параметры
Sub-параметры нужны для вашей внутренней аналитики.
Обычно их используют, чтобы помечать:
- источник трафика;
- кампанию;
- креатив;
- adset;
- площадку.
Пример логики:
sub1— источник;sub2— кампания.
Точный набор допустимых параметров и ограничений:
TODO: уточнить по реализации.
Что нельзя менять в ссылке
В tracking-ссылке нельзя:
- удалять служебные параметры;
- менять
offerId; - менять
affiliateId; - использовать ссылку другого партнёра;
- вручную ломать формат URL;
- отправлять трафик на оффер без доступа;
- использовать старую ссылку, если условия оффера изменились и нужна новая;
- вручную менять redirect, если это не предусмотрено интерфейсом.
Если вы меняете обязательные параметры, система может:
- не записать клик;
- не связать клик с конверсией;
- отнести трафик не к тому офферу;
- не отнести трафик к вашему аккаунту.
Примеры tracking-ссылок
Ниже безопасные условные примеры.
Если реальный формат в проекте отличается, ориентируйтесь на ссылку из карточки оффера.
https://tracking.example.com/click?offerId=123&affiliateId=456
https://tracking.example.com/click?offerId=123&affiliateId=456&sub1=facebook&sub2=campaign_01
https://tracking.example.com/click?offerId=123&affiliateId=456&sub1=google&sub2=search_brand
TODO: уточнить точный формат tracking-ссылки по реализации, если кроме offerId и affiliateId есть обязательные параметры.
Как проверить ссылку
Проверить, что ссылка рабочая
- Скопируйте ссылку из карточки оффера.
- Откройте её в новой вкладке через кнопку
Открытьили вручную. - Убедитесь, что происходит переход на целевой URL или допустимый fallback.
- После теста проверьте раздел Клики.
Результат: ссылка открывается, а тестовый переход фиксируется как клик.
Проверить, что ссылка не устарела
- Откройте карточку оффера.
- Сравните текущую ссылку с той, которую вы используете в рекламе.
- Если оффер, доступ или условия изменились, обновите ссылку.
Результат: в работе используется актуальная версия tracking-ссылки.
Основные действия
Скопировать ссылку для запуска
- Откройте карточку оффера.
- Убедитесь, что оффер доступен и ссылка видна.
- Нажмите
Скопировать.
Результат: готовая tracking-ссылка сохранена в буфере обмена.
Протестировать переход
- Нажмите
Открытьв блоке ссылки. - Убедитесь, что открывается корректная посадочная страница.
- Проверьте, что в разделе кликов появился новый клик.
Результат: можно убедиться, что ссылка технически работает.
Основные поля
| Поле | Что означает | Когда используется |
|---|---|---|
| Личная ссылка | Персональная tracking-ссылка партнёра | Для запуска трафика |
| Target URL | Основной адрес назначения | Для проверки конечной посадочной |
| Fallback URL | Запасной адрес | Если он предусмотрен оффером |
| Preview URL | Ссылка для предпросмотра | Для ручной проверки посадочной |
| offerId | ID оффера | Используется внутри tracking-ссылки |
| affiliateId | ID партнёра | Используется внутри tracking-ссылки |
Фильтры и поиск
Для tracking-ссылок отдельные фильтры в интерфейсе не подтверждены.
TODO: уточнить, есть ли история ссылок или поиск по ним.
Почему конверсия может не появиться
Основные причины:
- пользователь не совершил целевое действие;
- рекламодатель не отправил postback;
- postback отправлен с ошибкой;
- postback не содержит нужный click id;
- click id был изменён или потерян;
- оффер был недоступен на момент отправки трафика;
- GEO не подходит под условия оффера;
- клик не зафиксировался из-за неправильной ссылки;
- используется старая ссылка;
- конверсия ещё обрабатывается;
- конверсия была отклонена.
Если часть цепочки находится вне интерфейса партнёра:
TODO: уточнить детали интеграции postback в конкретном проекте.
Частые ошибки и ситуации
| Ситуация | Что проверить |
|---|---|
| Ссылка не открывается | Проверьте, что ссылка скопирована полностью и оффер ещё активен |
| Клик не появляется | Проверьте формат ссылки, offerId, affiliateId и факт реального перехода через трекер |
| Клик есть, но конверсии нет | Проверьте целевое действие, click id, postback и ограничения оффера |
| Рекламодатель не получил click id | Проверьте, не потерялся ли идентификатор в цепочке редиректа |
| Postback не связался с кликом | Проверьте, что был передан правильный click id и он не был изменён |
| Партнёр использует старую ссылку | Скопируйте актуальную ссылку из текущей карточки оффера |
| Партнёр льёт трафик на выключенный оффер | Остановите трафик и проверьте статус оффера |
Ожидаемый результат
После работы с tracking-ссылкой партнёр должен понимать:
- какую ссылку использовать для трафика;
- какие параметры нельзя менять;
- как проверить ссылку перед запуском;
- почему клик или конверсия могут не появиться.