Awin

Send your event data from RudderStack to Awin.

  •   3 minute read  

Awin is an affiliate marketing program that connects advertisers and affiliates of all sizes. It provides a network of affiliate partners, click tracing and tracking, advertiser directory, reports and analytics, and more.

Find the open source code for this destination in the GitHub repository.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Warehouse, Shopify
  • Refer to it as AWIN in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supported

Get started

Once you have confirmed that the source platform supports sending events to Awin, follow these steps:

  1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Awin.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully set up Awin as a destination, you will need to configure the following settings:

  • Advertiser ID: Enter your Awin advertiser ID.
  • Events to Track: Enter the event names for which you want to track the conversions.
warning
You must enter all event names for which you want to make a track call.
  • Map Rudder payload property to custom Awin field: Enter the RudderStack property and the corresponding Awin custom field you want to map together. These custom properties get associated to a specific transaction and sent to Awin for track calls. The Awin field names must follow the p<int> format (like p1, p2, etc.). RudderStack picks the field values from message.properties and sends them as query parameters.
warning
Duplicate mapping can cause errors.

Track

You can use the track call to send the conversion data directly to Awin’s servers.

A sample track call is shown below:

rudderanalytics.track("Product Purchased New", {
  revenue: 4.99,
  currency: "USD",
  commissionGroup: "CD",
  name: "Shirt",
  voucherCode: "FIRSTSALE",
  order_id: "ORD123",
});

Supported mappings

The following table lists the mappings between the RudderStack and Awin properties:

Product-level tracking

RudderStack propertyAwin property
properties.order_id
properties.orderId
properties.orderReference
properties.order_reference
Required		orderReference
product[i].product_id
product[i].productId
Required		productId
properties.products[i].name
Required		productName
properties.products[i].price
Required		productItemPrice
properties.products[i].quantity
Required		productQuantity
properties.commissionGroup
properties.commission_group
Required. Default value is DEFAULT		commissionGroupCode
properties.products[i].sku
Optional. If not present, RudderStack sends an empty value instead.		productSku
properties.products[i].category
Optional. If not present, RudderStack sends an empty value instead.		productCategory

Other mappings

RudderStack propertyAwin property
properties.revenue
properties.totalAmount
properties.amount
properties.total_amount		totalAmount
properties.voucherCode
properties.voucher_code		voucher_code
properties.currency
properties.currencyCode
properties.currency_code		currencyCode
properties.cks
properties.awc		awc
properties.testMode
properties.test_mode
properties.isTest
properties.is_test
Default value is 0.		isTest

FAQ

Where can I find the Awin advertiser ID?

To obtain your Awin advertiser ID, log in to your Awin dashboard to see the advertiser ID in the top right corner as well as in the URL:

Awin advertiser ID

Questions? Contact us by email or on Slack