---
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;
- Боти — запуск бота;
- Канали — підписка на канал.
Конверсії передаються автоматично, тому додаткове налаштування не потрібне.