Основы S2S-трекеров

Этот раздел описывает, как связать Adexium со сторонним трекером, чтобы конверсии возвращались в Adexium по S2S-постбеку. На этой странице — общее для всех трекеров; точные поля и токены — в руководствах по конкретным трекерам ниже.

Руководства по трекерам:

• Voluum
• Keitaro
• Binom
• RedTrack
• BeMob
• PeerClick
• ClickFlare
• AdsBridge
• FunnelFlux

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

Схема одинакова для любого трекера:

1. Adexium → трекер. Ссылка кампании в Adexium ведёт на ваш трекер и передаёт наш клик-ID через макрос [CLICK_ID].
2. Трекер сохраняет клик-ID. Заведите Adexium как источник трафика в трекере и сопоставьте входящий параметр с полем «external ID» трекера.
3. Трекер → Adexium. При конверсии трекер вызывает наш постбек и подставляет сохранённый клик-ID в параметр click_id.

Эндпоинт постбека

GET https://go.atechspace.live/conversion?click_id=...&event_type=level1&key=YOUR_POSTBACK_KEY

Параметры:

Параметр	Обязателен	Описание
click_id	да	Клик-ID Adexium, полученный через макрос [CLICK_ID]
event_type	нет	level1 (по умолчанию), level2 или level3 — см. соответствие ниже
key	да	Ваш ключ постбека — скопируйте со страницы Tracking в кабинете
payout	нет	Доход с конверсии в USD (просто число, например 0.37). Только для сверки

Соответствие событий:

Событие	Значение
level1	Регистрация / Установка
level2	Первый депозит
level3	Повторный депозит

Технические требования

• HTTP-метод: GET (POST тоже принимается, но все параметры должны быть в query-строке — тело запроса игнорируется).
• event_type — строго level1 / level2 / level3; любое другое значение вернёт HTTP 400.
• Успешный ответ: 200 с {"message":"Accepted"}. Доставленным считайте только 200.
• Дедупликация: повторные постбеки с тем же клик-ID и уровнем игнорируются.
• key подтверждает, что постбек пришёл от вас. Не публикуйте его в клиентском коде; при утечке смените в Account → Security (старый ключ действует ещё 7 дней).

Готовые постбек-URL для каждого уровня — уже с вашим ключом — есть на странице Tracking кабинета Adexium:

Сквозной пример (Voluum)

1. Ссылка кампании в Adexium:https://track.example.com/abc?externalid=[CLICK_ID]
2. Пользователь кликает — Adexium подставляет макрос: https://track.example.com/abc?externalid=d95c746d-31c7-4183-8fa7-42ce39b65e47
3. Voluum сохраняет externalid = d95c746d-... и редиректит пользователя на оффер.
4. Происходит конверсия (регистрация) — Voluum вызывает: https://go.atechspace.live/conversion?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47&event_type=level1&key=YOUR_POSTBACK_KEY
5. Adexium отвечает 200 {"message":"Accepted"}, конверсия появляется в статистике кампании.

Другие трекеры

Любой трекер с кастомными источниками трафика и S2S-постбеками подключается так же:

1. Передайте [CLICK_ID] во входящий параметр external/click ID трекера в ссылке кампании.
2. Подставьте токен трекера для этого значения в параметр click_id нашего постбека.
3. Сопоставьте типы конверсий с event_type=level1/level2/level3.

Если ваш трекер не в списке и что-то не работает — напишите в бот поддержки.