Трекинг конверсий для сайтов с бэкендом
Эта инструкция поможет настроить передачу конверсий с вашего сайта в рекламную сеть Adexium.
Пошаговая инструкция
1. Создайте рекламную кампанию
Создайте новую кампанию в кабинете Adexium.
2. Настройте ссылку в кампании
В настройках кампании укажите ссылку на сайт с параметром click_id:
https://yourwebsite.com/landing?click_id=[CLICK_ID]Важно:
- Замените
yourwebsite.com/landingна адрес вашего лендинга - Параметр
[CLICK_ID]Adexium подставит автоматически - Имя параметра может быть любым, но
click_idнагляднее
3. Настройте обработку на бэкенде
Когда пользователь кликает по рекламе и попадает на сайт, нужно:
- Извлечь параметр
click_idиз query-строки URL - Сохранить этот
click_idу себя (привязать к сессии, ID пользователя или cookie) - Хранить его можно:
- в сессии пользователя (если он авторизован)
- в базе, привязав к аккаунту пользователя
- в cookie или local storage (для анонимных пользователей)
Пример URL при клике:
https://yourwebsite.com/landing?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47Пример кода (псевдокод):
// Извлекаем click_id из URL
const urlParams = new URLSearchParams(window.location.search);
const clickId = urlParams.get('click_id');
// Отправляем на свой бэкенд
fetch('/api/track-click', {
method: 'POST',
body: JSON.stringify({ click_id: clickId }),
headers: { 'Content-Type': 'application/json' }
});
// Или сохраняем в cookie/сессию
document.cookie = `adexium_click_id=${clickId}; path=/; max-age=2592000`; // 30 дней4. Отправка конверсии
Когда происходит целевое действие (покупка, регистрация, отправка формы и т. п.), отправьте GET-запрос со своего бэкенда:
GET https://go.atechspace.live/conversion?click_id=[CLICK_ID]&key=ВАШ_КЛЮЧЗамените [CLICK_ID] на значение, сохранённое на шаге 3, а ВАШ_КЛЮЧ — на ключ постбэка вашего аккаунта (см. шаг 5).
Пример кода (псевдокод):
// Когда произошла конверсия (например, оплачен заказ)
async function sendConversion(userId) {
// Достаём сохранённый click_id этого пользователя
const clickId = await getStoredClickId(userId);
if (clickId) {
// Отправляем постбэк в Adexium
await fetch(`https://go.atechspace.live/conversion?click_id=${clickId}&key=${POSTBACK_KEY}`);
}
}5. Ключ постбэка
Параметр key подтверждает, что постбэк отправили именно вы. Идентификаторы кликов видны площадкам, на которых крутится ваша реклама, поэтому без ключа любой, кто их собрал, мог бы присылать конверсии по вашим кампаниям — а на оплате за конверсию это тратило бы ваш бюджет.
- Ключ лежит в кабинете: Аккаунт → Безопасность, а также на странице Tracking, где готовый URL постбэка уже содержит его.
- Передавайте его в query-строке, даже если шлёте POST. Ключ в теле запроса игнорируется.
- Держите его на сервере: ему место в бэкенд-запросе, а не в разметке страницы и не в клиентском JavaScript.
- Ключ можно перевыпустить в любой момент в Аккаунт → Безопасность. Предыдущий продолжает работать 7 дней — успейте за это время обновить шаблон.
Если после перевыпуска конверсии перестали учитываться, проверьте, обновлён ли шаблон.
Пример работы
Ссылка в кампании:
https://yourwebsite.com/landing?click_id=[CLICK_ID]Фактический переход:
https://yourwebsite.com/landing?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47Пользователь на сайте:
- Фронтенд извлекает
click_id = d95c746d-31c7-4183-8fa7-42ce39b65e47 - Передаёт его на бэкенд или сохраняет в сессии/cookie
- Бэкенд сохраняет
click_idвместе с сессией пользователя
- Фронтенд извлекает
Пользователь совершает конверсию:
- Пользователь выполняет целевое действие (покупка, регистрация и т. п.)
- Бэкенд находит сохранённый
click_idэтого пользователя - Бэкенд отправляет постбэк:
GET https://go.atechspace.live/conversion?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47&key=ВАШ_КЛЮЧ
Важно для сайтов
- Срок хранения: храните
click_idне меньше 30 дней, чтобы учитывать отложенные конверсии - События воронки: более глубокие события передавайте с
event_type=level2(депозит) илиevent_type=level3(повторный депозит);level1(регистрация / установка) — по умолчанию. Повторные постбэки по тому же клику и уровню игнорируются - Нужен HTTPS: сайт должен работать по HTTPS, чтобы параметры передавались безопасно
- Серверный трекинг: для точности отправляйте конверсии с бэкенда, а не из клиентского JavaScript