How do you integrate a newsletter ad block?

Overview

With a newsletter ad block, you can integrate AdUp advertisements directly into your email newsletters.

The ads consist of a linked image (<img>) enclosed by a link (<a>). The image URL and target URL contain the same parameters so that impressions and clicks can be correctly tracked.

Prerequisites

Before you integrate newsletter ads, you will need:

• a created website in your publisher account

• a newsletter

• a matching newsletter layout

• your publisher ID

• your newsletter ID

How Newsletter Ads work

Each ad consists of two elements:

• a link (<a>)

• an image (<img>)

Both URLs must contain the same parameters.

This allows impressions and clicks to be uniquely assigned to an ad.

Integrating Newsletter Ads

Use the following structure for each ad within your newsletter.

<a href="https://d.adup-tech.com/newsletter/?[PARAMETER]"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?[PARAMETER]" border="0" alt="" /></a>

Make sure that the parameters in the href and src attributes are identical.

Multiple Ads in a Newsletter

You can place as many ads as you like within a newsletter.

Each ad block requires its own rank.

Example:

Required Parameters

p_id

The unique publisher ID.

Example:

p_id=1234

s_id

The unique ID of your newsletter.

Example:

s_id=5678

key

The key uniquely identifies the recipient.

For example, an MD5 hash of the email address is recommended.

Important:

The key must always be identical for the same recipient.

Therefore, do not use:

• random values

• timestamps

• session IDs

Example:

key=f3ada405ce890b6f8204094deb12d8a8

rank

Numbers the ads within a newsletter.

The numbering always starts at 1.

Example:

rank=1

Optional Parameters

query

Filters ads based on specific keywords.

Multiple terms are separated by semicolons.

Example:

query=mallorca;travel

m

Sets the minimum price per click.

The lower the value, the larger the number of possible campaigns usually is.

Example:

m=0.15

gdpr

Passes the data protection status manually.

Available values:

Example:

gdpr=1

gdpr_consent

Passes the IAB Consent String (Base64URL encoded).

Example:

gdpr_consent=[CONSENT_STRING]

Full Example

<a href="https://d.adup-tech.com/newsletter/?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1"        border="0"        alt="Ad"    /></a>

<a href="https://d.adup-tech.com/newsletter/?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1"        border="0"        alt="Ad"    /></a>

<a href="https://d.adup-tech.com/newsletter/?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=1234&s_id=5678&key=f3ada405ce890b6f8204094deb12d8a8&rank=1"        border="0"        alt="Ad"    /></a>

Best Practices

Use Identical Parameters

The parameters in the link (href) and in the image (src) must always be identical.

Use Stable User Keys

Use a permanently valid key, such as a hash of the email address.

This is the only way ads can be correctly analyzed.

Assign Rank Sequentially

Always number multiple ads within a newsletter in ascending order.

Example:

• rank=1

• rank=2

• rank=3

Test Newsletter Before Sending

Check before sending:

• are images loading?

• do all links work?

• are all parameters correct?

• is the order of the rank values correct?

Common Error Sources

Different Parameters in href and src

Both URLs must contain exactly the same parameters.

Duplicate Rank Values

Each ad requires a unique rank.

Dynamic User Keys

Do not use random values or timestamps for the key.

This dynamic data prevents impressions and clicks from being reliably matched.

Missing Privacy Information

If required, gdpr and gdpr_consent should also be passed.