AWIN

Send conversion and sale data to AWIN server-to-server for affiliate tracking, commission attribution, and publisher performance reporting.

⚠️

This blueprint is currently alpha — schema and behaviour may change before GA.

Prerequisites

Complete these steps in the AWIN dashboard before configuring Signal.

Create an AWIN advertiser account

Sign up as an advertiser at awin.com or log in to your existing AWIN account. You must have an active advertiser account to use the server-to-server integration.

Find your Advertiser ID

Navigate to Account > Overview in the AWIN dashboard. Your Advertiser ID is displayed prominently on the account overview page and also appears in the URL.

Generate an API key

Go to Account > API Credentials (or contact your AWIN account manager to enable API access). Generate or copy your API Key. This key authenticates server-to-server conversion tracking calls.

Configure your conversion feed

Navigate to Tracking > Conversion Tag and set up your conversion parameters. Note the Feed ID associated with your product or conversion feed. This links tracked conversions to the correct publisher commissions.

Configure commission groups

Ensure your commission groups are set up in Finance > Commission Groups so that server-tracked conversions are correctly attributed and paid out to publishers.

Configuration

Field	Type	Required	Description
`advertiser_id`	string	Yes	Your AWIN advertiser ID from Account Overview.
`api_key`	secret	Yes	Your AWIN API key for authenticating server-to-server calls.
`feed_id`	string	Yes	The feed ID associated with your product or conversion feed.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find AWIN or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/awin/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AWIN",
    "variant": "default",
    "config": {
      "advertiser_id": "12345",
      "api_key": "your_api_key",
      "feed_id": "67890"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

The Retail variant maps the following Datafly events to AWIN conversion events:

Datafly Event	AWIN Event	Notes
`Product Added`	`add_to_cart`	Cart-stage event for awareness funnels (no commission)
`Order Completed`	`purchase`	Requires `orderRef`, `amount`, `currency`, `commissionGroup`
Custom events	Passed through	Add the AWIN conversion type in the blueprint event map

Identity

The default blueprint forwards the following identifiers to AWIN:

Source	AWIN field
`user_id`	`customer_id`
`context.ip`	`ip_address`
`context.user_agent`	`user_agent`

AWIN’s click reference (awc) is the primary attribution token. Capture the awc query parameter on the landing page and pass it through Datafly.js so it reaches AWIN with each conversion.

Default consent category: advertising. AWIN conversion tracking is an advertising destination — gate behind advertising consent in your CMP.

AWIN requires the click reference (awc parameter) to attribute conversions to the correct publisher. Ensure your site captures and forwards the awc click cookie through Signal events.

Verify it’s working

Generate a test click through an AWIN tracking link to create a valid awc reference.
Complete a test conversion on your site that triggers a Datafly event.
In the Signal Management UI, open your AWIN integration and watch the Live Events stream.
In the AWIN dashboard, navigate to Reports > Transactions and look for your test conversion (it may take a few minutes to appear).
Confirm 200 responses in Signal’s Live Events log.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid API key	Verify `api_key` in AWIN API Credentials and update Signal.
`400 Bad Request`	Missing required conversion fields	Ensure `orderRef`, `amount`, and `commissionGroup` are mapped in the blueprint.
Conversions not appearing	Missing `awc` click reference	The AWIN click ID must be captured from the landing page URL and included in the event.
Commission not attributed	Wrong commission group	Verify commission group codes in AWIN match the values in your blueprint.
Duplicate conversions	Same `orderRef` sent twice	AWIN deduplicates by order reference; ensure each order has a unique ref.

Visit AWIN documentation for full API reference and credential setup instructions.

Blueprint

The AWIN blueprint version is 0.1.0 (alpha). It ships with a Retail variant covering add_to_cart and purchase conversion events.