ClickFlare Integration Guide

The ClickFlare integration enables you to send conversion data from CallGrid to ClickFlare for accurate attribution tracking. When a qualifying call event occurs in CallGrid, a postback is automatically sent to ClickFlare, closing the attribution loop and enabling accurate campaign optimization.

Prerequisites

Before setting up this integration, ensure you have:

• An active ClickFlare account
• Your ClickFlare tracking domain (e.g., mylandingpage.com)
• The click ID parameter name used in your ClickFlare campaigns (typically "clickid")
• Understanding of which conversion events you want to track

Configuration Steps

Step 1: Capture the ClickFlare Click ID

Before CallGrid can send conversions back to ClickFlare, you need to capture the ClickFlare click ID when visitors arrive at your landing page.

Landing Page Setup:

Ensure your CallGrid DNI (Dynamic Number Insertion) script is configured to capture the ClickFlare click ID parameter by ensuring the parameter is added as a Tag on your Tags page.

Important: The parameter name must match what you configure in the ClickFlare template (default is "clickid").

Step 2: Configure CallGrid Webhook

Option A: Using Template Mode (Recommended)

1. Navigate to Webhooks in the left navigation
2. Click + New Webhook
3. Enable Template Mode (toggle on)
4. Under "Filter by Template Type," select Conversion Pixel
5. Select ClickFlare from the template dropdown

Configure Template Variables:

6. Enter a Name for your webhook (e.g., "ClickFlare Conversions")
7. Select the Event that should trigger the conversion (e.g., "Call Ended" or "Call Paid")
8. Click Save Webhook

Option B: Manual Configuration (Advanced)

If you need more control over the webhook configuration:

1. Navigate to Webhooks in the left navigation
2. Click + New Webhook
3. Disable Template Mode (toggle off)
4. Configure the following:

Replace:

• YOUR_CLICKFLARE_DOMAIN with your ClickFlare tracking domain
• YOUR_EVENT_NAME with your custom conversion event name

Testing Your Integration

Step 1: Use the Webhook Testing Tool

After saving your webhook, CallGrid provides a testing interface:

1. Fill in test values for each variable:
2. • tag:clickid - Enter a test click ID from ClickFlare
   • tag:CallPayout - Enter a test payout amount (e.g., 25.00)
   • tag:CallId - Enter a unique test ID
   • tag:InboundNumber - Enter a test phone number
2. Click Run Webhook to send a test postback
3. Check ClickFlare to verify the conversion was recorded

Step 2: Live Traffic Validation

1. Generate a test click through your ClickFlare campaign
2. Place a test call to your tracking number
3. Verify the conversion appears in ClickFlare with correct attribution

Event Selection Guide

Choose the appropriate CallGrid event based on your conversion criteria:

Call Inbound

Track calls the moment the inbound call is received

Call Paid

Track only calls that met payout criteria

Call Answered

Track when caller connects to a buyer

Adding Filters

To send conversions only for specific sources or campaigns:

1. Click Add Filter at the bottom of the webhook configuration
2. Select a filter condition (e.g., "Source Name Equals")
3. Choose the specific source from the dropdown
4. Click Save Webhook

This ensures ClickFlare only receives conversion data for the relevant traffic.

Troubleshooting

Click ID Not Capturing

Symptom: Click IDs not appearing in CallGrid call records

Solutions:

1. Verify your the clickid parameter is a Tag on your Tags page.
2. Ensure the parameter name matches exactly (case-sensitive)
3. Check that ClickFlare is passing the click ID in the landing page URL

Conversions Not Appearing in ClickFlare

Symptom: Webhook fires but conversions don't show in ClickFlare

Solutions:

1. Verify your ClickFlare domain is correct
2. Ensure the click ID value matches a valid click in ClickFlare
3. Check that the conversion event name matches your ClickFlare configuration
4. Review CallGrid webhook logs for error responses

Duplicate Conversions

Symptom: Same conversion appearing multiple times in ClickFlare

Solutions:

1. Ensure the txid parameter is mapped to [[tag:CallId]]
2. ClickFlare uses the transaction ID to deduplicate conversions

Revenue Not Matching

Symptom: Payout values differ between platforms

Solutions:

1. Verify [[tag:CallPayout]] is correctly mapped to the payout parameter
2. Check that revenue is calculated at the time the webhook fires
3. Ensure currency formats match between platforms

Best Practices

1. Always use transaction IDs - Include the txid parameter to prevent duplicate conversion tracking
2. Test before going live - Use CallGrid's webhook testing tool before routing live traffic
3. Match domains - Ensure your CallGrid webhook domain matches your ClickFlare tracking domain
4. Filter by source - Add source filters if you're only using ClickFlare for specific traffic sources
5. Monitor regularly - Compare conversion counts between CallGrid and ClickFlare weekly to catch discrepancies early