Documentation: Tracking - AffiliationSoftware

Tracking

Tracking

 

The tracking code allows your affiliate network to recognize if an action has been referred by an affiliate and to assign him the respective commission. To automatically track the conversions generated by your affiliates, you must enter the tracking code in the "thank you page" of your website.

How to track affiliates' commissions

14.1 How tracking works

The tracking code of AffiliationSoftware is similar to Google Adwords conversion tracking and Facebook pixel. It is used to automatically recognize if the action (such as a sale or a registration) comes from an affiliate and assign him the respective commission.

The tracking code must be entered in the "thank you page" of the site, which is the page that the users see immediately after completing the action.

The tracking code, also called "Tracking Pixel", consists of an HTML code that is invisible to the users. The amount of commissions is calculated based on the amount of the sale and the commission segment assigned to the referring affiliate.

You can generate your tracking codes (pixels or postbacks) from the page:

Admin panel > Settings > Tracking


Track conversions on a website or an e-commerce
If you need to track conversions on a website or an ecommerce you can check if it is compatible with AffiliationSoftware in the following chapter. If it is compatible, you can contact us and request the instructions to place your tracking code. If it is not compatible, read the "General tracking solution".

Track conversions on an affiliate network or platform.
If you rely on another affiliate network or platform, you can insert the pixel or the postback directly on it. If the platform or network is compatible with AffiliationSoftware you can contact us and request instructions on how to place your tracking code. If it is not compatible, you can follow the documentation provided by the platform.

Track conversion manually
If it is not possible to integrate the tracking code, the only alternative is to add the transactions manually based on the results in the advertisers reports. To help you with that, you can use the IP address of the click, or add the affiliateID or subID in the banners/links parameters, which will be shown in the advertisers reports.


14.2 Compatible websites

This list includes E-commerce, CMS, platforms and affiliate networks that are compatible with the automatic tracking system of AffiliationSoftware (in alphabetical order).

2CheckOut (2CO)
3DCart
Ad4game
Addiliate
Adpump
Adsbridge
AffiliationSoftware
Affise
AMember
Aruba
AWeber
Awin
BigCommerce
Bookeo
Cake
Chargebee
Clickpoint
Commission Junction
Contact Form 7 (wordpress)

Cpalead
Createjoy
Easy digital download (wordpress)
ECWID e ECWID su WIX
FrameCommerce
GetResponse
Google Tag Manager
Hasoffers
HikaShop (Joomla)
Incomedia Website x5
Kajabi
Landingi
LeadPages
Magento
Memberpress (wordpress)
NetAffiliation
NewCart
OpenCart
OSCommerce

PayPal
PayPal DT (Data Transfer)
PayPal IPN (Instant Payment Notification)
PostAffiliate
PrestaShop
Rezgo
Shopify
Shopware
Stripe
Tradedoubler
Tradetracker
UberCart (Drupal)
VirtueMart (Joomla)
Voluum
WebNode
WooCommerce (wordpress)
Wordpress
ZenCart

Show all compatible websites

If you use a website that is compatible with AffiliationSoftware, just contact us. We will send you an email with specific instructions, which explain how to integrate the tracking code in that specific system.

Request instructions

AffiliationSoftware is compatible with 99% of websites. If your site is not listed here, or if you are a web developer, we suggest you to follow the general solution to integrate your tracking code.

General solution


14.3 General solution

The general solution explains how to integrate the tracking pixel of AffiliationSoftware into the "thank you page" of a website.

Follow these instructions only if you don't have a website compatibile with AffiliationSoftware or if you are a web developer. HTML skills are required.


STEP 1

Generate the tracking code of the campaign. You can generate your tracking code by going to the page:

Admin panel > Settings > Tracking


STEP 2

Copy and paste the tracking code into the "thank you page" of the website.

The "thank you page" is the page viewed by users immediately after completing a purchase or a registration.

The tracking code is invisible to users and can be placed anywhere in the page, between the <body> and the </body> tags.


STEP 3

If you have set percentage commissions, enter the total amount of the sale in the "cost" parameter. The percentage commissions will be calculated based on this amount.

To recognize conversions, you can enter an identification string in the "orderid" parameter, for example the number of the order or the email of the new registered user.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=order1234' width='1' height='1' border='0' />

You can also fill these parameters dynamically, for example with PHP:

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=<?php echo( $saleAmount ); ?>&orderid=<?php echo( $saleID ); ?>' width='1' height='1' border='0' />


STEP 4

You have made it! When an affiliate generates a conversion, AffiliationSoftware will recognize it and automatically assigns him the respective commission.

To verify if the tracking code is working you can do a test, as explained in the chapter "Troubleshooting".


EXAMPLE

Example of a "thank you page" with the tracking code of AffiliationSoftware in it.

<html>
<head>
<title>Thank you for your order</title>
</head>
<body>
<h1>Thank you for your order</h1>
<!-- AffiliationSoftware.com - Start tracking code -->
<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=order1234' width='1' height='1' border='0' />
<!-- AffiliationSoftware.com - End tracking code -->
</body>
</html>


14.4 Postback tracking

Postback URL (also called "Callback URL" or "Server2server") is a type of tracking that is used to connect your affiliate network with other compatible networks or platforms. Unlike the Pixel, the Postback works on the server side and cannot read the data saved in the user’s PC. To track with the Postback you must pass a parameter in the banners/links and then retrieve it in the Postback. This parameter, called "TOKEN", contains a unique ID that allows AffiliationSoftware to recognize the affiliate and register the commission.


How to create a Postback tracking

Postback allows you to automatically track the conversions of a campaign provided by an affiliate network or an affiliate platform.

1. In the “Destination URL” field of all the banners/links of the campaign add:

&SUBID=[token]

2. In the postback, retrieve the value of the TOKEN by adding:

https://example.affiliationsoftware.app/script/postback.php?cost=79.95&orderid=ordine1234&c=SUBID

The "SUBID" parameter must be replaced with the one of the network/platform that provides the campaign. Any parameter that accepts an alphanumeric value can be used. Example: subid1 or aff_sub1.


How to create a global Postback

The global postback allows you to automatically track the conversions of all the campaigns provided by a network or an affiliate platform.

AffiliationSoftware's postback works as a global postback without any modification. Follow the instructions above to create a global Postback tracking.


14.5 Tracking variables

In the tracking code there are some parameters that you can change according to your needs. The purpose of each parameter is explained below.

Campaign (cid)
Enter the campaign ID to track the commissions of selected campaign. You can find the campaign ID in the tracking and campaigns pages.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Order ID (orderid)
Enter the ID or the number of the order. This data will be visible in the "details" column of the transactions page, both on the admin side and on affiliates. You can use it as a reference when validating commissions.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Sale amount (cost)
Enter the total amount of the sale. This amount is used to calculate the percentage commissions. This parameter is mandatory only if you have set percentage commissions, otherwise you can leave 1. Use the point as a decimal separator.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234' width='1' height='1' border='0' />

Deductions (d)
It is possible to deduct any fixed costs from the sale amount (cost). If you set a deduction, the percentage will be calculated as follows: (sale amount - deductions) * percentage.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&d=6.50' width='1' height='1' border='0' />

Segment (g)
If inserted, it allows you to force the tracking to use a specific commission segment, even if the affiliate is not assigned to it. It can be useful if the campaign has multiple commissions or multiple products to track.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&g=prodotto2' width='1' height='1' border='0' />

Type (type)
If inserted, it allows you to force the tracking to use a specific commission type. It can be useful if the campaign has multiple commissions types, for example sale and lead.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&type=s' width='1' height='1' border='0' />

Currency (ccurrency)
If entered, it allows you to convert the sale amount (cost) from one currency to another, for example from USD to EUR.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&ccurrency=USDEUR' width='1' height='1' border='0' />

Notes (notes)
If inserted, it allows you to store data of your choice. This data will only be visible in the admin panel and will be hidden in the other panels.

<img src='https://example.affiliationsoftware.app/script/track.php?cid=afsc&cost=79.95&orderid=ordine1234&notes=test' width='1' height='1' border='0' />

Token (c)
The postback is used to track conversions on other affiliate networks or platforms. To work, the postback requires a parameter called "Token". The Token must be added in the banners/links and then retrieved in the postback. 

https://example.affiliationsoftware.app/script/postback.php?cost=79.95&orderid=ordine1234&c=TOKEN


14.6 Troubleshooting

Before starting a campaign, you can do a test to make sure that everything is working properly. Follow these instructions to verify your campaign and your tracking code. If the transaction results registered after the test, it means that everything is working fine.


Check the campaign

Follow these steps to check if a campaign is configured correctly.

1. Verify that the 1° tier commission is set in the campaign.
2. Verify that at least one banner or link was added to promote the campaign.
3. Generate the tracking code, making sure you have selected the correct campaign.
4. Verify that you have entered the tracking code in the site or platform you want to track.


Check tracking (pixel)

Follow these steps to check if the tracking pixel is configured correctly.

1. Access the Affiliate Panel, if necessary, apply for the campaign and go to the "Banners and links" page.
2. Click on a banner/link and verify that the click is registered in the statistics page.
3. Generate the tracking pixel in URL format, copy and paste it into the address bar of your browser and verify that the transaction is registered.
4. Or, if the tracking pixel is already placed in the site, simulate a purchase (or registration) and verify that the transaction is registered.


Verify tracking (postback)

Follow these steps to check if the tracking postback is configured correctly.

1. Check that the TOKEN parameter is inserted in all the banners/links of the campaign.
2. Access the Affiliate Panel, if necessary apply for the campaign and go to the "Banners and links" page.
3. Copy the campaign link, add “&debug” at the end and paste it into your browser's address bar.
4. Check that the click is registered in the statistics and copy the displayed TOKEN.
5. Generate the postback, copy it and paste it in your browser’s address bar by adding the TOKEN you copied and verify that the transaction is registered.


Tracking errors and logs

If the transaction has not been registered after your test, proceed as follows.

1. Check in the logs if the tracking has been called (based on date and time). If the call does not appear here, make sure the tracking is placed on the site or platform you want to track.
2. Check in the debug if the tracking returned as an error (based on date and time). If it returns as an error, resolve it by changing your campaign settings.