Knowledge Base/Optimize Your Account/Tools

Reporting API (& SubID Tracking)

John Maguire
posted this on Jan 20 16:26

Reporting API with subID tracking now available... what can it do for me?

The Reporting API gives detailed information about the current value of commissions by utilising subID tracking. So, if you want to know about your commissions and be able to see which custom IDs are making you money, this is the API for you.

What information does it provide?

The commission data available is very detailed and includes:

Commission Value
Order Value
Merchant ID
Active/Cancelled
Custom ID*
Page*
User agent*
Lead/Sale (NEW!)
…and more!

* = not with Amazon or Ebay

What is SubID tracking?

SubID tracking is used to segment commission data you receive from us. This allows you to identify where commissions originated from, such as which specific page or section on your site a click generating a sale came from, or which particular user of your site made a particular purchase.

What is Xcust?

Xcust is simply the tag Skimlinks’ uses for the custom parameter field in a link.

The process for using this involves appending unique additional information in the custom parameter (Xcust) field to each click that you send through the Skimlinks servers. If you then use the reporting API to retrieve your commission data we will also report Xcust back to you.

So, what does this actually look like in real life?

There are two main ways to append Xcust on to your Skimlinks links.

1. If you are a Skimlinks JavaScript user:

  • First need to modify your Skimlink JS to include the variable async=”true”:

*<scripttype=text/javascript src="http://s.skimresources.com/js/11858X696722.skimlinks.js" async="true"></script>*

  • Then add a JavaScript variable to the page detailing the value that you want to be assigned to Xcust:

<script type=text/javascript>var skimlinks_tracking = "102116abc100004496";</script>

When a link to a retailer who works with Skimlinks is clicked, this value will get passed to our servers.

The Xcust parameter has a maximum size of 50 characters, and must only contain alphanumeric characters (a-z, 0-9). No symbols (/,?,£,!)

2. If you are Skimlinks Link API User:
  • Create your links using the normal Skimlinks format, including an extra parameter ‘Xcust’:

&xcust={custom_parameter}&xs={1}&url={product_link}&sref={referrer_url}

Again, The Xcust parameter has a maximum size of 50 characters, and must only contain alphanumeric characters (a-z, 0-9). No symbols (/,?,£,!).
 
Topic is closed for comments