Conversion Tracking

Attribute signups and purchases to your traffic sources with high precision server-side tracking.

When creating a link on your dashboard, enable the Track Conversion option.

Once active, we will automatically append a unique xfwd_track_id parameter to your Destination URL for every visitor.

https://your-website.com/?xfwd_track_id=UNIQUE_ID

On your landing page, your script should read the xfwd_track_id from the URL query parameters.
Store this value in a persistent storage (e.g., localStorage or a cookie) so it is available even if the user navigates to other pages.

// Example: Get ID from URL
const urlParams = new URLSearchParams(window.location.search);
const trackId = urlParams.get('xfwd_track_id');

if (trackId) {
    localStorage.setItem('xfwd_track_id', trackId);
}
                    

To secure your conversion data, you need an API Key. Go to your API Settings to generate one.
Include this key in the X-API-KEY header of your requests.

When a significant event occurs (like a signup or purchase), retrieve the ID and send it back to our API.

POST https://xfwd.link/api/track/conversion

View Swagger Documentation for Code Generation →

curl -X POST https://xfwd.link/api/track/conversion \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{
    "track_id": "STORED_TRACKING_ID",
    "event_type": "purchase",
    "amount": 29.99,
    "currency": "USD",
    "external_id": "order_123"
  }'
                    

Parameter Reference

Field	Type	Description
track_id	string	Required. The UUID captured from the URL.
event_type	string	Event name (e.g., 'signup', 'purchase', 'lead').
amount	float	Optional. Transaction revenue value.
currency	string	Optional. ISO currency code (e.g., 'USD', 'EUR').
external_id	string	Optional. Your internal reference ID for deduplication.