Трекінг

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

Макроси, які розкриває AdsGram

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

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {device_model}
• {click_id}
• {ip}
• {campaign} — назва кампанії
• {os_version}
• {lang}
• {gaid}
• {idfa}
• {record_data}

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

Для веб-посилань у рекламних кампаніях Telegram Ads тепер також підтримуються такі макроси:

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

Важливо

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

Увага

Для коректної роботи API підтвердження конверсій у рекламному посиланні кампанії повинні присутствувати наступні макроси:

• {record_data} - обов'язковий для веб посилань, а також інтеграцій з Keitaro та Kochava.
• {campaign_id} - обов'язковий для посилань всередині Telegram і для веб-посилань у Telegram Ads.

Якщо обов'язковий макрос відсутній, відстеження конверсій працювати не буде.

У кампаніях 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}&record={record_data}

Важливо

Якщо ваше посадочне посилання відкриває TMA через параметр start, використовуйте, наприклад, наступне посилання:

https://t.me/[name_of_the_bot]?start=[unique_referral_link]_{campaign_id}_{banner_id}_{publisher_id}_{click_id}_{record_data}

Кабінет підсвічує додані в посилання макроси та пропущені .

API для підтвердження конверсій

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

API Endpoint — це спеціальна URL, на яку ваш сервер надсилає запит у момент здійснення користувачем конверсії. Це дозволяє AdsGram у реальному часі отримувати дані про результати кампаній.

Endpoint:

https://api.adsgram.ai/confirm_conversion

Детальні інструкції з налаштування постбеків про конверсії

• Посилання в кампаніях Telegram Ads
• Для посилань всередині Telegram
• Трекінг підписників Telegram-каналу
• Для веб-посилань
• Інтеграції з партнерами — інтеграції з Adjust, AppMetrica, Keitaro та Kochava