- 04 Feb 2025
- DarkLight
Commission Groups
- Updated on 04 Feb 2025
- DarkLight
Commission Groups are utilized to attribute the whole, or parts, of a given transaction to a specific commission rate. These rates may be percentage or fixed amounts. These groups are created and maintained within Commission Management in the Awin UI.
Platform Notice
Advertisers utilizing the “Access” platform offer can only configure two additional commission groups.
For reporting on Customer Acquisition information, please see the related article.
Single Commission Group
Single commission groups are used to attribute a set commission to an entire affiliate transaction. The commission group code used will refer to the commission group set within Commission Management in the Awin UI. This commission group code is then to be used in the tracking under the parts
parameter of the conversion tag, fall-back image pixel and the server-to-server tracking. The below examples show single Commission Groups as they are called in Tracking.
Conversion Tag
AWIN.Tracking.Sale.parts = "{{commissionGroupCode}}:{{totalAmount}}";
Fall-back Conversion Pixel & Server-to-Server
&parts={{commissionGroupCode}}:{{totalAmount}}
If no commission group code is defined, this should be set to “DEFAULT”, and note that this field is case and spelling sensitive. In the instance that there is a mismatch between the reported code and those configured in the Awin UI, the DEFAULT commission rate will be attributed.
When tracking leads instead of sales, the
{{totalAmount}}
in the examples above should be set to a fixed 1 per tracked lead.
Multiple Commission Groups
It is possible to split the transaction into parts which each are assigned separate Commission Groups. These other groups will first need to be configured within Commission Management in the Awin UI.
To make use of these groups, each Commission Group and its relevant amount must be called and separated by a pipe (“|”) character.
The sum of all amounts for each of the commission groups under the
parts
parameter must be equivalent to the subtotal reported in theamount
parameter. In the example below, the associated amounts 11.10 (CD) and 14.99 (DVD) equal the order subtotal 26.09 (amount).
Conversion Tag Template & Example
AWIN.Tracking.Sale.parts = "{{commissionGroupCode1}}:{{commissionGroupAmount1}}|{{commissionGroupCode2}}:{{commissionGroupAmount2}}...";
//<![CDATA[
/*** Do not change ***/
var AWIN = AWIN || {};
AWIN.Tracking = AWIN.Tracking || {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "26.09";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.currency = "EUR";
AWIN.Tracking.Sale.orderRef = "AA000006";
AWIN.Tracking.Sale.parts = "CD:11.10|DVD:14.99";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.voucher = "10OFF";
//]]>
Fall-back Conversion Pixel & Server-to-Server Template
&parts={{commissionGroupCode1}}:{{commissionGroupAmount1}}|{{commissionGroupCode2}}:{{commissionGroupAmount2}}...
New & Returning Customers
Our tracking supports the identification and commissioning of new and returning customers as unique events.
This is possible by returning the related information on a transaction and creating groups for NEW and EXISTING customers in the Awin UI’s Commission Manager.
After you’ve created the related groups, you’ll then need to dynamically add the corresponding parameter in place of a commission group in your tracking.
customerType
should be replaced by either NEW
or EXISTING
depending on the type of customer.
Conversion Tag Template & Example
AWIN.Tracking.Sale.parts = "{{customerType}}:{{totalAmount}}";
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = AWIN || {};
AWIN.Tracking = AWIN.Tracking || {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "12.49";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.currency = "EUR";
AWIN.Tracking.Sale.orderRef = "AA000003";
AWIN.Tracking.Sale.parts = "NEW:12.49";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.voucher = "10OFF";
//]]>
</script>
Our tracking also supports additional reporting on whether the customer making a purchase is a new customers acquisition or a returning customer to your store under the customer acquisition parameter. Please see the customer acquisition page for more information.