Campaign

Conversion tracking via AdUp Pixel

Measure conversions reliably and attribute them to your campaigns. Learn how to correctly create and install the conversion pixel.

A woman working on a laptop

Measure your success!

Determine which of your campaigns and keywords are most efficient with conversion tracking from AdUp Technology, thereby increasing your ROI. You can also track what actions follow after clicking on an ad, such as the purchase of a product or signing up for a newsletter. 


How it works

All you need to do is create a conversion code and integrate it on your page where the conversion occurs (e.g. on the booking confirmation page) using an <img> tag.​ As soon as a user reaches your website by clicking on an AdUp promotional material, a temporary cookie is deposited, which is then used to register or track the conversion.


Creating conversion code

Step 1

Log in here with your access data in the Advertiser frontend. 

Step 2

Click on the “Tools” tab and select “Conversion Tracking”.

Step 3

Now generate a new conversion code via the “Create Conversion Code” button.

Step 4

Assign a name and define the type (this is only for internal classification purposes):​

  • Enquiry

  • Registration

  • Page view

  • Sale

  • Other

Step 5 (optional)

Enter a value for the conversion (this and other values can also be passed dynamically later when calling the conversion tag via URL parameters).

Step 6 (optional)

Change the counting method of the conversion code. The “every” counting method records every conversion for which there has been a valid click through your ad(s) during conversion validation. In contrast, the “One-time” option only records the first conversion. A click can then only lead to one conversion. This setting applies individually per conversion code.  

Finished

After you have clicked on the “Save” button, the “Conversion Tracking” page should automatically refresh and the new conversion code should be available in the list.


Integration of a conversion tag on your page

Integrate an <img> tag with the corresponding URL parameters at the locations in the <body> area on your website where the conversion is to be tracked (e.g. on the booking confirmation page). It is easily possible to record different conversions by creating multiple conversion codes and integrating them wherever they occur.

The working integration code of your conversion codes can be viewed on the “Tools” > “Conversion Tracking” page in the Advertiser frontend. To do this, simply select the “Integration Code” option in the “Actions” column of the desired conversion code.


Simple integration

Paste this HTML script tag on the page where the conversion takes place.

<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=[ACCOUNT_ID]&event=conversion&code=[PARAMETER]">
</script>
<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=[ACCOUNT_ID]&event=conversion&code=[PARAMETER]">
</script>
<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=[ACCOUNT_ID]&event=conversion&code=[PARAMETER]">
</script>

Available query parameters

−

Name

Required

Description

Example

account

✅

Your unique account ID.

account=1234

Event

✅

The type of the recorded event.

event=conversion

code

✅

Your unique conversion code.

code=<CONVERSION_CODE>

GDPR

❌

Manually submits the GDPR status. Use this parameter if automatic detection via the TCF API is not available. Possible values: 0, 1

gdpr=1

GDPR consent

❌

Manually submits the IAB TCF consent string. Use this parameter if automatic detection via the TCF API is not available.

gdpr_consent=<CONSENT_STRING>


Advanced integration

Your conversion code and other data (e.g. order number or price) are passed via window.adup.push() event.

<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: [ACCOUNT_ID],
        event: 'conversion',
        code: [PARAMETER],
        orderId: '<ORDER_ID>',
        total: [TOTAL_AMOUNT]
    });
</script>
<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: [ACCOUNT_ID],
        event: 'conversion',
        code: [PARAMETER],
        orderId: '<ORDER_ID>',
        total: [TOTAL_AMOUNT]
    });
</script>
<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: [ACCOUNT_ID],
        event: 'conversion',
        code: [PARAMETER],
        orderId: '<ORDER_ID>',
        total: [TOTAL_AMOUNT]
    });
</script>

Available query parameters

−

Name

Required

Description

Example

account

✅

Your unique account ID. Can be set either via URL parameter on the script tag or as an event option.

account: 3914

Event

✅

The type of the recorded event.

event: ‘conversion’

description

❌

Adds a description of the conversion to the tracking.

description: ‘<DESCRIPTION>‘

Order ID

❌

Adds the order or invoice number to the tracking.

orderId: ‘<ORDER_ID>‘

Product ID

❌

Adds the product ID to the tracking.

product ID: ‘<PRODUCT_ID>‘

price

❌

Adds the unit price of the product to the tracking.

price: 12.34

quantity

❌

Adds the product quantity to the tracking.

quantity: 2

total

❌

Adds the total order value to the tracking.

total: 123.45

GDPR

❌

Manually submits the GDPR status. Use this parameter if automatic detection via the TCF API is not available. Possible values: true, false

GDPR: true

GDPR consent

❌

Manually submits the IAB TCF consent string. Use this parameter if automatic detection via the TCF API is not available.

gdprConsent: ‘<CONSENT_STRING>‘

code

✅

Your unique conversion code.

code: ‘<CONVERSION_CODE>‘


Required parameters

Name

Description

Example

t

Your unique conversion code

  • max. 255 characters

  • UTF-8 & URL-encoded


t=ABCDEF


Optional parameters

Name

Description

Example

order_id

Order number

  • max. 25 characters

  • UTF-8 & URL-encoded

  • Used for deduplication of conversions


order_id=A12345

total

Total price of the conversion

  • max. 2 decimal places

  • Full stop as separator for decimal places

  • No grouping of thousands

  • max. 99999.99


total=399.98

item_number

Article number

  • max. 25 characters

  • UTF-8 & URL-encoded


item_number=EF_7890

quantity

Quantity

  • max. 2 decimal places

  • Full stop as separator for decimal places

  • No grouping of thousands

  • max. 999.99


quantity=2

price

Unit price of the article

  • max. 2 decimal places

  • Full stop as separator for decimal places

  • No grouping of thousands

  • max. 99999.99


price=199.99

description

Description of the conversion

  • max. 255 characters

  • UTF-8 & URL-encoded


description=TravelBooking

gdpr
gdpr_consent

Here you have the option to pass GDPR information to us.

gdpr

1 = GDPR applies

0  = GDPR does not apply

(omit) = Unknown (Standard)

gdpr_consent

The IAB Consent String (base64url-encoded)


gdpr=1&gdpr_consent=[CONSENT_STRING]


Examples of integration

Simple

  • Advertiser ID: 1234

  • Conversion code: ABCDEF

<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=1234&event=conversion&code=ABCDEF">
</script>
<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=1234&event=conversion&code=ABCDEF">
</script>
<script
    async
    src="https://s.d.adup-tech.com/services/pixel.js?account=1234&event=conversion&code=ABCDEF">
</script>

Advanced

  • Advertiser ID: 1234

  • Conversion code: ABCDEF

  • Description: Conversion

  • Order number: abc123

  • Total price: £46.50

<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: 1234,
        event: 'conversion',
        code: 'ABCDEF',
        orderId: 'abc123',
        total: 46.50
    });
</script>
<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: 1234,
        event: 'conversion',
        code: 'ABCDEF',
        orderId: 'abc123',
        total: 46.50
    });
</script>
<script async src="https://s.d.adup-tech.com/services/pixel.js"></script>
<script>
    window.adup = window.adup || [];
    window.adup.push({
        account: 1234,
        event: 'conversion',
        code: 'ABCDEF',
        orderId: 'abc123',
        total: 46.50
    });
</script>


Create test conversion

Step 1

Log in here with your access data in the Advertiser frontend. 

Step 2

Click on the “Tools” tab and select “Conversion Tracking”.

Step 3

Select the “Create test conversion” option in the “Actions” column of the desired conversion code.

Step 4 (optional)

Leave a comment for the test conversion.

Step 5

Click on the “Create test conversion” button.

Step 6

Now, in a new browser tab, call up the website on which your conversion code has been integrated (e.g. your order confirmation page).

Finished

Then refresh the “Conversion Tracking” page in the Advertiser frontend or call it up again via the menu item “Tools” > “Conversion Tracking”. A new test conversion should now be visible in the “Test conversions” column of the corresponding conversion code.