Постбэк

Постбэк — это инструмент для передачи данных о целевых действиях (конверсиях), которые происходят вне платформы, например, в вашем приложении, боте или CRM. Он позволяет связать реальные результаты (покупки, регистрации, подписки) с конкретными рекламными объявлениями, чтобы система могла учитывать эффективность каждой кампании и корректно отображать статистику в колонке Conversions.

Он используется, когда само действие (например, покупка, регистрация, подписка, установка приложения и т.д.) происходит вне платформы — в вашем боте, CRM, лендинге или другом внешнем сервисе.

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

1. Пользователь кликает по рекламному объявлению, созданному в Telescope.

2. Ссылка из объявления ведёт на ваш сайт или бот с установленным пикселем TelegramAds.

3. Когда происходит нужное событие (например, покупка), сервер отправляет в Telescope HTTP-запрос (POST) с информацией об этом событии — то есть постбэк.

4. Telescope сохраняет данные и отображает конверсии в аналитике и отчётах.

5. На эти конверсии можно настроить автоправила, чтобы система сама следила и отключала не окупаемые объявления

Общая логика работы постбэка

1) Создание события (конверсии)

Для начала нужно перейти в раздел Events (про них можно прочитать в разделе "События"). Здесь вы создаёте событие, которое будет представлять собой определённое действие пользователя, например:

• Просмотр страницы

• Добавить в корзину

• Добавить в список желаний

• Настроить продукт

• Начать оформление заказа

• Добавить платежную информацию

• Покупка / Оплата

• Заявка / Регистрация

• Запланировать

• Завершить регистрацию

• Подать заявку / Отправить анкету

• Начать пробный период

• Подписаться

• Просмотр контента

• Поиск

• Найти местоположение / Найти на карте

• Пожертвовать

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

2) Связь между объявлениями и конверсиями через adID

Когда вы запускаете рекламную кампанию в Telescope, каждая ссылка на объявление получает уникальный параметр adId. Он добавляется к start-параметру Telegram-ссылки, чтобы идентифицировать, из какого именно объявления пришёл пользователь.

Пример ссылки:

https://t.me/your_bot?start=ad_12345 

В этом примере 12345 — это ID объявления в Telescope. Внутри вашего Telegram-бота или приложения необходимо перехватить это значение adId (обычно через обработчик start-параметра) и сохранить его, чтобы при возникновении конверсии можно было точно указать, к какому объявлению она относится.

3) Создание API-токена для передачи данных

Чтобы иметь возможность передавать данные о конверсиях в Telescope через API, нужно создать API-токен.

Для этого перейдите в раздел Tokens → нажмите Создать токен → задайте ему имя, введите пароль от аккаунта для подтверждения и сохраните значение.

Должна будет выйти комбинация букв и цифр, похожая на что-то такое:

 2739|UL38Ac12KCx0ghBWl2fc2yVXassSpPVYtd7LfBjC9daca815

Этот токен используется для авторизации всех запросов к API и должен передаваться в заголовке.

4) Проверяем работоспособность постбека

Переходим на наш сайт https://app.tele-scope.one/swagger и в форме для авторизации вводим наш API-токен

Далее необходимо пролистать до Conversion и нажать на кнопку "Try it out". Должно появиться следующее:

В теле запроса необходимо указать:

• ad_id — ID объявления, по которому произошла конверсия

• event_id — ID события, которое отслеживается (например, “покупка” или “регистрация”).

Вводим свои данные и нажимаем далее на кнопку "Execute".

Если всё было выполнено верно, то статус по событию будет "ОК" в ячейке кода или "Success" как на страничке. Если же результат отрицательный, то в зависимости от ошибки можно попробовать следующие решения:

Проблема	Причина	Решение
❌ Ошибка 401 Unauthorized	Токен не передан или недействителен	Проверьте заголовок Authorization
⚠️ Ошибка 422 Invalid ad_id	ID объявления не существует	Проверьте ID объявления в личном кабинете
🕒 Конверсии не видны в аналитике	Событие не связано с кампанией	Убедитесь, что event_id относится к нужной группе событий
🔁 Дублирующиеся конверсии	Повторная отправка того же запроса	Передавайте уникальные ID транзакций, если это важно для вашего сценария

Пример полной цепочки на практике

1. В разделе Events создаётся событие «Покупка бота» → получает conversionId.

2. В объявлении, которое ведёт в Telegram-бот, в ссылке автоматически добавляется ?start=ad_id.

3. Пользователь кликает по рекламе и запускает бота → бот получает adId из объявления, по которому перешёл пользователь.

4. Пользователь совершает покупку внутри бота.

5. Бот вызывает API Telescope:

   {
     "adId": "ваш_ad_id",
     "eventId": "6789",
   }

6. Telescope принимает постбэк и увеличивает счётчик конверсий у объявления.

7. В интерфейсе на странице объявлений в колонке Conversions теперь отображается +1.

Зачем это нужно

• Позволяет отслеживать эффективность рекламы в реальном времени.

• Дает возможность автоматизировать управление кампаниями — например, повышать CPM для успешных объявлений или останавливать неэффективные.

• Позволяет точно понимать, какие объявления приносят реальные результаты, а не просто показы и клики.

• Используется как основа для автоматизации оптимизаций через шаблоны и правила в разделе Автоматизация.