Skip to content

Трекинг конверсий для сайтов с бэкендом ​

Эта инструкция поможет настроить передачу конверсий с вашего сайта в рекламную сеть Adexium.

Пошаговая инструкция ​

1. Создайте рекламную кампанию ​

Создайте новую кампанию в кабинете Adexium.

2. Настройте ссылку в кампании ​

В настройках кампании укажите ссылку на сайт с параметром click_id:

http
https://yourwebsite.com/landing?click_id=[CLICK_ID]

Важно:

  • Замените yourwebsite.com/landing на адрес вашего лендинга
  • Параметр [CLICK_ID] Adexium подставит автоматически
  • Имя параметра может быть любым, но click_id нагляднее

3. Настройте обработку на бэкенде ​

Когда пользователь кликает по рекламе и попадает на сайт, нужно:

  1. Извлечь параметр click_id из query-строки URL
  2. Сохранить этот click_id у себя (привязать к сессии, ID пользователя или cookie)
  3. Хранить его можно:
    • в сессии пользователя (если он авторизован)
    • в базе, привязав к аккаунту пользователя
    • в cookie или local storage (для анонимных пользователей)

Пример URL при клике:

https://yourwebsite.com/landing?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47

Пример кода (псевдокод):

javascript
// Извлекаем 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-запрос со своего бэкенда:

http
GET https://go.atechspace.live/conversion?click_id=[CLICK_ID]&key=ВАШ_КЛЮЧ

Замените [CLICK_ID] на значение, сохранённое на шаге 3, а ВАШ_КЛЮЧ — на ключ постбэка вашего аккаунта (см. шаг 5).

Пример кода (псевдокод):

javascript
// Когда произошла конверсия (например, оплачен заказ)
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 дней — успейте за это время обновить шаблон.

Если после перевыпуска конверсии перестали учитываться, проверьте, обновлён ли шаблон.

Пример работы ​

  1. Ссылка в кампании:https://yourwebsite.com/landing?click_id=[CLICK_ID]

  2. Фактический переход:https://yourwebsite.com/landing?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47

  3. Пользователь на сайте:

    • Фронтенд извлекает click_id = d95c746d-31c7-4183-8fa7-42ce39b65e47
    • Передаёт его на бэкенд или сохраняет в сессии/cookie
    • Бэкенд сохраняет click_id вместе с сессией пользователя
  4. Пользователь совершает конверсию:

    • Пользователь выполняет целевое действие (покупка, регистрация и т. п.)
    • Бэкенд находит сохранённый 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