Step 1: set up tracking link for publisher
After launching the offer, the publisher can find it in the Publisher Panel > Offers. They need to launch the offer in order to get the tracking link for further usage. It has to include unique identifiers like ext_click_id
to track conversions.
Common parameters to use include:
subsource: Identifies the affiliate ID or the traffic source.
track: Typically used for internal tracking (e.g., UTM tags).
ext_click_id: Publisher's unique click ID, which is essential for postback attribution.
Step 2: configure publisher postback URL
The postback URL is the endpoint where conversion data will be sent from UCLIQ to the publisher’s system. In this step, configure the correct postback link that transmits conversion information when the publisher makes a payment.
For S2S postback integration, make sure the following parameters are included in the postback URL:
Click_id: A unique identifier for the click.
Goal: Alias of the specific goal set for the offer (only for goals).
Sum: The amount of the conversion, based on the payment method used (e.g., CPS, CPL).
It can be set up in the Publisher Panel > Offers > Live >Postbacks:
Or in the Admin Panel > Publishers > Postbacks > Manage > Edit specific Publisher:
Replace placeholders like {sum} and {click_id} with the appropriate dynamic variables used by the advertiser. These parameters must be passed correctly to ensure accurate data tracking.
Step 3: Test Publisher Postback
The Test Postback tool allows you to simulate a conversion for a publisher and verify that the publisher's postback URL receives the data correctly.
-
Go to Offers > Campaigns
-
Click “Edit” on the desired campaign
-
Navigate to the Postbacks tab and add one
-
Click on “Test postback” to expand the form and fill it
What to Fill In
-
ext_click_id
This is the external click ID received from the publisher (often passed via
ext_click_id
in the click URL). It links the test conversion back to the publisher’s system. -
sub_source
Used to simulate a sub-publisher or traffic source if applicable.
-
track
UTM-like parameter, useful for tagging but not passed in postback.
You can get the ext_click_id
from Analytics > Clicks. Look for the test recent clicks associated with this offer and publisher.
Once the required fields (especially ext_click_id
) are entered, click Send test.
Ucliq will simulate a conversion and fire the publisher’s postback URL configured for that offer or globally.
You will receive a status response (e.g., 200 OK
, Error
, etc.).
What Happens Next
-
The system processes the test as a real conversion (but with no financial impact).
-
The publisher postback will be triggered based on the settings and macros.
-
You can view the postback request and response in:
Publishers > Postbacks > Log tab