CAPI Events

This guide explains how to configure the Conversions API events AdTarget sends to Meta when users join your Telegram channel.

Available Event Types

AdTarget can send these standard Meta events:

Event	Best For	Meta Optimization
Lead	Lead generation campaigns	Optimizes for lead intent
CompleteRegistration	Signup-focused campaigns	Optimizes for registration actions
Subscribe	Subscription campaigns	Optimizes for subscription intent
Contact	Inquiry campaigns	Optimizes for contact actions

Choosing the Right Event

Running lead gen ads? Use Lead — This tells Meta “this person became a lead.”

Running signup campaigns? Use CompleteRegistration — Signals a completed signup action.

Promoting a channel subscription? Use Subscribe — Matches the user action (joining = subscribing).

Tip: Match your event type to your campaign objective in Ads Manager for best results.

Configuring Events

Set Default Event Type

Go to Settings → Meta Integration in your dashboard
Find Default Event Type
Select your preferred event from the dropdown
Click Save

All Telegram joins will send this event type.

Per-Channel Events (Optional)

You can override the default for specific channels:

Go to Channels
Click on a channel
Under Meta Settings, select a different event type
Click Save

Useful when different channels have different campaign objectives.

Event Parameters

Each event AdTarget sends includes these parameters:

Required Parameters

Parameter	Description
`event_name`	The event type (Lead, etc.)
`event_time`	Unix timestamp of the join
`action_source`	Always “website”

Attribution Parameters

Parameter	Description
`fbclid`	Meta click ID from the ad
`fbc`	Click tracking cookie value
`fbp`	Browser tracking cookie value

User Data (Hashed)

If available, AdTarget sends hashed user data:

Parameter	Source
`external_id`	Telegram user ID (hashed)
`client_ip_address`	IP from landing page visit
`client_user_agent`	Browser from landing page visit

All user data is SHA-256 hashed before sending, as required by Meta.

Event Deduplication

AdTarget includes a unique event_id with each event to prevent duplicates:


event_id: "adtarget_{conversion_id}_{timestamp}"

This ensures the same conversion isn’t counted twice, even if retried.

Testing Events

Test Event Tool

Go to Meta Events Manager
Select your Pixel
Click Test Events
Find your test server name
In AdTarget, click Send Test Event
Watch for the event in Events Manager

Test in Production

Click your own ad (or use a test ad)
Visit your landing page
Join your Telegram channel
Check Events Manager within 5 minutes

Event Matching

Meta matches your events to users for attribution. Higher match quality = better optimization.

Match Quality Factors

Factor	Impact
fbclid present	High - Direct click attribution
User agent + IP	Medium - Probabilistic matching
External ID	Medium - Cross-device matching

Improving Match Quality

Capture fbclid: Ensure your landing page URL preserves the fbclid parameter
Send events promptly: Shorter time between click and conversion improves matching
Consistent user journey: Keep users on your domain before redirecting to Telegram

Common Event Configurations

Lead Generation


Event Type: Lead
When: User joins channel
Use Case: "Get subscribers" campaigns

Content Subscription


Event Type: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Multi-Channel Setup


Channel A (free content): Lead
Channel B (premium): Subscribe
Channel C (support): Contact

Troubleshooting

Events not matching?

Check fbclid is in the landing page URL
Verify Meta Pixel is also on the landing page
Ensure cookies aren’t blocked

Event quality score is poor?

Increase the data you send (IP, user agent)
Reduce time between click and conversion
Verify fbclid is being captured

Duplicate events?

AdTarget handles deduplication automatically
If seeing duplicates, contact support

Best Practices

Match event type to campaign objective for better optimization
Use the same event type consistently within a campaign
Monitor event quality in Events Manager weekly
Test before scaling ad spend

Next Steps

Your Meta integration is complete! Start running ads and watch your conversions flow into Meta.

Need help optimizing? Contact our support team.