Skip to main content

Overview

Destination Type:
Client-side
and
Server-side

Installation instructions

  1. Obtain your AWIN advertiser ID. You can find this ID in the top right corner of your AWIN dashboard
    .
  2. In the Converge sidebar, click on
    Event streams
    and then click Create new Destination.
  3. Select the AWIN destination and click Next.
  4. Give your destination a name (e.g. AWIN Destination) and click Next.
  5. Fill in the Advertiser ID you copied from AWIN and click Next.
  6. Select Use default mapping and click Next.
You can find the Default mapping for the AWIN destination here. For more information on setting up Custom mappings, look here.
  1. Select the sources you want to forward events from, then click Next.
  2. Review any issues and click Submit.
Once you have installed your Converge Destination, you should pause or remove all existing AWIN tracking. Leaving these on will lead to duplicate tracking. Check the Turn off your old tracking setup guide for additional instructions.

Exclude VAT and shipping from commission payments

Some companies send the order value with tax and shipping costs included back to AWIN in their conversion tracking setup. However, AWIN calculates commission (usually somewhere between 10% - 15%) on the order value that is passed back. When you send the order value with tax and shipping included back to AWIN, you will effectively pay a commission on those. Therefore, many companies prefer to pay AWIN commission based on their net revenue.

An example

As an example, take a product that has a price of 100 USD. Now, the total price that the customer will pay will look something like price + tax + shipping, for example: $100 + $15 + $5 = $120. Now, imagine that you are paying AWIN 15% commission.
  • In the case that you send back the gross order value with VAT and shipping, then you will pay AWIN 15% * $120 or $18.
  • However, in the case that you would send back the net order value, then you will pay AWIN 15% * 100 or $15

Setting up Net Order Value in your AWIN configuration

In the destination configuration, under the advanced tab, you can configure whether you want to send gross or net order values.

Converge functionality

This integration supports the following Converge destination functionality.
Converge FeatureSupported
Custom Events
Filters
Server-side Conversions

FAQ

Verify that you’ve configured the events you want to forward as Conversion events in the destination configuration.If your events are showing up as skipped in the destination logs, double-check that your event properties conform with the Placed Order event spec. If Converge cannot parse the event into an AWIN order, the event cannot be forwarded and shows as skipped.
AWIN only supports tracking orders. You can configure which events are forwarded as orders, but cannot register events besides orders.The following customizations are possible
  • Customer type: Converge by default includes whether the order comes from a new or existing customer.
  • Custom parameters: you can include event properties as custom parameters on your orders.
Under the Advanced tab in the AWIN destination, you can add custom parameters to your events. Only string or numeric parameters are supported. These are sent as a list of values.For example, when specifying order_type and language custom parameters, the following lists could be sent to AWIN
[Placed Order, sample, en]
[Placed Order, gold, de]
The Converge event name is automatically included as a custom parameter.
Yes, this is enabled by default.
By default, this is set to aw, as recommended by AWIN. You can customize this by setting an $awin_channel profile property on your events.
cvg({
    method: 'track',
    eventName: 'Registered Custom Channel',
    profileProperties: {
        $awin_channel: 'custom_channel'
    }
})

Event mapping

Converge automatically maps the following events from the Converge event spec to AWIN events:
Converge Event NameAWIN Event Name
Placed OrderOrder
I