All Collections
PeerClick Customer Manual
Postback
Setting up a Standard Postback to PeerClick
Setting up a Standard Postback to PeerClick

Registering a conversion in the tracker with a postback from an affiliate network

Updated over a week ago

General Logic of Setting up a Postback with a cid to PeerClick

1. Sending a cid from the tracker

Cid (click ID) is a unique click identifier generated by the tracker.

The cid is transmitted with the offer link through the {clickid} macro to the side of the offer source (to the platform where the offer link is taken, for example, to the affiliate network),

2. Sending a postback with a cid to the tracker

Postback (s2s postback) is a way of sending conversion data from the server (offer source) to the server (tracker) using the tracker's postback link.

Postback link - the URL used by the offer source to send information about the conversion to PeerClick statistics. The postback link is generated in the offer template settings.

When a conversion is made, the offer source platform registers an event in its database, then sends a postback with the tracker cid value and other necessary data back to the tracker.

Using this logic of work, you can set up a postback both from the affiliate network and from your own website / any other platform, if you have the technical ability to implement receiving and sending the tracker cid.

Conditions for Successful Conversion Registration to the Tracker via Postback

! Without a cid value, the tracker will not register a conversion.

To successfully register a conversion in the tracker, you need:

  • send the tracker cid value to the offer source platform

  • the offer source platform accepts and successfully writes the value of the tracker cid on its side

  • when a conversion is made, the offer source platform sends a postback with the tracker's cid value back to the tracker

  • the tracker receives a postback with the cid value from the offer source platform and registers the conversion in its statistics

Setting up a Postback from Affiliate Network to PeerClick

1. Setting up an offer link in the tracker

Add the affiliate network parameter to the offer URL, which is responsible for receiving the tracker's cid, and the macro {clickid} in the format http(s)://example.com?cid={clickid}, where:

  • http(s)://example.com - your offer address;

  • ? - designation of the end of the offer URL, followed by parameters and their values;

  • cid - affiliate network parameter responsible for receiving the tracker's cid on the affiliate network side. The parameter is taken on the side of the affiliate network;

  • {clickid} - PeerClick macro responsible for sending the tracker's cid, available in the field under the offer link (passed parameter value).

If necessary, add additional affiliate network parameters and corresponding PeerClick macros to the offer URL in the format http(s)://example.com?cid={clickid}&aff_parameter={PeerClick_macro}, where:

  • http(s)://example.com - your offer address;

  • ? - designation of the end of the offer URL, followed by parameters and their values;

  • aff_parameter - affiliate network parameter responsible for receiving tracker data on the affiliate network’s side. The parameter is taken on the side of the affiliate network;

  • {PeerClick_macro} - PeerClick macro (passed parameter value). The macro must be selected from the field under the offer link;

  • & - ampersand separating different parameters in the address.

When adding tracking parameters to a sponsored link, your URL should look like this:

http(s)://advertising-link?affiliate-network-parameter={PeerClick-macro}

If you have the preset Affiliate Network element, you can select it in the offer settings to apply the parameters template. The template preset by the tracker is a recommended setting, not a requirement.

2. Setting up a postback link

Copy the postback link in the offer settings in the tracker and paste it into the appropriate settings section on the side of your affiliate network.

Using this link, your affiliate network will send information that the tracker displays in the Conversions - Input postback log.

Then set up the tracker cid transfer with postback by adding an affiliate network macro to the postback link, which is responsible for transferring the tracker cid back to the tracker.

Your postback URL should look like this:

http(s)://pstb.peerclick.com/postback?cid={clickid}, where:

  • http(s)://pstb.peerclick.com/postback - tracker postback address;

  • ? - designation of the end of the postback URL, followed by parameters and their values;

  • cid - PeerClick parameter responsible for receiving tracker cid;

  • {clickid} - affiliate network macro responsible for transmitting the tracker cid (passed parameter value). Macro is taken on the affiliate network side.

If necessary, set up the transfer of additional data that the affiliate network will send to the tracker.

There can be 6 parameters in a Postback URL:

  • userid: PeerClick five-digit user ID. It is inserted into the postback link template automatically.

  • cid: transfer Click ID (unique click value assigned by the tracker) to PeerClick. The parameter is required to track registered events.

  • payout: transfer the amount of revenue per conversion (optional).

  • status: track various conversion statuses (optional).

  • txid: transmit a unique transaction ID for each conversion (optional).

  • currency: payout currency.

Your postback URL should look like this:

http(s)://pstb.peerclick.com/postback?cid={clickid}&PeerClick-parameter={aff-network-macro}, where:

  • http(s)://pstb.peerclick.com/postback - tracker postback address;

  • ? - designation of the end of the postback URL, followed by parameters and their values;

  • PeerClick-parameter - any of the allowed additional tracker parameters (payout, status, txid) responsible for receiving affiliate network data on the tracker side;

  • {aff-network-macro} - affiliate network macro responsible for transmitting the tracker cid (passed parameter value). Macro is taken on the affiliate network side;

  • & - ampersand separating different parameters in the address.

Did this answer your question?