This article describes how to set up the AWIN Conversions connector.

In this article:

API Information

This connector uses the following vendor API:

Connector Actions

Action Name AudienceStream EventStream
Send Conversion
Product Level Conversion

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

After adding the connector, configure the following settings:

  • Token
    Required. This token is linked to your personal user account. For more information on creating your token, see Authentication and Authorization in the AWIN documentation.
  • Merchant (Advertiser ID)
    Applicable Awin advertiser ID. Contact your Awin account manager for support.

Click Done when you are finished configuring the connector.

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Send Conversion

Parameters

Parameter Description
Merchant (Advertiser ID) (override) The advertiser program ID.
AWC parameter (Required) This value is appended to the landing page URL by Awin to identify the source of the click.
Total Amount (Required) The order subtotal amount after any relevant discounts are applied, but prior to any additional fees such as taxes, delivery charges, or relevant service charges are added. The value must be a float, no thousand separator is allowed, and the decimal place must be a standard dot character.
Commission Group Code The code for the commission group you want to attribute the transaction to. Accepted characters are upper-case alphanumerics, underscores, and hyphens.
Channel

The channel name of the last click referrer. Always use aw for Awin, which is the default value. This value must be 20 alphanumeric characters or less.

We strongly suggest that you include this parameter so the Awin system knows how to process each conversion based on the source of the traffic. This allows Awin to handle the request in one of the following ways:

  • Do not process.
  • Process if any Awin cookie is present.
  • Only process if an Awin click cookie is present.
  • Only process if an Awin post-view cookie is present.
Voucher Code A URL-encoded voucher code for the transaction.
Currency Code The ISO currency code of the currency that was used in the transaction.
Order Reference (Required) The unique booking or order ID.
Custom Parameters The input data for single or multiple custom tracking parameters.
Test Mode Incoming tracking requests will not be processed for the purposes of testing.

Action — Product Level Conversion

Parameters

Parameter Description
Merchant (Advertiser ID) (override) The advertiser program ID.
AWC parameter (Required) This value is appended to the landing page URL by Awin to identify the source of the click.
Total Amount (Required) The order subtotal amount after any relevant discounts are applied, but prior to any additional fees such as taxes, delivery charges, or relevant service charges are added. The value must be a float, no thousand separator is allowed, and the decimal place must be a standard dot character.
Commission Group Code The code for the commission group you want to attribute the transaction to. Accepted characters are upper-case alphanumerics, underscores, and hyphens.
Channel

The channel name of the last click referrer. Always use aw for Awin, which is the default value. This value must be 20 alphanumeric characters or less.

We strongly suggest that you include this parameter so the Awin system knows how to process each conversion based on the source of the traffic. This allows Awin to handle the request in one of the following ways:

  • Do not process.
  • Process if any Awin cookie is present.
  • Only process if an Awin click cookie is present.
  • Only process if an Awin post-view cookie is present.
Voucher Code A URL-encoded voucher code for the transaction.
Currency Code The ISO currency code of the currency that was used in the transaction.
Order Reference (Required) The unique booking or order ID.
Custom Parameters The input data for single or multiple custom tracking parameters.
Test Mode Incoming tracking requests will not be processed for the purposes of testing.
Product Name (Required) An array of product names in the transaction.
Product ID (Required) An array of unique product IDs in the transaction.
Product Quantity (Required) An array of the quantity of each of the products in the transaction.
Product SKU (Required) An array of the SKU of each of the products in the transaction.
Product Item Price (Required) An array of the prices for a single quantity of each of the products in the transaction. This single unit price must reflect the price after any relevant discount is applied, but prior to any taxes or additional charges are applied. The value must be a float, no thousand separator is allowed, and the decimal place must to be a standard dot character.
Product Category (Required) An array of each product's category in the transaction.
Commission Group Code The code for the commission group you want to attribute the transaction to. Accepted characters are upper-case alphanumerics, underscores, and hyphens.
Public