Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 7.13 KB

File metadata and controls

62 lines (45 loc) · 7.13 KB

Awin

Awin provides a global affiliation network connecting businesses with customers.
Using this destination you can implement server-side tracking using the same client-side parameters.

{% hint style="info" %} Awin no longer support the use of pixel only implementations due to various browser constraints and limitations. {% endhint %}

Key features

The Awin destination provides the following key features:

  • Events structure: our Events reference covers Awin lead and sale tracking, meaning that your data is properly bridged to the expected fields in an optimized way.
  • Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.
  • Smart mapping: data mapping can be readjusted using your datalayer defined fields.
  • Support for multi-item data: information included in the item array is bridged to Awin.
  • Commission group: remunerate different products based on your commission groups.

Destination setup

{% hint style="warning" %} The awc parameter is appended to the landing page URL by Awin to identify the source of the click. This value is mandatory and is retrieved by getting the value of either the Click Id (See Configuration) or the awc cookie, in this priority order. {% endhint %}

Configuration

SettingsDescription
Advertiser IdRequired
Your advertiser programme ID. Consult your Awin account contact or assigned integrator for more information on this value. This setting supports dynamic values [1].
Conversion TypeRequired
The conversion type that is bound with your activity. This can be either Sale or Lead. If conversion type is Sale, only purchase events are sent to the partner, if it's Lead, only generate_lead events are forwarded to Awin.
Click IdAwin click identifier (awc). If it's not set the cookie "awc" is used. More details are available following this LINK. This setting supports dynamic values [1].
Test ModeThis field is available when flagging the Advanced Settings . It's either 0 (default value) for live production or 1 for UAT/test environment: when setting to the latter, the incoming tracking requests will not be processed by Awin. This setting supports dynamic values [1].
Custom Event PropertiesMap your custom event properties by setting their field names in Awin property name and adding the field name holding the value in Your event property. E.g. if you input size in the Awin property name and items.0.product.size in Your event property, you will have a custom event property in Awin called size with a value based on the content of the field items.0.product.size.

{% hint style="info" %} [1] This feature allows you to set an event property holding a dynamic value by adding two open braces ({{) in front of your property name and two close braces (}}) at the end (E.g. {{myEventPropertyPathAndName}}). {% endhint %}

Quick reference

Commanders Act Events Awin Tracking
generate_lead lead
purchase sale

Field mappings

{% hint style="info" %} Most properties can be remapped using our "Smart Mapping" feature.
The following fields are mandatory to properly set commission groups:
- items.X.affiliation
- items.X.product.price
- items.X.quantity

Accepted characters for the commission group codes are alphanumerics and letter in upper case, underscore (_) , point (.) and minus (-). {% endhint %}

Commanders Act PropertiesAwin Properties
Advertiser Idmerchant [*]
Click Idcks [1][*]
revenueamount
channelch [2]
items.X.affiliation:items.X.product.price*items.X.quantityparts [3]
couponvc
currencycr
idref
Test Modetestmode
AW:P|Advertiser Id|id|items.X.product.id|items.X.product.name|items.X.product.price|items.X.quantity|items.X.product.price|items.X.id|items.X.affiliation|items.X.product.category_1.bd[X] [4]

{% hint style="info" %} [*] Mandatory property.
[1] See Destination setup for more details.
[2] Default value "aw".
[3] Computed amounts are rounded with two decimals (E.g. "DOWNLOAD:551.18|FIX-NC:15302.67"). For sale conversion type, when the "Smart Mapping" field Item Affiliation is not filled with a proper value, the Awin "Commission Group" is set with the value DEFAULT .
When you select lead as conversion type, it's set with the static string LEAD:1 .
[4] It takes into account each product. {% endhint %}