Трекинг

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

Макросы, которые раскрывает AdsGram

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

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

ВНИМАНИЕ:

Для корректной работы 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