---
title: "Custom parameters"
slug: "custom-parameters"
updated: 2026-09-10T12:57:34Z
published: 2026-09-10T12:57:34Z
canonical: "help.awin.com/custom-parameters"
---

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

# Custom parameters

Custom parameters allow you to add depth to your reporting and, in some cases, control the associated [commission groups](/developers/docs/commission-groups) via [commission flexibility](/advertisers/docs/commission-flexibility).

> [!NOTE]
> Plan availability
> 
> Only advertisers on an Advanced platform offer can make use of custom parameters for commission conditions.

## Custom parameter implementation

Awin supports up to 255 custom parameters reported on each Transaction. The implementation of a single versus multiple custom parameters differ slightly.

These values *must* be URL-encoded.

Please review the templates and examples of implementation:

### Single custom parameter

#### Conversion Tag

```javascript
AWIN.Tracking.Sale.custom = ["{{customParameter}}"];
```

#### Fall-back Conversion Pixel and S2S direct integration

```http
&p1={{customParameter}}
```

`customParameter` should be replaced by the desired, additional, information that you wish to include on your transaction calls.

Scheme/format: via GET parameter as p1= to p[n]= (example: …&p1=%C3%96sterreich… - for original example value: Österreich)

#### Implementation example

```http
<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=7.50&ch=aw&p1=Next%20Day%20Delivery&parts=DEFAULT:7.50&ref=AA000005&testmode=0" style="display:none;" width="0">
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = AWIN || {};
AWIN.Tracking = AWIN.Tracking || {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "7.50";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.custom = ["Next Day Delivery"];
AWIN.Tracking.Sale.orderRef = "AA000005";
AWIN.Tracking.Sale.parts = "DEFAULT:7.50";
AWIN.Tracking.Sale.test = "0";
//]]>
</script>
<script defer="defer" src="https://www.dwin1.com/1001.js" type="text/javascript"></script>
```

(replace the example Advertiser ID (here: 1001) in the first and last command line with yours)

### Multiple custom parameters

#### Conversion Tag

```javascript
AWIN.Tracking.Sale.custom = ["{{customParameter1}}", "{{customParameter2}}"...];
```

#### Fall-back Conversion Pixel and S2S direct integration

```http
&p1={{customParameter1}}&p2={{customParameter2}}...
```

`customParameter` should be replaced by the desired, additional, information that you wish to include on your transaction calls.

#### Implementation example

```http
<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=7.50&ch=aw&p1=Special%20Delivery&p2=Royal%20Mail&p3=5.99parts=DEFAULT:7.50&ref=AA000005&testmode=0" style="display:none;" width="0">
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = AWIN || {};
AWIN.Tracking = AWIN.Tracking || {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "7.50";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.custom = ["Special Delivery", "Royal Mail", "5.99"];
AWIN.Tracking.Sale.orderRef = "AA000005";
AWIN.Tracking.Sale.parts = "DEFAULT:7.50";
AWIN.Tracking.Sale.test = "0";
//]]>
</script>
<script defer="defer" src="https://www.dwin1.com/1001.js" type="text/javascript"></script>
```

(replace the example advertiser id (here: 1001) in the first and last command line with yours)

### Implementation example inclusive url-encoding

**GTM**

[Example script for GTM custom variable](/developers/docs/gtm-practical-tips#array-for-custom-parameters)

A completed sale, order, or lead.

The ID of the Affiliate Program on Awin.