> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dema.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Awin

> Integrating Awin with our platform imports your affiliate marketing cost data, giving you accurate spend and conversion insights across your publisher network.

export const AdConnectorSteps = ({platform, brand, loginTarget, authButton = "Authorize", authTitle = "Authorize access", authText, accountTitle = "Select ad accounts", accountText}) => <Steps>
    <Step title="Navigate to integrations">
      Go to <strong>Settings</strong> on our platform, then click on <strong>Integrations</strong>.
    </Step>
    <Step title={`Add ${platform} connection`}>
      Click on <strong>Add data connection</strong> and choose {platform}.
    </Step>
    <Step title={authTitle}>
      {authText ?? <>
          Log in to {loginTarget} and click <strong>{authButton}</strong> to grant the necessary permissions. Once authorized, we'll receive your OAuth token, allowing us to begin fetching data from your {platform} account.
        </>}
    </Step>
    <Step title={accountTitle}>
      {accountText ?? <>After authorization, select the {brand ?? platform} ad account IDs you want to import data from.</>}
      <Tip>
        <strong>Connect all accounts — including inactive ones</strong> — We automatically fetch your history (by default back to <strong>January 1, 2023</strong>). For accurate forecasting, modeling, and cohort analytics, we rely on at least two years of data, so connect any old or inactive accounts too — the more history, the better our models perform.
      </Tip>
    </Step>
  </Steps>;

### Supported data types

<CardGroup cols={1}>
  <Card title="Marketing cost" icon="dollar-sign">
    Affiliate commission spend and conversions
  </Card>
</CardGroup>

## Prerequisites

* Access to your Awin account
* An Awin API access token
* The Awin advertiser ID(s) you want to import data from

## Step-by-step integration guide

<AdConnectorSteps platform="Awin" authTitle="Provide your API token" authText={<>Unlike the OAuth-based ad connectors, Awin connects with an API token. Generate an API access token in your Awin account and enter it in the connection form.</>} accountTitle="Specify advertiser accounts" accountText={<>Enter the Awin advertiser ID(s) you want to import data from.</>} />

## How we calculate spend

Awin splits every transaction's commission into four states as it moves through the validation process. We report a **projected spend** view by summing the payable states, so recent days are populated immediately instead of waiting for advertisers to validate each transaction.

| Commission state | Included in spend | Meaning                        |
| ---------------- | ----------------- | ------------------------------ |
| Pending          | Yes               | Awaiting advertiser validation |
| Confirmed        | Yes               | Validated, payable commission  |
| Bonus            | Yes               | Additional payable commission  |
| Declined         | No                | Rejected; will not be paid     |

Declined commission is deliberately excluded because it will never be paid. As transactions move from pending to confirmed or declined, historical figures may adjust slightly to reflect the final validated amounts.

<Note>
  If you prefer to report only strictly validated (confirmed) spend instead of projected spend, let your Customer Success Manager know — this can be configured per merchant.
</Note>

## Processing

* **Date attribution:** Costs are dated by the **transaction (sale) date**, so they align with your orders and attribution rather than the later approval date.
* **Timezone handling:** Awin supports a limited set of timezones. Your merchant timezone is mapped to the nearest supported one, falling back to UTC when no match is available.

## Data refresh

<CardGroup cols={2}>
  <Card title="Initial import" icon="download">
    On the first fetch, we import historical data going back to **2023-01-01**. If you have costs before that date, let us know — we recommend at least **two years** of data.
  </Card>

  <Card title="Ongoing updates" icon="rotate">
    Subsequent updates re-fetch the **last 90 days**. Awin's validation window is typically 30 days but can extend to 60–90 days, so the wide lookback keeps projected spend accurate as transactions are validated.
  </Card>
</CardGroup>

## Finalizing integration

Once your token and advertiser IDs are set up, our system automatically begins fetching your Awin cost data. You can then view and analyze this data on our platform to understand your affiliate marketing performance.

## Troubleshooting and support

If you encounter any issues during the integration process or have questions regarding your data, please contact our support team for assistance.

## Additional resources

For more information on managing your Awin account and understanding transaction validation, visit the [Awin Help Center](https://help.awin.com) and the [Validating transactions](https://help.awin.com/docs/validating-transactions) guide.