How to Report Offline Conversions via API (Server-Side)

It lets you attribute real business results such as:

• Purchases
• Completed signups
• Booked demos
• App installs
• Any custom acquisition event

These conversions typically happen later in your backend , not on the landing page itself.

---

How Offline Conversion Tracking Works

1. A visitor lands on a Superfunnel page.

2. They click to your website or app.

3. Superfunnel automatically attaches a unique session identifier to the URL.

4. The user converts later in your product or backend.

5. Your server sends the conversion back to Superfunnel via API.

This connects the offline conversion to the original visit and campaign.

---

API Endpoint

When a user goes from the landing page to an external link, the system transfers along with the URL a unique session ID. It looks like this:

Send a POST request to:

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

Required Headers

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

You will receive your API key during implementation.

---

Step 1: Capture the Session Identifier

When a visitor leaves your landing page, Superfunnel appends tracking identifiers to the URL.

Example identifiers:
• sessionId
• sessionHash
• visitHash
• gclid / fbclid / msclkid

Store this value in your backend when the user signs up or purchases.

---

Step 2: Send the Offline Conversion From Your Server

When the user completes the acquisition event, send a POST request from your backend.

Example Using sessionId

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

Parameters

---

Example Using Ad Click IDs

You can also report conversions using advertising identifiers.

Supported IDs:
• gclid (Google Ads)
• fbclid (Meta Ads)
• msclkid (Microsoft Ads)

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

---

Supported Identifiers

You can send any one of the following:

• gclid
• fbclid
• msclkid

• sessionId
• hash
• sessionHash
• visitHash
• shortHash
• shortSessionHash
• shortVisitHash

Use whichever identifier your backend stores.

---

Step 4: Send Conversion Value (Optional)

You can attach a monetary value to the offline conversion.

Example With Value

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

This enables revenue and ROI reporting inside Superfunnel.

---

Where to See Offline Conversions

Once your server sends offline conversions, they will appear in the Dynamic Pages dashboard.

To view them:

1. Go to Dynamic Pages from the left sidebar

2. Find the landing page that generated the traffic

3. View the updated analytics columns