Telegram Conversion Tracking
Set up Telegram conversion tracking to track channel joins as Meta ad conversions with accurate attribution.
Telegram conversion tracking allows you to track Telegram channel joins as conversions for your Meta advertising campaigns, providing accurate attribution and optimization data.
Overview
Telegram conversion tracking enables:
- Channel Join Tracking: Track when users join your Telegram channels via ad clicks
- Conversion Attribution: Automatically attribute conversions to specific campaigns, ad sets, and ads
- Meta Conversion API: Send conversion events directly to Meta's Conversion API
- Real-Time Tracking: Track conversions in real-time as they happen
- Performance Optimization: Use conversion data to optimize your Meta campaigns
Prerequisites
Before setting up Telegram tracking, you need:
- A Telegram account
- A Telegram bot (created via @BotFather)
- A Telegram channel you want to track
- Meta account connected (for sending conversions)
- Admin access to the Telegram channel
Creating a Telegram Bot
Step 1: Create Bot via BotFather
- Open Telegram and search for @BotFather
- Start a chat and send
/newbot - Follow the prompts to:
- Choose a name for your bot
- Choose a username (must end in
bot)
- Save the bot token provided by BotFather
Step 2: Configure Bot Permissions
- Send
/setjoingroupsto BotFather - Select your bot
- Choose Enable to allow the bot to detect channel joins
Setting Up Tracking in Dashboard
Step 1: Connect Telegram Bot
- Navigate to Integrations → Telegram
- Click Connect Telegram Bot
- Enter your bot token from BotFather
- Click Connect
Step 2: Add Tracking Channel
- In Telegram → Channels, click Add Channel
- Enter your channel username (without @)
- Select the Meta ad account to attribute conversions to
- Configure conversion event settings:
- Event Name: Choose a name (e.g., "Telegram Join")
- Conversion Value: Set optional value
- Event Time: Use click time or join time
Step 3: Generate Tracking Links
- Go to Telegram → Tracking Links
- Click Create Tracking Link
- Configure the link:
- Campaign: Select the Meta campaign
- Ad Set: Select the ad set (optional)
- Ad: Select the specific ad (optional)
- Channel: Select the Telegram channel
- Destination URL: Your Telegram channel invite link
- Copy the generated tracking link
- Use this link in your Meta ad creative
How It Works
User Journey
- User Clicks Ad: User clicks your Meta ad with the tracking link
- Redirect: User is redirected through the tracking link to Telegram
- Channel Join: User joins your Telegram channel
- Event Detection: Bot detects the channel join
- Conversion Sent: Conversion event is sent to Meta Conversion API
- Attribution: Conversion is attributed to the specific campaign/ad set/ad
Conversion Attribution
Conversions are attributed with:
- Campaign ID: The Meta campaign that drove the click
- Ad Set ID: The ad set (if specified)
- Ad ID: The specific ad (if specified)
- Click Time: When the user clicked the ad
- Event Time: When the user joined the channel
- User Data: Hashed user identifiers for matching
Managing Tracking Links
Viewing Tracking Links
- Navigate to Telegram → Tracking Links
- See all active tracking links
- View click counts and conversion counts
- See last activity time
Editing Tracking Links
- Find the tracking link you want to edit
- Click Edit
- Modify settings as needed
- Save changes
Deactivating Tracking Links
- Go to Telegram → Tracking Links
- Find the link to deactivate
- Click Deactivate
- Confirm the action
Note: Deactivated links won't track new conversions but historical data is preserved.
Conversion Events
Event Types
- Channel Join: User joins the Telegram channel
- Custom Events: Additional events you can configure
Event Data Sent to Meta
Each conversion event includes:
- Event Name: The conversion event name
- Event Time: When the conversion occurred
- User Data: Hashed email, phone, or other identifiers
- Action Source: "website" or "other"
- Campaign Data: Campaign, ad set, and ad IDs
- Conversion Value: Optional monetary value
Troubleshooting
No Conversions Tracking
If conversions aren't tracking:
- Check Bot Token: Verify the bot token is correct
- Verify Bot Permissions: Ensure bot can detect channel joins
- Check Channel Access: Confirm bot is added to the channel
- Verify Tracking Link: Ensure you're using the correct tracking link
- Check Meta Connection: Verify Meta account is connected
Missing Attribution
If conversions aren't attributed:
- Check Link Configuration: Verify campaign/ad set/ad IDs are correct
- Review Click Data: Check if clicks are being tracked
- Verify Meta API: Ensure Conversion API is properly configured
- Check Event Time: Verify event timing is within Meta's attribution window
Bot Not Detecting Joins
If the bot isn't detecting joins:
- Add Bot to Channel: Ensure bot is added as admin to the channel
- Check Bot Permissions: Verify bot has permission to see members
- Review Bot Settings: Check bot configuration in BotFather
- Test Manually: Try joining the channel yourself to test
Best Practices
- Unique Links: Use different tracking links for different campaigns
- Link Organization: Organize links by campaign or client
- Regular Monitoring: Check conversion tracking regularly
- Test Before Launch: Test tracking links before launching campaigns
- Documentation: Keep track of which links are used in which ads