Налаштування постбеків про конверсії для посилань всередині Telegram

УВАГА

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

Параметри:

• token — Унікальний токен, пов'язаний з вашим акаунтом AdsGram. Доступний у рекламному кабінеті. За потреби його можна згенерувати повторно.

  Де отримати token:

  1. Відкрийте рекламний кабінет AdsGram.
  2. Натисніть на профіль у правому верхньому куті.
  3. Знайдіть параметр token і скопіюйте його, натиснувши на кнопку .

  

• tgid — Telegram ID користувача, який перейшов за рекламним посиланням.

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

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

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

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

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

1. Виберіть кампанію. Використайте наявну активну кампанію або створіть нову.
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&tgid=98110997&goaltype=2&campaignid=72156

У прикладі передається конверсія типу 2 (наприклад, перший депозит або покупка).

Замініть YOUR_UNIQUE_TOKEN на токен вашого акаунта, 98110997 — на Telegram ID користувача, який перейшов за рекламним посиланням, а 72156 — на ID вашої рекламної кампанії.

Очікувана відповідь: 200 OK — успішна реєстрація конверсії.

Тестування інтеграції

Щоб протестувати відстеження конверсій, виконайте такі кроки:

1. Створіть або виберіть кампанію і налаштуйте рекламне посилання відповідно до документації. Переконайтеся, що в посиланні передається макрос {campaign_id}.
2. Дочекайтеся кількох кліків за рекламним посиланням.
3. Отримайте Telegram ID (tgid) користувача, який перейшов за посиланням вибраної кампанії.
4. Надішліть тестовий постбек вручну. Передайте параметр goaltype=1, дійсний token, Telegram ID користувача в параметрі tgid і ID тестової кампанії в параметрі campaignid.
5. Переконайтеся, що запит оброблено успішно, а конверсія з'явилася в статистиці AdsGram для вибраної кампанії.

• Конверсія з'явилася в статистиці — інтеграцію успішно налаштовано, і вона працює.
• Сервер повернув помилку — перевірте URL запиту та значення параметрів token, tgid, campaignid і goaltype.
• Запит виконано успішно, але конверсія не з'явилася — статистика оновлюється раз на годину. Якщо через годину дані не з'явилися, напишіть у підтримку AdsGram або своєму менеджеру. До звернення обов'язково додайте логи запиту та відповіді.