Tracking

For more detailed tracking of campaign performance and correct attribution of the sources of target actions, it is recommended to use an analytics system.

Types of macros that AdsGram reveals:

For detailed tracking, use macros. AdsGram will automatically replace them with real data in your tracking link.

• {campaign_id}
• {banner_id}
• {publisher_id}
• {click_id}
• {record_data}

WARNING

The following macros must be included in the campaign URL for the Conversion Confirmation API to work correctly:

• {record_data} - required for Web Landing Links, Keitaro and Kochava.
• {campaign_id} - required for Telegram Ecosystem Landing Links.

If the required macro is missing, сonversion tracking will fail without it.

In Telegram Ads campaigns, AdsGram macros are not supported and are not passed into the ad URL. As a result, the Conversion Confirmation API cannot be used for conversion tracking in campaigns running in Telegram Ads.

IMPORTANT

The macro {publisher_id} is revealed only as a unique publisher identifier — without specifying its name or other identifying information.

Example of campaign URL:

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}&record={record_data}

IMPORTANT

If your landing link opens TMA via the start parameter, use the following link, for example:

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

The dashboard highlights the macros added to the link and the ones that are missing .

API for conversion confirmation

For custom analytics systems or direct server integration, use the API.

The API endpoint is a special URL where your server issues a request immediately when a user conversion event is recorded. This allows AdsGram to receive real-time data on campaign results.

Endpoint:

https://api.adsgram.ai/confirm_conversion

Detailed setup guides

• Telegram tracking links — for campaigns in the Telegram ecosystem
• Telegram channel subscribers tracking — for campaigns to Telegram channels
• Web tracking links — for campaigns to web pages
• Partner integrations — integration guides for Adjust, AppMetrica, Keitaro, and Kochava