---
title: "Трекинг Telegram Ads: макросы и постбеки о конверсиях"
description: "Как отслеживать кампании Telegram Ads в AdsGram: макросы для веб-ссылок, постбеки о конверсиях через API подтверждения конверсий и автоматические события Goal 1 для TMA, ботов и каналов."
outline: [2,4]
---
# Трекинг Telegram Ads
Для более детального отслеживания результативности рекламных кампаний в Telegram Ads и корректной атрибуции источников целевых действий рекомендуется использовать **систему аналитики**.
## Макросы, которые поддерживаются для веб-ссылок в Telegram Ads
Для детального трекинга используйте макросы. AdsGram автоматически заменит их на реальные данные в вашей трекинговой ссылке.
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{click_id}`
- `{ip}`
- `{campaign}` — название кампании
> [!IMPORTANT] ВАЖНО
> Эта поддержка распространяется только на веб-ссылки в Telegram Ads. Макросы AdsGram по-прежнему не поддерживаются для ссылок, ведущих на Telegram Mini Apps (TMA), ботов и каналы в Telegram Ads.
::: warning ВНИМАНИЕ:
Для корректной работы API подтверждения конверсий для веб-ссылок в кампаниях Telegram Ads в ссылке рекламной кампании должен присутствовать макрос `{campaign_id}`. Если обязательный макрос отсутствует, отслеживание конверсий работать не будет.
В кампаниях Telegram Ads макросы AdsGram не поддерживаются для ссылок, ведущих на Telegram Mini Apps (TMA), ботов или каналы. Поэтому API подтверждения конверсий нельзя использовать для отслеживания конверсий по таким ссылкам в кампаниях Telegram Ads. Подробнее читайте ниже в разделе [Трекинг конверсий для ссылок внутри Telegram в кампаниях Telegram Ads](#трекинг-конверсии-для-ссылок-внутри-telegram-в-кампаниях-telegram-ads).
:::
> [!IMPORTANT] ВАЖНО
> Макрос `{publisher_id}` раскрывается только как уникальный идентификатор издателя — без указания его названия или другой идентифицирующей информации.
Пример ссылки с макросами:
```
https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}
```
Кабинет подсвечивает добавленные в ссылку макросы 
и пропущенные 
.
## Настройка постбеков о конверсиях для веб-ссылок в Telegram Ads
### Параметры:
- `token` — Уникальный токен, связанный с вашим аккаунтом AdsGram. Доступен в рекламном кабинете. При необходимости его можно сгенерировать повторно.
**Где получить token:**
1. Откройте рекламный кабинет AdsGram.
1. Нажмите на профиль в правом верхнем углу.
1. Найдите параметр `token` и скопируйте его, нажав на кнопку 
.
- `campaignid` — ID рекламной кампании AdsGram, к которой относится конверсия. Соответствует значению макроса `{campaign_id}`, передаваемому в рекламной ссылке. AdsGram подставляет значение макроса при переходе пользователя по ссылке.
- `goaltype` — Параметр, указывающий тип конверсии (этап воронки), который помогает сегментировать различные целевые действия пользователя. Принимает целочисленные значения от 1 до 3.
#### Использование goaltype:
1. Определите этапы воронки в вашем продукте или сервисе.
1. Сопоставьте этапы со значениями goaltype:
- 1. Регистрация
- 2. Первый депозит/покупка
- 3. Повторный депозит/покупка
1. Настройте отправку конверсий на нужных этапах пользовательского пути.
1. Добавьте параметр goaltype к вашему API-запросу при отправке.
1. Используйте данные в аналитике для детального анализа эффективности по разным типам конверсий.
### Как настроить отправку конверсий:
1. **Выберите кампанию в Telegram Ads.** Используйте существующую активную кампанию или создайте новую.
1. **Настройте рекламную ссылку.** Убедитесь, что в ней присутствует макрос `{campaign_id}`.
1. **Получите token.** Скопируйте уникальный токен из рекламного кабинета AdsGram.
1. **Настройте отправку постбеков.** На стороне вашего сервера отправляйте API-запрос в AdsGram, когда пользователь выполняет целевое действие.
1. **Передавайте правильный тип конверсии.** Указывайте соответствующее значение `goaltype`, если хотите различать этапы воронки.
1. **Проверьте интеграцию.** Выполните тестовый сценарий из раздела **Тестирование интеграции** и убедитесь, что конверсии поступают в статистику AdsGram.
#### Пример API-запроса:
```
GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2
```
В примере передаётся конверсия типа `2` (например, первый депозит или покупка).
Замените `YOUR_UNIQUE_TOKEN` на токен вашего аккаунта, а `72156` — на ID вашей рекламной кампании.
Ожидаемый ответ: `200 OK` — успешная регистрация конверсии.
### Тестирование интеграции
Чтобы протестировать отслеживание конверсий, выполните следующие шаги:
1. Создайте или выберите кампанию Telegram Ads и настройте рекламную ссылку в соответствии с документацией. Убедитесь, что в ссылке передаётся макрос `{campaign_id}`.
1. Дождитесь нескольких кликов по рекламной ссылке.
1. Отправьте тестовый постбек вручную, передав параметр `goaltype=1`. Используйте действительный `token` и ID тестовой кампании в параметре `campaignid`.
1. Убедитесь, что запрос обработан успешно, а конверсия появилась в статистике AdsGram для выбранной кампании.
- **Конверсия появилась в статистике** — интеграция успешно настроена и работает.
- **Сервер вернул ошибку** — проверьте URL запроса, `token`, значения параметров `campaignid` и `goaltype`.
- **Запрос выполнен успешно, но конверсия не появилась** — статистика обновляется раз в час. Если спустя час данные не появились, напишите в поддержку AdsGram или своему менеджеру. К обращению обязательно приложите логи запроса и ответа.
## Трекинг конверсий для ссылок внутри Telegram в кампаниях Telegram Ads
В кампаниях Telegram Ads макросы AdsGram не поддерживаются для ссылок, ведущих на объекты внутри Telegram, и не передаются в такие рекламные ссылки. Поэтому API подтверждения конверсий нельзя использовать для отслеживания конверсий по ссылкам, ведущим на Telegram Mini Apps (TMA), ботов или каналы.
Для ссылок внутри Telegram в кампаниях Telegram Ads целевые события автоматически передаются в **Goal 1** по умолчанию:
- TMA — запуск TMA;
- Боты — запуск бота;
- Каналы — подписка на канал.
Конверсии передаются автоматически, поэтому дополнительная настройка не требуется.