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}
• {useragent}
• {device_model}
• {click_id}
• {ip}
• {campaign} — campaign name
• {os_version}
• {lang}
• {gaid}
• {idfa}
• {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 and for Web Landing Links in Telegram Ads.

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

In Telegram Ads campaigns, AdsGram macros are not supported for links leading to Telegram Mini Apps (TMA), bots, or channels. Therefore, the conversion confirmation API cannot be used to track conversions from such links in Telegram Ads campaigns. For more information on conversion tracking for links within Telegram in Telegram Ads campaigns, see this section.

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 for conversion postbacks

• Telegram Ads campaigns links
• Telegram ecosystem landing links
• Telegram channel subscribers tracking
• Web landing links
• Partner integrations — integration guides for Adjust, AppMetrica, Keitaro, and Kochava