Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Name (JS tag)

Name (img tag)

Explanation

Format

Example

discValue

dsv

This parameter transmits any discount values (net amounts) related to the conversion.

Numeric: #.#

12.34

discCode

dsc

This parameter transmits any discount tags related to the conversion.

Alphanumeric

XMAS2016-4578aved

invValue

inv

This parameter transmits the total order value of a conversion, i.e. including shipping costs and VAT.

Numeric: #.#

123.45

confStat

cfs

This parameter transmits the status of the conversion. If it is not used, conversions will be registered with an open status. Therefore, you should only use this parameter when you want to confirm or cancel conversions automatically.

0 = open
1 = approved
2 = rejected

Numeric

1

uniqid

uniqid

This parameter is needed when you want to automate your validation process. For more information, please read this article.

Universally unique identifier (UUID)

164a9ee7-4b7a-3a2a-802a-1a7a4be79e4a

Custom values

The parameters in this section can transmit custom values related to the conversion or the customer, such as points given for a loyalty program. The content can be alphanumeric.

Name (JS tag)

Name (img tag)

Explanation

Format

Example

isCustNew

csn

This parameter registers whether the customer was new to the advertiser. Possible values are true (new) or false (recurring).

Alphabetic

True

custId

csi

This parameter transmits any ID given to the customer who placed the conversion. Use this for implementing cross-device and cookieless tracking.

Alphanumeric, max length 255 chars

bon78945

session

session

This parameter transmits any ID given to the session of the customer who placed the conversion. Use this for implementing cross-device and cookieless tracking.

Alphanumeric, max length 255 chars

ses345

custGend

csg

This parameter transmits a value identifying the gender of the customer placing the conversion. Possible values are f (female) and m (male).

Alphabetic

f

custAge

csa

This parameter transmits the age of the customer placing the conversion.

Numeric

45

CustSurv

csr

This parameter transmits questions and answers to surveys held upon placing the order.

Alphanumeric: {"#":"#"}. Please note JSON format is higly recommended.

{"Your favorite movie":"Moonraker","Your favorite actor":"Sean Connery"}

payMethod

pmt

This parameter can transmit the payment method the customer chose when placing the order.*

Alphanumeric

paypal

addData

adt

This parameter can transmit costumer related data, such as the number of orders previously canceled or recommendations.

Alphanumeric: {"#":"#"}. Please note JSON format is highly recommended.

{"number_prev_cancellations":"12","recommended_by":"user_id: 15"}

userVal1

uv1

This parameter can transmit additional information. It can be a string, a JSON or another format.

Alphanumeric, max length 255 chars

12345

userVal2

uv2

This parameter can transmit additional information. It can be a string, a JSON or another format.

Alphanumeric, max length 255 chars

Berlin

userVal3

uv3

This parameter can transmit additional information. It can be a string, a JSON or another format.

Alphanumeric, max length 255 chars

Germany

userVal4

uv4

This parameter can transmit additional information. It can be a string, a JSON or another format.

Alphanumeric, max length 255 chars

Category: Newspaper Subscription

...

The parameters in this section can transmit custom values related to the conversion or the customer, such as points given for a loyalty program. The content can be alphanumeric.

Basket tracking

A requirement for basket tracking is the tracking category ‘basket.’ we recommend to set it up before implementing the conversion tag.

...

Name

Explanation

Format

Example

id

The optional ID of this position Can be submitted to address this position later. Generated automatically if empty.

1 or higher, max value 32767

1

uuid

The optional UUID of this position. Can be submitted to address this position later. Generated automatically if empty.

Valid UUID

0d5bb776-2d50-4d65-912c-d20e324f66b8

pid

The ID of the product to which the basket position relates.

Numeric

1234

prn

The name of the product to which the basket position relates.

Alphabetic

Green Hoover vacuum cleaner

sku

The stock keeping unit

Alphabetic

014-45253-4535

pri

The price of the product to which the basket position relates.

Numeric: #.#

145.55

brn

The brand name of the product to which the basket position relates.

Alphanumeric

Hoover

qty

The number of ordered products.

Numeric

3

dsv

The discount value of ordered products. Cannot be negative.

Numeric: #.#

10.23

shp

The shipping costs of ordered products. Cannot be negative.

Numeric: #.#

8.50

tax

The tax which needs to be paid for ordered products. Used to calculate the total invoice amount of this conversion. Cannot be negative.

Numeric: #.#

27.53

trc

The tracking category of the basket position, not to be confused with the tracking category of the conversion to which the basket position belongs. Any tracking category may be used except basket. If no specific tracking category is intended, please use default.

Never use the trc basket it will cause an error.

Alphanumeric

default

prc

The shop category of the product to which the basket position relates.

Alphanumeric

Household appliance

Attribution parameters

The parameters in this section can transmit attribution relevant values such as click ids.

Name (JS tag)

Name (img tag)

Explanation

Format

Example

admtag

amc

This parameter transmits the complete ad media tag of the click URL via which the conversion was generated.

foo.bar.#.#.#

1234... partner

5678... adspace

9012.... creative

foo.bar.1234.5678.9012

subtag

smc

This parameter replaces any sub IDs added to the click URL via which the conversion was generated.

Alphanumeric, max length 255 chars

abc1234

clickIds

cli

This parameter can transmit click IDs and enable attribution even when no cookie was dropped.

Alphanumeric, comma-separated or JSON array

a123456,b78910 or ["a123456","b78910"]

(In JS tag, use clickIds to transmit this value)

awc

Awin click checksum.

String

1001_1502695821_b670d81e22c9e8a87g423efcf034fbaa

(In JS tag, use clickIds to transmit this value)

gclid

Google Ads click ID.

String

CjwKCAjwvZv0BRA8EiwAD9S8msHPVhhwIFhI3jzdnsgc_JZxyhR-RaZGs4j_86cmVljnIn7sgHCelU8AvbEfALw_wcB

(In JS tag, use clickIds to transmit this value)

fbclid

Facebook Ads click ID.

String

IwAR1j1yBKErYRyrUR9mLw8lHZssY9GTabc9cyfZ9j_R1H29BjYJSuxbTKUUF

(In JS tag, use clickIds to transmit this value)

msclkid

Microsoft Bing Ads click ID

String

dfe067436646166d59d804f709cfeb0f

(In JS tag, use clickIds to transmit this value)

aff_click_id

Tune partner click ID

String

8151ed78-8c25-11ed-b370-025177df826b

...