Документация
Справочник по работе с CPA-платформой
На этой странице
Clicks
Статус: draft
Назначение
В этом разделе администратор смотрит все клики по системе. В интерфейсе этот раздел называется Транзакции, но речь идёт именно о click-событиях.
Где находится
Админ-панель → Транзакции
Что такое клик
Клик — это зарегистрированный переход по tracking-ссылке.
По клику администратор может проверить:
- какой партнёр привёл трафик;
- по какому офферу пришёл пользователь;
- какая страна и устройство определились;
- на какой URL ушёл редирект;
- был ли клик дублем;
- почему по нему могла не появиться конверсия.
Что видит администратор
На странице подтверждены:
- таблица кликов;
- поиск;
- фильтры по датам, офферу, партнёру, рекламодателю, стране и redirect outcome;
- фильтры по
clickId,sub1-sub5,ip; - сортировка;
- пагинация;
- отметка manual для ручных кликов.
Список кликов
В списке кликов подтверждены фильтры и поля, связанные с:
- датой;
- click ID;
- оффером;
- партнёром;
- рекламодателем;
- country;
- redirect outcome;
- IP;
- sub1-sub5;
- source.
TODO: уточнить полный набор столбцов таблицы в визуальном порядке.
Основные действия
Найти клик по click ID
- Откройте раздел
Транзакции. - В поле фильтра укажите
clickId. - Примените фильтр.
Результат: вы увидите только нужный клик или поймёте, что его нет в системе.
Проверить клики по партнёру и офферу
- Выберите партнёра.
- Выберите оффер.
- Добавьте период, если нужно.
Результат: в списке останутся клики только по этой связке.
Проверить, почему редирект был не на target URL
- Найдите нужный клик.
- Проверьте страну и redirect outcome.
- Сопоставьте данные с GEO-правилами оффера.
Результат: можно понять, был ли fallback, блокировка или обычный редирект.
Основные поля клика
| Поле | Что означает | Когда используется |
|---|---|---|
| Click ID | Идентификатор клика | Для поиска клика и сверки с postback |
| Offer | Оффер клика | Для диагностики оффера |
| Affiliate | Партнёр, который привёл клик | Для проверки трафика партнёра |
| Advertiser | Связанный рекламодатель | Для проверки всей цепочки |
| Country | Определённая страна | Для GEO-диагностики |
| Device | Устройство пользователя | TODO: уточнить точный набор значений и отображение в таблице |
| Redirect URL | Куда в итоге ушёл пользователь | Для проверки редиректа |
| Redirect outcome | Результат логики редиректа | Для понимания, почему URL был выбран именно такой |
| Source | Источник клика: tracking или manual | Для отличия обычного и ручного клика |
| Sub1-Sub5 | Партнёрские метки | Для анализа кампаний |
| IP | IP адрес клика | Для точечной диагностики |
Click ID
Click ID — главный идентификатор клика.
Он нужен:
- для поиска клика в интерфейсе;
- для сопоставления с postback;
- для разбирательства по конкретной конверсии.
Canonical Click ID
В проекте поддерживается canonical click ID.
Практически это нужно для сценариев с дублями:
- один клик может считаться основным;
- дубли могут ссылаться на канонический клик.
TODO: уточнить, отображается ли canonical click ID отдельной колонкой или только в данных записи.
Дедупликация
Клики могут проходить через дедупликацию.
По проекту подтверждены поля и логика:
is_duplicate;duplicate_of_click_id;dedupe_fingerprint.
Если оффер запрещает дубли или ограничивает окно дублей, часть кликов может быть отмечена как дубли.
Device
Поле устройства поддерживается в кликах.
TODO: уточнить, как именно device отображается в таблице и какие значения доступны в интерфейсе.
Country
Country используется для:
- GEO-правил;
- проверки redirect outcome;
- поиска проблем с трафиком по странам.
Redirect URL
Redirect URL помогает понять, куда реально ушёл пользователь после клика.
Если redirect не совпадает с ожидаемым target URL, проверьте:
- GEO;
- fallback;
- availability оффера;
- внутренние ограничения.
Как диагностировать проблему по клику
- Найдите клик по
clickId,sub-меткам или периоду. - Проверьте оффер, партнёра и страну.
- Посмотрите redirect outcome и redirect URL.
- Если нужна конверсия, найдите её по
clickIdв разделе конверсий. - Если конверсии нет, проверьте postback и цель оффера.
Результат: администратор понимает, на каком этапе цепочка оборвалась.
Фильтры и поиск
Подтверждены фильтры:
- поиск;
dateFrom,dateTo;offerId;affiliateId;advertiserId;countryCode;redirectOutcome;clickId;sub1-sub5;ip;- сортировка;
- размер страницы.
Статусы
Отдельные статусы клика как общего workflow в интерфейсе не подтверждены.
Но есть redirectOutcome, а для manual clicks используется отдельная отметка Manual.
Частые ошибки и ситуации
| Ситуация | Что проверить |
|---|---|
| Клик не появился | Проверьте tracking-ссылку, период фильтра и не ищете ли вы по неверному clickId. |
| Клик появился как дубль | Проверьте настройки дублей кликов у оффера и окно дедупликации. |
| Неверная страна | Проверьте поле Country в записи и сравните его с ожидаемым GEO. |
| Неверный redirect URL | Проверьте targetUrl, GEO-правила, fallback и redirect outcome. |
| По клику нет конверсии | Проверьте postback, цель оффера и наличие конверсии по clickId. |
| Postback не нашёл клик | Проверьте, что рекламодатель передал правильный clickId и что клик относится к тому же офферу. |
Ожидаемый результат
После работы с разделом администратор должен:
- быстро находить любой клик;
- понимать, как он связан с оффером и партнёром;
- видеть, был ли редирект штатным;
- объяснять, почему по клику нет конверсии.