Postback: basics

A postback is an effective tool for automating data transfer between systems.

If you use your own conversion tracking system with Catuik, add your server’s web address (postback URL) to Catuik to receive conversion data instantly. Catuik sends the data to your server using GET or POST HTTP requests. Setting up a postback provides fast, accurate data collection, helping you improve analysis and increase ad conversion rates.

How to add a postback

1. Open the profile menu → Postback.
2. Click Add postback.

You can add multiple postback URLs and configure them for different needs.

3. On the Add postback page, complete the fields:
   • Postback name — enter a name that reflects the data being sent or includes your server name.
   • HTTP method — select the method you want to use to receive data.

The main difference between GET and POST is how the data is sent:

• GET sends all collected data as part of the URL by appending parameters and their values to the end of the link;
• POST sends the data in the request body rather than in the URL.

• URL — enter the URL of your server where the HTTP request will be sent.
• Parameter — select the tracking parameters to send to your server and enter the names already used for them in your system.

4. Click Test to check the postback immediately.
   • If the test is successful, you will see a confirmation notification.
   • If the test fails, make sure the server URL is correct and available, or contact support at support@catuik.com.
5. Click Save in the upper-right corner of the page. The postback appears in the list on the Postback page.

Manage your postbacks on the Postback page.

To enable or disable a postback, use the Activation toggle.

To edit or delete a postback, click the three-dot menu in its row and select the required action.

Request parameters

• id — unique conversion ID.
• date — conversion date.
• subid — a tag for detailed tracking and analysis of conversion sources. You can add a subid when creating an affiliate link via the API or manually.
• publisher_fee — your commission.
• total_cart — cart amount for CPA orders.
• ip — IP address of the user who clicked the link.
• currency — currency used for the conversion.
• status — conversion status. Three values are possible:
  • pending — “Pending”;
  • approved — “Approved”;
  • declined — “Declined”.

Request example

You selected the following tracking parameters to send to your server: id, publisher_fee, and status.

A GET HTTP request will look like this:

https://example.com/foo/bar?conversion_id=564b70fd-62f8-4a31-930a-64f31a7a5c10&amount=10.57&status=pending

A POST HTTP request will look like this:

{
  "conversion_id": "564b70fd-62f8-4a31-930a-64f31a7a5c10",
  "amount": 10.57,
  "status": "pending"
}