X (Twitter) Conversions API
Connect TrackFlow to X (Twitter) Conversions API to send purchase and conversion events directly from your server.
Why Use X Conversions API?
- Server-side reliability: Events sent directly without browser limitations
- Better attribution: More accurate conversion tracking
- Privacy-compliant: Works with browser privacy features
- Improved optimization: Better data for campaign optimization
Step 1: Get Your Pixel ID
- Go to X Ads Manager
- Click Tools → Events Manager
- Select your pixel (or create one under Add event source)
- Copy your Pixel ID
Step 2: Generate Conversions API Key
- In Events Manager, click on your pixel
- Go to Implementation tab
- Select Conversions API
- Click Generate API Key
- Copy and save the key securely
Important
The API key is shown only once. Store it securely - you'll need to generate a new one if lost.
Step 3: Add Pixel to TrackFlow
- Go to your store in TrackFlow
- Click Pixels tab
- Click Add Pixel
- Select X (Twitter) Ads
- Enter your Pixel ID and API Key
- Click Save Pixel
Events Sent to X
| TrackFlow Event | X Event | Parameters |
|---|---|---|
| PageView | page_view | page_url |
| ViewContent | content_view | content_id, content_price, currency |
| AddToCart | add_to_cart | content_id, price, currency, quantity |
| InitiateCheckout | checkout_initiated | content_id, price, currency |
| Purchase | purchase | content_id, price, currency, order_id, quantity |
User Data for Matching
TrackFlow sends hashed user data for improved matching:
- hashed_email: SHA256 hashed email address
- hashed_phone_number: SHA256 hashed phone with country code
- twclid: Twitter click ID from URL parameter
- ip_address: Customer IP address
- user_agent: Browser information
Troubleshooting
Events Not Appearing
- Verify your Pixel ID is correct
- Check that your API key is valid and hasn't been regenerated
- Allow up to 24 hours for events to appear in reporting
Low Match Rate
- Ensure twclid parameter is preserved in landing page URLs
- Capture customer email at checkout
- Include country code in phone numbers