Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Why conversion tracking?!

...

Basis for all data collection and analysis is the implementation of a conversion tracking tag on the confirmation page that is displayed after completion of the sale.

in a nutshell

conversion tracking connects clicks and sales, that were registered via a tracking tag.

...

1. set up the click id as additional parameter: First, create the click id parameter that will be added to the target URL e.g. clicklid=#{ICLID}. This is done in the system under Manage Advertisers > Advertiser Tracking

read on

A detailed guide to additional parameters can be found here:

Additional parameters on click redirects

...

  • Conversion target: Defines an event and its type, for example Sale, Appinstall, Newslettersignup.

  • Tracking Category: Defines the commercial dimension, for instance according to the margin of a product group, for example a product group (“Flight”, “Hotel”, “Car Rental”)

read on

A detailed guide on conversion targets and tracking categories can be found here:

Working with conversion targets

Tracking categories

...

Info

Please implement your individual conversion tracking tag that contains your advertiser id and your tracking domain. Please do not use the PHP/JavaScript code of the following examples as it is.

read on

A detailed guide to generate the conversion tracking tag can be found here:

Configuring and implementing tracking tags

...

The JavaScript Code is very suitable for implementation in JavaScript environments such as tag management systems. Another advantage is that the basket parameter (JSON Object) can be easily included. Also it has additional functionalities like a container functionality.

Example:

...

Image Pixel

For simple tracking events (usually the ones without a basket) the image pixel is well suited. Also, many tracking switches require an image pixel.

...

The S2S callback link is quite similar to the image pixel. To convert an image pixel to a S2S callback URL just change the parameter typ=i to typ=s .

Example:

...

read on

A detailed guide on generation of S2S callback URLs can be found here:

Configuring and implementing tracking tags server-to-server (S2S)

Mandatory parameters

Variable (JS)

Variable (img/ s2s)

Example

Description

convTarget

ctg

sale

Conversion Target. The supplied conversion target needs to be registered in the system.

trcCat

trc

default

Tracking Category. The supplied tracking category should be registered in the system and has to be active.

Tracking category 'default' will be used implicitely when none or unknown tracking category is supplied.

In case of basket tracking the value “basket” should be used.

convId

cid

ORD12345

Conversion ID/ Order ID: This parameter identifies the conversion and should be unique. In case the ID contains sensitive information such as an email address, it should be hashed. Max length 255 chars.

ordValue

orv

4.98

Order Value: This parameter transmits the value of the conversion. If the conversion does not contain a value, the transmitted value should be '0.00'.

ordCurr

orc

EUR

Currency Code (ISO 4217)

siteId

sid

checkout

Sie ID: This parameter identifies the page on which the conversion is made.

clickId

cli

1234567890

Click id, that was transmitted with the click-in to the website. Usually it is the iclid and as well the the gclid, fbclid. For S2S callbacks this parameter is mandatory.

Optional parameters (frequently used)

Variable (JS)

Variable (img/ s2s)

Explanation

Example

discValue

dsv

This parameter transmits any discount values related to the conversion. When a discount is applied, please do not change the order value, the system can deduct the discount value from the order value.

12.34

discCode

dsc

Code of the used voucher.

XMAS2020-4578aved

custId

csi

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

bon78945

session

session

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

ses345

isCustNew

csn

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

true

payMethod

pmt

Payment method

paypal

userVal1

uv1

This parameter can transmit additional information

, max length 255 chars

.

userVal2

uv2

This parameter can transmit additional information

, max length 255 chars

.

userVal3

uv3

This parameter can transmit additional information

, max length 255 chars

.

userVal4

uv4

This parameter can transmit additional information

, max length 255 chars

.

read on

A detailed guide tracking tag implementation and a list of all parameters can be found here.

...

The individual components of the basket data are shown in the table below:

Variable

Example

Description

id

1

Optional
The ID of this position which needs to be 1 or higher, max value 32767. Can be submitted to address this position later. Generated automatically if empty.

uuid

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

Optional
A valid UUID of this position. Can be submitted to address this position later. Generated automatically if empty.

pid

12345678

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

prn

Adidas Originals Continental

Name of the product

brn

Adidas

Branc

pri

54.95

Price of the product (gross)

qty

1

Quantity of bought units

trc

default

Tracking category of the product. The tracking category needs to be registered to the system. In case no specific tracking category should be applied, please use “default”

prc

Clothing.Men.Shoes

Optional: Hierarchie of the product category. Use ‘.’ as separator.

Example (without any technical identifier)
No id / uuid is submitted and will be generated internally

...

The onpage tag should be implemented on all publicly accessible pages. Its main purpose is the detection of incoming traffic. Further functionalities are related to traffic quality and a container functionality.

Variable

Example

Description

siteId

www.shop.com/dresses/red-dress123.html

Path or URL of the Page

productId

12345678

Only for product pages: Unique product id of the shown product.

custId

bon78945

This important parameter transmits any ID given to the customer. Use this for implementing cross-device and cookieless tracking. Max length 255 chars.

session

ses345

This important parameter transmits any ID given to the session of the customer. Use this for implementing cross-device and cookieless tracking. Max length 255 chars.

locationHref

Result of window.location.href call

The complete Browser-URL on which the tag was fired. Used to prevent accuracy issues in case of strict referrer browser policy. Please don’t change the default value window.location.href

userVal1

Optional parameter, you are free to put in any additional information that may be needed

, max length 255 chars

.

userVal2

Optional parameter, you are free to put in any additional information that may be needed

, max length 255 chars

.

Cookies and data protection

...