Offline Conversion Tracking

Overview

Offline conversion tracking closes the loop between a page visit and a business outcome that happens later in your backend — such as a completed purchase, booked demo, or app install. Your server sends the conversion to SuperFunnel via API, and SuperFunnel attributes it back to the original visit and campaign.

Common conversions to report:

Purchases
Completed signups
Booked demos
App installs
Any custom acquisition event

For developers

This guide is intended for developers. You will need backend access to implement the session identifier capture and API call.

How It Works

A visitor lands on a SuperFunnel page.
SuperFunnel automatically appends a unique session identifier to any outbound URL the visitor clicks.
The visitor converts later — in your product, app, or backend.
Your server sends the conversion back to SuperFunnel via API.
SuperFunnel attributes the conversion to the original visit and campaign.

API Reference

Endpoint

POST https://api.superfunnel.ai/v1/analytics/report-conversion

Required Headers

x-api-key: {apiKey}
Content-Type: application/json

Your API key is provided during implementation. Contact support at support@superfunnel.ai if you need it.

Step 1: Capture the Session Identifier

When a visitor clicks an outbound link from your page, SuperFunnel appends tracking identifiers to the destination URL. Capture and store whichever identifier your backend receives when the user signs up, purchases, or converts.

Identifiers passed by SuperFunnel:

Identifier	Source
`sessionId`	SuperFunnel session
`sessionHash`	SuperFunnel session (hashed)
`visitHash`	SuperFunnel visit
`shortHash` / `shortSessionHash` / `shortVisitHash`	Shortened variants
`gclid`	Google Ads click ID
`fbclid`	Meta Ads click ID
`msclkid`	Microsoft Ads click ID

Store the identifier in your database alongside the user's record so you can reference it when the conversion fires.

Step 2: Send the Conversion From Your Server

When the user completes the conversion event in your backend, send a POST request to the API.

Using a SuperFunnel Session ID

curl --request POST 'https://api.superfunnel.ai/v1/analytics/report-conversion' \
  --header 'x-api-key: {apiKey}' \
  --header 'Content-Type: application/json' \
  --data '{
    "sessionId": "{sessionId}",
    "event": "signup_completed"
  }'

Field	Description
`sessionId`	The identifier captured from the page URL
`event`	A name for the conversion (e.g. `"purchase"`, `"demo_booked"`)

Using an Ad Click ID

If you captured an advertising click ID instead of a SuperFunnel session ID, you can use that to report the conversion.

curl --request POST 'https://api.superfunnel.ai/v1/analytics/report-conversion' \
  --header 'x-api-key: {apiKey}' \
  --header 'Content-Type: application/json' \
  --data '{
    "gclid": "{gclid}",
    "event": "purchase"
  }'

Supported ad click ID fields: gclid, fbclid, msclkid.

Including a Conversion Value (Optional)

Attach a monetary value to enable revenue and ROI reporting inside SuperFunnel.

curl --request POST 'https://api.superfunnel.ai/v1/analytics/report-conversion' \
  --header 'x-api-key: {apiKey}' \
  --header 'Content-Type: application/json' \
  --data '{
    "sessionId": "{sessionId}",
    "event": "purchase",
    "conversion": {
      "value": 120
    }
  }'

Reporting to Ad Platforms

Once a conversion is attributed to its original visit, SuperFunnel can forward it to the ad platform that drove the click — Google Ads, Meta, and others — so your campaigns optimize against real outcomes. Matching is done using the gclid, fbclid, or msclkid captured on the original visit.

Set up the platform first

Connect the platform under Settings → Ad Platforms and configure the matching conversion action before reporting. See the Google Ads integration for a walkthrough.

Viewing Offline Conversions

Once your server is sending conversions, they appear in the Pages dashboard.

Go to Pages from the left sidebar.
Find the page that generated the traffic.
Offline conversions will be attributed to the original visit and variant.

What's Next

Online Event Tracking

Track on-page interactions using the SuperFunnel JavaScript event API.

Analytics Export

Export conversion data for reporting or BI tools.