__________________________________________________________________________________________________________________

This article will review:

• An overview of the Partnerize Clickref tracking solution
• How the brand should implement the solution 
• How to test the solution

❗NOTE: If you have an existing Partnerize solution and wish to upgrade please refer to Optimisation Guides

__________________________________________________________________________________________________________________

Index

• Overview
• Implementation Steps
  • Click Tracking
  • Conversion Tracking
    
    • Explanation of tracking parameters
    • Basket Data parameters
    • Allowed Characters
    • When to trigger Clickref Pixel / Exclusive Code Tracking 
    • Retrospective insert
    • Populated Examples
    • Meta data tracking

    • Vertical Specific Parameters

• Testing

• Next Steps

• FAQ's

Overview

Clickref Pixel tracking is an alternative solution to standard pixel tracking, which is the most common implementation method to record online sales in affiliate marketing. For brands who do not want to implement tracking tags based on 3rd party cookies, Partnerize offers this alternative tracking solution.

The Partnerize Clickref Pixel tracking is suitable for brands who: 

• Do not want to rely on 3rd party cookies
• Are unable to use either the PZ tag or S2S solutions
• Use a 3rd Party container

A ​“Clickref pixel” is an enhanced solution as it utilises the Partnerize ID (“clickref”) to identify sales as opposed to relying on the Partnerize 3rd party cookie. As the advertiser captures the “clickref” in a 1st party context, this avoids the need for any 3rd party cookie tracking to be involved, resulting in an extremely robust and reliable tracking solution.

__________________________________________________________________________________________________________________

Implementation Steps

In order to track sales via the S2S, there are two key components to implement as denoted by the diagram below:

__________________________________________________________________________________________________________________

Step 1 - Click Tracking

All traffic generated by Partnerize publishers, will arrive at the brand's site with a unique 'clickref' parameter appended to the URL. The 'clickref' is an alphanumeric value, which identifies a Partnerize click and all information associated with the click.

• Example 1 :https://www.brandsite.com?clickref=abc123

The brand must capture the value of the 'clickref' parameter, and always store the most recent value in a 1st party cookie on the user’s browser. If a user did not purchase initially and returned later with a new 'clickref', the cookie must be overwritten with the new value and life period reset.

• Example2 : https://www.brandsite.com?clickref=def456

❗NOTE:

• The 'clickref' parameter name can be changed per brand request, but please inform Partnerize in advance.
• The 'clickref' is unique per click so the brand must cookie the most-recent value in order to award commission on a “last click” wins basis. 

__________________________________________________________________________________________________________________

Step 2 - Conversion Tracking

At the point of sale, all transactional information (along with the 'clickref' captured earlier) must be passed into the Clickref pixel conversion call. Please note the conversion URL may differ based on a client specific requirements.

Example conversion url

https://prf.hn/conversion/campaign:{CAMPAIGNID}/tmethod:{TMETHOD}/tplatform:{TPLATFORM}/tdetail:{TDETAIL}/clickref:{CLICKREF}/conversionref:{ORDERID}/country:{COUNTRY}/currency:{CUR}/customertype:{new|existing}/voucher:{VOUCHER}/[category:{CAT}/sku:{SKU}/value:{VALUE}/quantity:{QTY}]

Explanation of tracking parameters

The conversion URL is populated with several parameters to record a valid conversion. These are key-value pairs, using a colon to separate the key-value pair, and a forward slash, to delimit each parameter: 

❗NOTE: If a parameter does not contain any value still include the parameter and leave blank

__________________________________________________________________________________________________________________

Basket Data Parameters 

To record individual items within a conversion, pass the details of each into a specific item container, which is held within square brackets []. The available parameters are listed below. Although not all parameters are required, it is advisable to return as much as possible to increase reporting granularity:

❗NOTE:

• "value"  is multiplied by "quantity" to calculate the total basket cost. 
  • If brand awards % based commission, this total cost is used 
• No Personal Identifiable Information (PII) that a 3rd party could use to identify the end user should be passed into any of the tracking parameters (i.e. email address, home address, phone number, etc).

__________________________________________________________________________________________________________________

Core parameters

The below parameters are deemed as core to the tracking:

• Currency
• Voucher
• Customertype
• Category
• SKU

These parameters should always be present in the implemented tracking solution, unless they cannot be provided.

__________________________________________________________________________________________________________________

Tracked Currencies:
For each point of sale/campaign, it is important to confirm how many currency variations will be provided in the 'currency' parameter for tracked sales:

• Track sales in one currency only (i.e. all sales will track in GBP)

• Track sales in multiple currencies (i.e. sales could track in GBP, EUR and USD)

This should be discussed with the Partnerize Integration team during the Implementation phase.

__________________________________________________________________________________________________________________

Allowed Characters

• Values are allowed to have unicode characters and any symbol excluding/, #, +, \ and " (unless URL encoded)
• slash ( / ) , colon ( : ) , square brackets ( [ ] ) are reserved characters in Partnerize System so please exclude
• For all non alphanumeric characters please ensure these are URL encoded
  • E.g.)  A space will be encoded to %20, conversionref:test order will become   conversionref:test%20order
• Please exclude currency symbols (E.g. £ $ ) and comma separator from value parameter
  • E.g.) If the product amount is £1,980.99, you need set 1980.99

__________________________________________________________________________________________________________________

When to trigger Clickref Pixel / Exclusive codes  

The Clickref Pixel conversion should be triggered at point of checkout and typically when a "clickref" value is present. If a brand wishes to utilise Partnerize's exclusive code functionality https://help.phgsupport.com/hc/en-us/articles/4405844671377 it is essential that vouchers are passed into the 'voucher' parameter.

Exclusive Codes also introduces the concept of clickless tracking, allowing brands to work with non-traditional partnerships who don't work with tracking links. In order to utilize clickless tracking, a brand must trigger the tracking unconditionally for every sale regardless if a clickref value is present.

The "clickref" parameter can be left empty as "/clickref:/"

❗NOTE:  Even though  tracking is loaded for every sale Partnerize will only attribute sales that were referred by our partners.

__________________________________________________________________________________________________________________

Retrospective insert Parameter

Partnerize system will track sales in real time (whenever the Clickref Pixel is fired). However,  if conversions are systematically queued up to be inserted after the initial event, it's still possible to track against the original sale time. 

❗NOTE:

• If no "conversion_time" parameter is used PZ will use the current UTC time for insert date
• MUST be in UTC 
• This parameter must sit outside of the item block []

__________________________________________________________________________________________________________________

Populated Examples

Single Item Conversion Example:

Note certain parameters are left blank if no value 

https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:/voucher:/[category:SHOES/sku:4A7CAA/value:50.99/quantity:1]

Multiple Items Conversion Example:

Example Involving 2 Bags and 1 Shoes. Note the usage of two separate item blocks [ ] :

https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:787977/country:US/currency:USD/customertype:existing/voucher:Discount10/[category:BAG/sku:bao98/value:35.00/quantity:2]/[category:SHOES/sku:4A7CAA/value:50.99/quantity:1]

Retrospective Conversion insert Example:

Example time based insert with voucher populated

https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:existing/voucher:discount10/[category:SHOES/sku:4A7CAA/value:45.20/quantity:1]/conversion_time:2021-10-01+18:33:03

❗NOTE:

• The overall value of the conversion is calculated from the value of each item. 
• campaign:XXXXXX is a test campaign reference. Please ensure XXXXXX is replaced by your unique ID. The Partnerize deployment team will supply this during the integration phase 
• clickref must contain the most recent ID that drove the purchase in order to award the sale to originating publisher

__________________________________________________________________________________________________________________

Metadata Tracking

Partnerize offers a flexible and robust pixel, allowing brands to record additional sale information outside of the standard predefined tracking parameters. Within the Partnerize conversion tag a brand can include as much metadata as possible. 

This flexibility provides brands a greater insight and granular level of reporting for sale optimisation. 

The meta parameter name can be defined by the brand but must follow the syntax of parameter_name:value delimited by the ‘/’ 

Metadata Example (with delivery_cost)

https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:new/voucher:/[category:SHOES/sku:4A7CAA/value:45.20/quantity:1/delivery_cost:free]

Vertical Specific Tracking Parameters

For examples of vertical specific tracking parameters please see https://help.phgsupport.com/hc/en-us/articles/4410042606225-Vertical-Specific-Tracking-Parameters 

❗NOTE:

• Any meta parameters must be contained within the item blocks[ ]
• Please avoid using the parameter name of ‘destination’

__________________________________________________________________________________________________________________

Testing

Once the tags are deployed, they should be tested by submitting a test transaction via the brand’s live website.  A non session test should be performed, which simulates a returning customer who originally followed a partner link but purchased at a later date. Providing the sale is made within the cookie period of the brand, the transaction should track successfully.  Full testing instructions can be found here:

https://help.phgsupport.com/hc/en-us/articles/360019824018-Testing-Tracking-Solutions-FAQs

You should also test the implementation of the 1st party cookie to ensure that the clickref is being stored correctly:

• Click a test Partnerize link
• Check that the clickref is being stored in a 1st party cookie 
• Click the same test Partnerize link again and ensure that the previously set clickref is overwritten to the most recent clickref generated

__________________________________________________________________________________________________________________

Next Steps

• Request a campaign_id & that the clickref is enabled on the campaign.  You can do this by emailing the Partnerize Integration team at integrations.support@partnerize.com.
• Implement the relevant tracking, as described in the above guidance.
• Perform testing using the above instructions - Transactions will need to be submitted via the brand’s live website, so that the implementation can be fully tested.  

__________________________________________________________________________________________________________________

FAQ's

Please refer to our Clickref Pixel FAQ guide here: Clickref pixel FAQ's