Overview
This guide shows you how to:
1. Confirm your LeadTruffle widget sends events to Google Analytics 4 (GA4).
2. See UTM and click-ID tracking inside LeadTruffle.
3. Send those events into Google Ads as conversions — including optional offline conversions.
1. Prerequisites
Requirement | Why it’s needed |
GA4 tag on every page | Fires events and receives gclid/UTM data. |
LeadTruffle widget, popup, or JS form | Emits events automatically — no extra code required. |
Google Ads auto-tagging ON | Allows Ads to drop a gclid/gbraid/wbraid that LeadTruffle captures. |
2. Events we send to GA4
Action | GA4 event name | Usage |
Widget opens | leadtruffle__widget__open | Audience building |
Widget form submitted | leadtruffle__widget__form_submitted | Primary conversion |
Popup viewed | leadtruffle__popup__viewed | Impression tracking |
Popup submitted | leadtruffle__popup__submitted | Primary conversion |
Popup dismissed | leadtruffle__popup__dismissed | UX insight |
JS form displayed | leadtruffle__embed__form_displayed | Engagement tracking |
JS form submitted | leadtruffle__embed__form_submitted | Primary conversion |
3. Mark Events as Conversions in GA4
Sign in to GA4.
Go to: Admin → Data display → Events.
Find your desired LeadTruffle event (e.g., leadtruffle__widget__form_submitted).
Toggle Mark as key event.
GA4 will now treat it as a conversion for future hits.
4. Link GA4 to Google Ads
In GA4, go to: Admin → Product links → Google Ads links.
Click Link, choose your Ads account, and follow the prompts.
Wait ~1 hour — your new GA4 “key event” will appear in Google Ads → Tools & Settings → Conversions.
💡 Tip: Adjust look-back window or value in Ads conversion settings as needed.
5. (Optional) Send Offline Conversions to Google Ads
If you score leads later (e.g., after a phone quote), you can send those results to Ads with the original gclid.
Steps:
Create an Offline Conversion Action in Google Ads.
POST gclid, conversion_time (ISO 8601), and optional conversion_value via:
Google Ads API, or
Zapier “Upload Offline Conversion” action.
6. Troubleshooting
Issue | Cause | Fix |
No events in GA4 | GA4 tag missing or loaded after LeadTruffle | Load GA4 before LeadTruffle or use GTM |
gclid missing | Auto-tagging off or routing strips query params | Enable auto-tagging & preserve query strings |
Conversions missing in Ads | GA4 not linked or event not marked | Link GA4 to Ads & mark events as key events |
Duplicate conversions | GA4 import + offline upload | Use one method or add order_id to de-dupe |
FAQ
Do I need Google Tag Manager?
No — gtag.js works fine, but GTM is great for advanced setups.
Does LeadTruffle support the Google Ads Conversion API?
Indirectly — we expose gclid + timestamps for Zapier/API use.
Can I see campaign/ad data in LeadTruffle?
Not yet — use GA4 or Looker Studio.
Do phone call leads get tracked?
Yes, if the form was filled before the call. Call-only ad clicks are not captured yet.
Need help? Contact us at [email protected] or message the team via the Intercom chat on this article or in-app.