Adexium Documentation

Appearance

Инструкция по настройке постбеков для Adexium ​

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

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

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

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

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

В настройках кампании укажите ссылку на вашего Telegram-бота в следующем формате:

http
https://t.me/your_telegram_name_bot/game?startapp=adexium__[CLICK_ID]

Важно:

  • Замените your_telegram_name_bot на реальное имя вашего бота
  • Рекомендуем использовать двойное подчеркивание __
  • Параметр [CLICK_ID] будет автоматически заменен

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

Когда пользователь перейдет по рекламной ссылке, Telegram отправит вашему боту команду /start с параметром.

Пример входящего сообщения:/start adexium__d95c746d-31c7-4183-8fa7-42ce39b65e47

Вам необходимо:

  1. Получить значение параметра после /start
  2. Извлечь идентификатор клика после adexium__
  3. Сохранить этот [CLICK_ID] например, в базу данных

4. Отправка конверсии ​

В момент целевого действия отправьте GET-запрос:

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

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

5. Ключ постбэка ​

Параметр key подтверждает, что постбэк отправили именно вы. Идентификаторы кликов видны площадкам, на которых крутится ваша реклама, поэтому без ключа любой, кто их собрал, мог бы присылать конверсии по вашим кампаниям — а на оплате за конверсию это тратило бы ваш бюджет.

  • Ключ лежит в кабинете: Аккаунт → Безопасность, а также на странице Tracking, где готовый URL постбэка уже содержит его.
  • Передавайте его в query-строке, даже если шлёте POST. Ключ в теле запроса игнорируется.
  • Держите его на сервере: ему место в бэкенд-запросе, а не в разметке страницы и не в клиентском JavaScript.
  • Ключ можно перевыпустить в любой момент в Аккаунт → Безопасность. Предыдущий продолжает работать 7 дней — успейте за это время обновить шаблон.

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

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

  1. Ссылка в кампании:https://t.me/my_game_bot/game?startapp=adexium__[CLICK_ID]

  2. Фактический переход:https://t.me/my_game_bot/game?startapp=adexium__d95c746d-31c7-4183-8fa7-42ce39b65e47

  3. Действие бэкенда: Извлекает click_id = d95c746d-31c7-4183-8fa7-42ce39b65e47

  4. Отправка постбека:GET https://go.atechspace.live/conversion?click_id=d95c746d-31c7-4183-8fa7-42ce39b65e47