Трекінг Telegram Ads

Для більш детального відстеження результативності рекламних кампаній у Telegram Ads та коректної атрибуції джерел цільових дій рекомендується використовувати систему аналітики.

Макроси, які підтримуються для веб-посилань у Telegram Ads

Для детального трекінгу використовуйте макроси. AdsGram автоматично замінить їх на реальні дані у вашому трекінговому посиланні.

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {click_id}
• {ip}
• {campaign} — назва кампанії

Важливо

Ця підтримка поширюється лише на веб-посилання в Telegram Ads. Макроси AdsGram, як і раніше, не підтримуються для посилань, що ведуть на Telegram Mini Apps (TMA), ботів і канали в Telegram Ads.

Увага

Для коректної роботи API підтвердження конверсій для веб-посилань у кампаніях Telegram Ads у посиланні рекламної кампанії має бути макрос {campaign_id}. Якщо обовʼязковий макрос відсутній, відстеження конверсій не працюватиме.

У кампаніях Telegram Ads макроси AdsGram не підтримуються для посилань, що ведуть на Telegram Mini Apps (TMA), ботів або канали. Тому API підтвердження конверсій не можна використовувати для відстеження конверсій за такими посиланнями в кампаніях Telegram Ads. Детальніше читайте нижче в розділі Трекінг конверсій для посилань всередині Telegram у кампаніях Telegram Ads.

Важливо

Макрос {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.
  2. Натисніть на профіль у правому верхньому куті.
  3. Знайдіть параметр token і скопіюйте його, натиснувши на кнопку .

  

• campaignid — ID рекламної кампанії AdsGram, до якої належить конверсія. Відповідає значенню макроса {campaign_id}, що передається в рекламному посиланні. AdsGram підставляє значення макроса під час переходу користувача за посиланням.

• goaltype — Параметр, що вказує тип конверсії (етап воронки), який допомагає сегментувати різні цільові дії користувача. Приймає цілочисельні значення від 1 до 3.

  Використання goaltype:

  1. Визначте етапи воронки у вашому продукті або сервісі.
  2. Співставте етапи зі значеннями goaltype:
     • 1. Реєстрація
     • 2. Перший депозит/покупка
     • 3. Повторний депозит/покупка
  3. Налаштуйте відправку конверсій на потрібних етапах користувацького шляху.
  4. Додайте параметр goaltype до вашого API-запиту при відправці.
  5. Використовуйте дані в аналітиці для детального аналізу ефективності за різними типами конверсій.

Як налаштувати відправку конверсій:

1. Виберіть кампанію в Telegram Ads. Використайте наявну активну кампанію або створіть нову.
2. Налаштуйте рекламне посилання. Переконайтеся, що в ньому є макрос {campaign_id}.
3. Отримайте token. Скопіюйте унікальний токен із рекламного кабінету AdsGram.
4. Налаштуйте відправку постбеків. На боці вашого сервера надсилайте API-запит до AdsGram, коли користувач виконує цільову дію.
5. Передавайте правильний тип конверсії. Вказуйте відповідне значення goaltype, якщо хочете розрізняти етапи воронки.
6. Перевірте інтеграцію. Виконайте тестовий сценарій із розділу Тестування інтеграції і переконайтеся, що конверсії надходять у статистику 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}.
2. Дочекайтеся кількох кліків за рекламним посиланням.
3. Надішліть тестовий постбек вручну, передавши параметр goaltype=1. Використайте дійсний token та ID тестової кампанії в параметрі campaignid.
4. Переконайтеся, що запит оброблено успішно, а конверсія з'явилася в статистиці 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;
• Боти — запуск бота;
• Канали — підписка на канал.

Конверсії передаються автоматично, тому додаткове налаштування не потрібне.