Offline Conversions

Overview

Offline conversions let you report sales or high-value actions that happen outside the browser — for example, a payment processed in your backend — back to ad platforms for better attribution and optimization.

Superfunnel matches your conversion event to the original ad click using gclid (Google), fbclid (Meta), or email/phone hashing.

Endpoint

POST /v1/conversions

Request body

{
  "api_key": "YOUR_API_KEY",
  "conversion_name": "purchase",
  "gclid": "EAIaIQobChMI...",
  "conversion_time": "2024-01-15T14:30:00Z",
  "conversion_value": 149.00,
  "currency": "USD",
  "email": "user@example.com"
}

Response

{
  "success": true,
  "platforms_notified": ["google_ads", "meta"],
  "conversion_id": "conv_01HXQ..."
}

Parameters

Parameter	Type	Required	Description
`api_key`	string	Yes	Your Superfunnel API key
`conversion_name`	string	Yes	Name of the conversion action configured in Superfunnel
`conversion_time`	string	Yes	ISO 8601 timestamp of when the conversion occurred
`conversion_value`	number	No	Revenue value in the specified currency
`currency`	string	No	ISO 4217 currency code (default: `USD`)
`gclid`	string	Conditional	Google Click ID — required for Google Ads attribution
`fbclid`	string	Conditional	Meta Click ID — required for Meta attribution
`email`	string	Recommended	Hashed or plain email for enhanced matching

Google Ads setup

Before reporting conversions, create a conversion action in Google Ads and configure it in your Superfunnel account under Settings → Ad Platforms → Google Ads.

For enhanced conversions, Superfunnel hashes PII (email, phone) before sending to Google. No additional configuration required.