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

УВАГА

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

Параметри:

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

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

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

  

• record — Унікальне для кожного кліку/показу значення макроса {record_data}, яке AdsGram автоматично підставляє в трекінгове посилання.

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

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

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

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

1. Виберіть кампанію. Використайте наявну активну кампанію або створіть нову.
2. Налаштуйте рекламне посилання. Переконайтеся, що в ньому є макрос {record_data}.
3. Отримайте token. Скопіюйте унікальний токен із рекламного кабінету AdsGram.
4. Налаштуйте відправку постбеків. На боці вашого сервера надсилайте API-запит до AdsGram, коли користувач виконує цільову дію.
5. Передавайте правильний тип конверсії. Вказуйте відповідне значення goaltype, якщо хочете розрізняти етапи воронки.
6. Перевірте інтеграцію. Виконайте тестовий сценарій із розділу Тестування інтеграції і переконайтеся, що конверсії надходять у статистику AdsGram.

Приклад API-запиту:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a&goaltype=2

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

Замініть YOUR_UNIQUE_TOKEN на токен вашого акаунта, а 7f3a1b6c5d2e4f8a — на значення макроса {record_data} з рекламного посилання.

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

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

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

1. Створіть або виберіть кампанію і налаштуйте рекламне посилання відповідно до документації. Переконайтеся, що в посиланні передається макрос {record_data}.
2. Дочекайтеся кількох кліків за рекламним посиланням.
3. Надішліть тестовий постбек вручну, передавши параметр goaltype=1. У параметрі token вкажіть дійсний token, у параметрі record — фактичне значення макроса {record_data} з рекламного посилання, за яким було здійснено перехід.
4. Переконайтеся, що запит оброблено успішно, а конверсія з'явилася в статистиці AdsGram для вибраної кампанії.

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