PeerClick Documentation

PEERCLICK Help Center

Welcome to the PEERCLICK Help Center. You'll find comprehensive guides and documentation to help you start working with the PeerClick Tracker as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Guides

Postback URL / Secure Postback URL

A server-to-server (S2S) postback URL enables the delivery of the offer conversion back to the associated PeerClick campaign. S2S postback URLs are the most secure and reliable method to count conversions, thus it is highly recommended to use this form of automated tracking whenever you can. PeerClick postback URLs are unique to each account and are supplied in both a secure (HTTPS) and nonsecure (HTTP) format.

When using the postback URL, PeerClick requires specific parameters for conversion tracking to work correctly.There might be four distinct parameters in the (secure) postback URL:

Basic setup:

  • cid: It is dedicated to passingPeerClick click ID. The parameter is required to track the registered event.
    You might find also other parameters that are used to pass additional information about the registered tracking event:
  • payout: It is used to pass the revenue amount per conversion; optional parameter
  • status: It is used to track different conversion types; optional parameter
  • txid: It is used to pass a unique transaction ID for each conversion; optional parameter

Advanced setup:

  • The purpose of this article is to present the main idea of using the (secure) postback URLs, so the setup of the custom conversion types is not going to be discussed. For more information on this topic, go to the Tracking Offers with Custom Conversions guide.

In order to track the registered event and make the (secure) postback URL working, you need to:

Offer setup > Offer URL: Take the PeerClick {clickid} token and match it with the adequate parameter from the affiliate network from which you have got the offer. Next, append them to the offer's URL.

Example:
If you have the following offer's URL: http://myofferlink.com that you have received from the network and the affiliate network uses the s2 parameter to track conversions within the postback URL,
the offer's URL should look as follows: http://myofferlink.com?s2={clickid}
Offer setup > Postback URL or Settings > Tracking URLs > Postback URL: Copy the (secure) postback URL from PeerClick and then, change the REPLACE and OPTIONAL strings with affiliate network-specific tokens. Once the strings are replaced, paste the postback URL into the affiliate network's panel.

POSTBACK URL

In the PeerClick platform where the click conversions are registered, a unique clickid value is generated for the click. This unique clickid will be sent to your affiliate network and then, the affiliate network captures it. When the conversion is registered in the affiliate network and the clickid is passed back to PeerClick via S2S postback URLs. When the postback URL gets sent back to PeerClick from the network, the clickid is used to associate it to the original click.

This is the reason why it is necessary to pass clickid to the network. The parameters used to pass values are specific for each different network (or group of networks).

Let's start with a simple example of the postback URL that you need to paste into the affiliate network.

Example:

The clickid is passed to the network and next, compared to the clickid that is passed back; when it is matched in the PeerClick platform, the conversion is registered. To make this work, PeerClick will pass the clickid to the network using the {clickid} token in the offer URL.

An example of the offer URL: http://myofferlink.com?s2={clickid}

When that offer URL is clicked, the {clickid} is replaced with a unique value, for example 91068e8efee1a579a2473e0e0424c3da-146-0328. Below you can take a look at the offer URL sample with the unique clickid value:

http://myofferlink.com?s2=91068e8efee1a579a2473e0e0424c3da-146-0328
Upon click, the postback URL is used to send back the recorded clickid from the network and it looks as follows:

http://your_PeerClick_domain_name.com/postback?cid=#s2#

The above example presents the simplest version of the postback URL. Parameters used in the offer URL such as s2 and placeholder used in the postback URL such as #s2# are only provided for the example's purposes. In the real live campaigns, they need to be in compliance to those ones which are supported by your affiliate network.

SECURE POSTBACK URL
Some affiliate networks require using the secure postback URLs (https://). It means that there is an encrypted connection between the server and your visitors' web browser. The secure postback URL has exactly the same parameters and placeholders as the postback URL, but all data is sent using the HTTPS protocol.

Updated about a year ago

Postback URL / Secure Postback URL


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.