This is the most important setup for an Enhanced CPL/CPA campaign as it is used to capture a successful conversion when a user reached the conversion page. The conversion data will be used to optimize the campaign performance and for billing purposes. The conversion tracking can be implemented in one of the 3 methods:
1. Server postback URL
2. Image conversion pixel
To access the conversion tracking code for your campaign, go to your campaign detail and click on the Conversion Tracking tab. Within the tab, you will see the tracking codes for you to setup on your system or website.
Server Postback Tracking
Server postback tracking—also called “postback tracking” and “server-side tracking”—is the method of tracking conversions that uses the advertiser’s server rather than the user’s browser (as image pixel-based tracking does). We generally recommend using server postback tracking over image conversion pixel-based tracking because Server Postback is more reliable and accurate.
In addition, Server Postback tracking is required for campaigns that don’t direct to a website, notably for mobile apps or API-integrated campaign.
Implementing Server Postback Tracking
Overview of steps:
- First, the advertiser configures the campaign URL to capture identifiers (PanelPlace Unique ID and Campaign Code) and other optional information (UTMs) sent to the advertiser on click.
- Once a click happens, the advertiser stores session information using one of the mechanisms (Database or Cookies).
- Finally, if the user converts, the advertiser fires a postback to PanelPlace with the session identifier and other information.
Configure Campaign URL
In order to capture the identifiers of each click, advertiser's campaign URL will need to include session parameters to capture the value of an Unique ID and the Campaign Code.
In the campaign URL, match your session parameter with PanelPlace placeholder macro for tracking. The placeholder macro for Unique ID is [member] and the placeholder macro for Campaign Code is [campaign_code].
Parameters themselves can vary in name. For example, if your server expects the Unique ID in a parameter called session_id, then the campaign URL should have session_id=[member] in its query string.
As an example, the campaign URL would then look something like this:
After PanelPlace fills in values for the macros on click, the user is directed to a URL that looks similar to this:
Storing Session Identifiers
The advertiser needs to have some way of keeping track of the Unique ID and Campaign Code so they can report on sessions that convert. Because how to store the sessions depends on the advertiser’s technology, this is the most varied step in the process. Some common methods are: storing the data in a database or storing the data in a cookie.
Storing in Database
In cases where the advertiser stores session information in a database, the Unique ID and Campaign Code value can be stored as session data in the advertiser’s database. This is the most robust way of using server postback tracking because this method benefits from being able to track user conversions across devices and touchpoints. The session data is stored in a database and relates to a specific user, conversions are tracked independently of how the user engaged with the advertisement.
Storing in Cookie
In many cases, the advertiser’s site takes the Unique ID and Campaign Code and stores them as a cookie in the user’s browser.
Upon conversion, the advertiser retrieves the Unique ID value and Campaign Code value from the cookie in the user’s browser. This is simpler for advertisers to implement, and a natural choice for those already tracking user sessions primarily with cookies.
However, if the cookie gets cleared or if the user converts on another browser or device, then the conversion won’t be recorded and causing low quality score for the campaign. As a result, we recommend avoiding this method.
Advertiser Returns ID upon Conversion
When a user from PanelPlace completes a conversion on an advertiser’s site/app, the advertiser needs to tell PanelPlace about the conversion. We call this “firing a postback”. The advertiser does this by sending a signal to our servers that uses two elements:
- The campaign’s postback URL
- The Unique ID and Campaign Code for that session
The postback URL is found in the Campaign Conversion Tracking tab and looks something like this:
In the above URL, the advertiser replaces [campaign_code] and [returnCode] with the value of Campaign Code and Unique ID that they stored for that session, and replaces [YourMemberCode] with advertiser's own unique value for that particular session.
For example, if the advertiser had earlier received an Unique ID of “123456-abcde” and Campaign Code of "SG-ARB-fo28" from PanelPlace, then with their own unique value of "112233" for that session, the postback URL becomes:
In the Postback URL, Channel=web or Channel=api refers to whether this Postback is fired for a web base transaction or a non web base transaction (eg. Mobile apps or API-integrated campaign).
Note: If advertiser's system can only store 1 identifier, advertiser needs to at least store our Unique ID value while hardcode the campaign_code value on the Postback URL. However, this requires advertiser to setup multiple Postback URL if they run multiple campaigns because each campaign has a different campaign code.
Image Conversion Pixel
Pixel tracking—is the method of tracking conversions that uses the user’s browser rather than the advertiser’s server (as server postback tracking does).
The first 2 steps, Configuring Campaign URL and Storing Session Identifiers, are the same as Server Postback tracking, the difference is that user’s browser will load a 1 pixel by 1 pixel HTML container (the “pixel” or “image pixel”) which houses the campaign's conversion URL upon conversion. The advertiser needs to place this pixel on the page that measures the conversion. The advertiser also needs to make sure that the image pixel will only be loaded if the conversion is contributed by PanelPlace.
Upon conversion, the image pixel sends a signal to PanelPlace that includes the session identifier. The user remains on the advertiser website.
Essentially, the conversion URL is the same as the Server Postback URL but it is housed in the HTML container that looks something like this:
<img src="https://trk.pp.com/v?campaign_code=SG-ARB-fo28&channel=web&uid=123456-abcde&cmid=112233" width="1" height="1" border="0">
We suggest avoid using pixel tracking as much as possible because pixel tracking only works for non-mobile web traffic where cookies can be stored. Additionally, major browsers like Safari are moving away from allowing tracking-related cookies even for first parties.