ClickFunnels install
TrueMetriks tracks every ClickFunnels lead, purchase, subscription charge, and refund so you can attribute them back to your ads. Here is how to set it up.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
What gets tracked
ClickFunnels needs two pieces: a tracking snippet in your funnel head (PageView and InitiateCheckout) and a webhook in your ClickFunnels account (Lead, Purchase including every recurring subscription and payment-plan charge, and Refund). Both ClickFunnels versions use the same setup and the same Webhook URL, so skip to the version you use below.
ClickFunnels 2.0
Copy the tracking snippet from your dashboard
In your TrueMetriks dashboard, go to Settings > Tracking, pick the ClickFunnels tile, and click Copy on the Tracking snippet.
Showing setup for ClickFunnels
Install on ClickFunnels
Paste the snippet in your funnel head and add the webhook URL in your ClickFunnels workspace for purchase events.
1 TRACKING SNIPPET
<script async src="https://q.yourdomain.com/t/s-cf/abcd1234.js"></script>
ClickFunnels 2.0: Funnel settings → Head Code. Classic: Funnel settings → Head Tracking Code.
Checkout URL pattern
Webhook URL
CF 2.0: Workspace Settings → Webhooks → Add endpoint. Subscribe to contact.created, orders/invoice.paid, orders/invoice.refunded. Classic: Funnel Settings → Manage Funnel Webhooks → All Events.
Checkout URL pattern. By default the tracker fires InitiateCheckout whenever the page URL contains the word checkout, so make sure your checkout step has checkout in its URL. If you use a different word (order, cart, payment, etc.), change the value in the Checkout URL pattern field on this card and click Save.
Open Funnels in ClickFunnels
In ClickFunnels, click Funnels in the left sidebar. On the Funnels page, click the funnel you want to track.
Funnels
Open Funnel Settings
Once you are inside the funnel, click the gear icon in the top right corner. That opens Funnel Settings in a side panel.
Paste the snippet into Head Code
In the Funnel Settings panel, scroll to Head Code, paste the Tracking snippet you copied earlier, then click Save.
Your Funnel Settings
Name
Domain
Head Code
Set custom code before the </head> tag of all pages in this Funnel.
Footer Code
Repeat this on every funnel you want tracked. ClickFunnels 2.0 head code is scoped per-funnel, not workspace-wide.
Open Workspace Settings
To capture leads, purchases, and refunds you also need to install a webhook. In the ClickFunnels 2.0 left sidebar, scroll to the bottom and click Workspace Settings.
ClickFunnels
- Funnels
- Products
- Customers
- Learn & Connect
Open Webhooks
Inside Workspace Settings, scroll the menu and click Webhooks near the bottom.
Click Add new endpoint
You land on the Webhooks endpoints page. Click Add new endpoint to open the endpoint form.
WORKSPACE SETTINGS : WEBHOOKS
Webhooks endpoints
Webhooks endpoints
Below is a list of external endpoints we will try to deliver webhooks to.
No endpoints yet - click Add new endpoint to add one.
Copy the Webhook URL from your dashboard
Before filling the endpoint form, jump back to your TrueMetriks install card and copy the Webhook URL (the second value on the card, under the tracking snippet).
Showing setup for ClickFunnels
Install on ClickFunnels
Paste the snippet in your funnel head and add the webhook URL in your ClickFunnels workspace for purchase events.
TRACKING SNIPPET
<script async src="https://q.yourdomain.com/t/s-cf/abcd1234.js"></script>
Checkout URL pattern
2 Webhook URL
Paste this URL into the CF 2.0 endpoint form on the next step.
Fill in the endpoint form
Back in ClickFunnels, fill the endpoint form in this order:
- Name - call it
TRUEMETRIKS PURCHASE TRACKING(or anything you will recognize later). - URL - paste the Webhook URL you just copied.
- Event types - pick the three events TrueMetriks needs:
contact.created,orders/invoice.paid, andorders/invoice.refunded. - Endpoint scopes > Funnels - pick the funnel (or funnels) you want this endpoint to fire on. Leave Pages empty.
Click Create endpoint at the bottom.
WORKSPACE SETTINGS : WEBHOOKS
TRUEMETRIKS PURCHASE TRACKING
Edit webhooks endpoint settings
1Name
2URL
Paste the Webhook URL you just copied.
3Event types
Endpoint scopes
4Funnels
ClickFunnels Classic (1.0)
Open your funnel
In the top navigation click Click Funnels. From the Funnels list click the funnel you want to track.
Funnels
Open Funnel Settings
Inside the funnel, click the SETTINGS tab in the top right of the funnel toolbar.
Paste the snippet into Head Tracking Code
The code you need is the Tracking snippet on your TrueMetriks install card - the same snippet you would use for CF 2.0.
Showing setup for ClickFunnels
Install on ClickFunnels
Paste the snippet in your funnel head and add the webhook URL in your ClickFunnels workspace for purchase events.
1 TRACKING SNIPPET
<script async src="https://q.yourdomain.com/t/s-cf/abcd1234.js"></script>
ClickFunnels 2.0: Funnel settings → Head Code. Classic: Funnel settings → Head Tracking Code.
Checkout URL pattern
Webhook URL
CF 2.0: Workspace Settings → Webhooks → Add endpoint. Subscribe to contact.created, orders/invoice.paid, orders/invoice.refunded. Classic: Funnel Settings → Manage Funnel Webhooks → All Events.
Copy that snippet, then on the funnel Settings page scroll down to Head Tracking Code, paste it in, and click Save Funnel Settings at the bottom of the page.
Edit Settings For This Funnel
NAME
DOMAIN
HEAD TRACKING CODE
Funnel wide tracking code for the head tag
Open Manage Your Funnel Webhooks
Stay on the same Settings page and scroll further down to the Webhooks block. Click Manage Your Funnel Webhooks.
Webhooks
Use webhooks to send data to an external system. Funnel Webhooks are triggered when a new contact is created or updated and when a new purchase is created or updated.
Click + New Webhook
On the Active Funnel Webhooks page, click + New Webhook in the top right.
Back
Active Funnel Webhooks
No active webhooks yet - click + New Webhook to add one.
Copy the Webhook URL from your dashboard
Before filling the form, jump back to your TrueMetriks install card and copy the Webhook URL (the second value on the card, under the tracking snippet).
Showing setup for ClickFunnels
Install on ClickFunnels
Paste the snippet in your funnel head and add the webhook URL in your ClickFunnels workspace for purchase events.
TRACKING SNIPPET
<script async src="https://q.yourdomain.com/t/s-cf/abcd1234.js"></script>
Checkout URL pattern
2 Webhook URL
Paste this URL into the CF 2.0 endpoint form on the next step.
Fill in the webhook form
Back in ClickFunnels, fill the New Funnel Webhook form in this order:
- URL - paste the Webhook URL you just copied.
- Event - keep
All Events(simplest). If you prefer to subscribe explicitly, the minimum needed iscontact_createdandpurchase_created. Refunds and recurring charges come throughpurchase_updated, which is included inAll Events. - Version -
1 - Adapter -
attributes
Click Create Funnel Webhook at the bottom.
New Funnel Webhook
Need some help setting this up? Review our support document.
1URL
Paste the Webhook URL you just copied.
2Event
Or pick at minimum contact_created and purchase_created.
3Version
4Adapter
Classic ClickFunnels scopes webhooks per-funnel. If you have multiple funnels, repeat these steps on each one - paste the same Webhook URL every time.
Subscriptions and payment plans
Subscriptions and payment plans need nothing extra. TrueMetriks labels each charge as a new sale or a renewal.
The first payment of a subscription or a payment plan is a new sale.
Every later charge on the same order is a renewal. Each installment of a payment plan after the first counts as a renewal.
Classic. Classic renewals appear only once ClickFunnels sends a charge id with the update.
Free trials. When a subscription starts with a free trial, the first paid charge after it is the new sale.
Renewals inside TrueMetriks. A renewal stays a Purchase in your dashboard, so Total revenue includes it. It is credited to the channel that won the subscription's start (the first sale, or the trial signup for a free trial). This applies going forward: payments made before launch are not relabelled.
What your ad platforms receive. A first payment always goes to your ad platforms as a Purchase. For renewals, open Settings > Integrations, click the Subscription renewals tile and pick one under Send renewals to ad platforms as: a custom event (named Renewal unless you change it), a Purchase, or don't send. The tile shows the current choice. The setting is one per site and covers every payment source.
Sites that existed before this setting started on Purchase, so nothing changes for them until they pick another option. Sites created after launch start on a custom event named Renewal.
When renewals go out as a custom event or are not sent, they are not uploaded to Google Ads. When they go out as a Purchase, they upload to Google Ads like any other Purchase.
On Facebook, a custom conversion keyed on Purchase does not fire for a renewal sent as a custom event.
Known limits. A subscription that started before launch keeps its current crediting unless the source supplies a start date. A free trial that is running at launch labels its first paid charge as a renewal for one trial length.
See Revenue for how renewals show in your dashboard.
Refunds
ClickFunnels 2.0. Refunds need nothing extra. A refund you issue in ClickFunnels 2.0 is taken off the sale it belongs to, through the orders/invoice.refunded event you picked in the endpoint form.
The sale keeps its date and its ad, so the refund lowers revenue, ROAS and profit on the day of the sale. See Refunds on the Revenue page.
A full refund always comes off. A partial refund comes off only when ClickFunnels says how much was refunded; when it sends only a partly-refunded status, the sale stays as it was.
ClickFunnels Classic. Classic does not send refunds TrueMetriks can match to a sale. To take a Classic refund off, send it to a receiving webhook with the event type Refund, for example from Zapier or Make.
The body must carry the sale's order ID exactly as TrueMetriks stored it as order_id. For Classic that is the purchase ID, an underscore and the charge ID, for example 12345678_ch_3NxAbc. When ClickFunnels sent no charge ID it ends in _init.
In one-sale-per-product mode, send one refund per product, with _ and the product ID added to the end. See Refunds by webhook for the fields.
Refunds never go to your ad platforms. They only change your numbers in TrueMetriks.
GoHighLevel calendars on ClickFunnels pages
If you embed a GoHighLevel booking calendar on a ClickFunnels page, every booking made through it is tracked automatically as a Schedule event. There is nothing extra to install: the ClickFunnels tracking snippet already in your funnel head picks it up, as long as the calendar uses GoHighLevel's standard embed code.
The Schedule carries the booker's email, name and phone, so it is sent to your connected ad platforms and matched back to the ad that brought them in. It records once per booking, whether the calendar sends the visitor to a thank-you page or keeps them on the same page.
This covers GoHighLevel calendars only. A GoHighLevel form embedded on a ClickFunnels page does not record a Lead; your ClickFunnels leads come from ClickFunnels' own forms through the webhook above.
Privacy and consent
Set your privacy mode in the TrueMetriks dashboard under Settings, Privacy & Security. There is nothing to change in ClickFunnels: the snippet picks up the mode on its own.
In Consent banner (GDPR) mode the banner shows on your funnel pages. A funnel on its own domain asks visitors again, because the answer is remembered per domain.
In Consent banner (GDPR) mode a sale from the ClickFunnels webhook is passed on to your ad platforms only when the buyer clicked Accept on your pages with the same email address. See GDPR and HIPAA compliance.
How to test
After installing the snippet (and the webhook), the next step is verifying everything is firing correctly. See Test your integration for the full walkthrough.
Something not firing? See Troubleshooting.
Frequently asked questions
Which ClickFunnels version do I have - Classic or 2.0?
If your dashboard URL contains myclickfunnels.com you are on ClickFunnels 2.0. If it contains app.clickfunnels.com and your funnels live under Click Funnels > Funnels, you are on Classic ClickFunnels (1.0). Both are supported.
Does the same Webhook URL work for both versions?
Yes. TrueMetriks auto-detects the ClickFunnels version from the webhook payload shape and headers. Copy the same Webhook URL into either Workspace Settings (2.0) or per-funnel Manage Funnel Webhooks (Classic).
Are subscriptions and payment plans tracked?
Yes. On ClickFunnels 2.0 every recurring charge fires an orders/invoice.paid webhook that TrueMetriks records as its own Purchase, labelled as a renewal after the first payment. On Classic, recurring charges fire purchase_updated, which TrueMetriks records per charge as a renewal when ClickFunnels includes the charge id with it. Some Classic subscription updates arrive without one and cannot be counted. Refunds on 2.0 are taken off the sale automatically; on Classic, send them through a receiving webhook (see Refunds on this page).
Are ClickFunnels refunds taken off my revenue?
On ClickFunnels 2.0, yes, automatically, through the orders/invoice.refunded event you already subscribed to. ClickFunnels Classic does not send refunds TrueMetriks can use, so send Classic refunds to a receiving webhook with the event type Refund. Its order_id must be the sale's order ID exactly as TrueMetriks stored it: the purchase ID, an underscore, then the charge ID (for example 12345678_ch_3Nx...).
What is the Checkout URL pattern?
ClickFunnels does not natively fire a checkout event on the page. TrueMetriks watches the URL and, when it contains the word you configure (default checkout), fires an InitiateCheckout event so you get a checkout-step funnel in the dashboard. Set it to whatever appears in your checkout-page slug.
Does TrueMetriks send AddToCart on ClickFunnels?
No. ClickFunnels has no cart event on the page, so TrueMetriks sends InitiateCheckout when a visitor opens a page matching your Checkout URL pattern, and never AddToCart. Add to cart is not being counted as a checkout. To also send AddToCart, call window.tmFireEvent("AddToCart") from a script in your funnel head, underneath the TrueMetriks snippet, on the page where you want it.
Do I need to install the webhook on every funnel?
On ClickFunnels 2.0 you install the webhook once at workspace level and scope it to the funnels you want, via the Funnels field on the endpoint. On Classic, webhooks are per-funnel - install one webhook per funnel you want tracked, using the same Webhook URL each time.
Is a GoHighLevel calendar embedded on a ClickFunnels page tracked?
Yes. Every booking made through a GoHighLevel calendar on a ClickFunnels page records a Schedule event automatically, with nothing extra to install. This covers calendars only, not GoHighLevel forms.
Why am I only seeing PageView and not Purchase events?
PageView comes from the head snippet. Purchase comes from the webhook. If you see PageView but no Purchase after a test order, your webhook is missing, archived, or pointing at the wrong URL. Open the dashboard install card and re-copy the Webhook URL.