For the complete documentation index, see llms.txt. This page is also available as Markdown.

How to confirm Action offers via postback

When you create an Action offer, conversions must be explicitly confirmed after the user completes the desired action on your website (e.g., signs up for a trial, makes a purchase, downloads a resource). ​ This guide explains how to confirm Action conversions using a postback. ​ ​How It Works

  1. User clicks offer link

  2. User is redirected to your website → You capture the tracking parameters

  3. User completes the action -> Purchase/Signup/Download/etc..

  4. You call the postback URL → Confirm the conversion with SparkLoop

  5. Conversion is processed


Step 1: Capture the Tracking Parameters

When SparkLoop redirects users to your website, we append a submission query parameter to your redirect URL.

If your offer URL is https://example.com/signup, the user will be redirected to: ​ ​https://example.com/signup?submission=submission_1234abcd ​ ​Important: You must capture and store the submission parameter when the user lands on your site. You'll need it to confirm the conversion later.


Step 2: Confirm the Conversion

Once the user completes your desired action, send a call to your unique postback URL.

GET https://api.sparkloop.app/v2/offers/postbacks/XXX?submission_uuid={submission_uuid}

The postback URL is unique to your offer. You'll find your unique postback URL under your offer's "Conversion Pixel" instructions.

Replace {submission_uuid} with the submission parameter from Step 1.


Important Notes

  • Action conversions expire after 45 days if not confirmed

  • Make sure to confirm conversions as soon as the user completes your desired action

Last updated