Campaign

Examples of newsletter ad block integration

Use practical code examples for integrating newsletter ad blocks – from single ads to newsletters with multiple ad placements.

Overview

In this article, you will find various examples for integrating newsletter ad units.

If you have not completed the basic setup yet, we recommend reading the article “How to integrate a newsletter ad unit” first.

Single newsletter ad

This example shows the integration of a single advert within a newsletter.

<a href="https://d.adup-tech.com/newsletter/?p_id=2&s_id=5&key=abcdef&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=2&s_id=5&key=abcdef&rank=1"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=2&s_id=5&key=abcdef&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=2&s_id=5&key=abcdef&rank=1"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=2&s_id=5&key=abcdef&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=2&s_id=5&key=abcdef&rank=1"        border="0"        alt="Anzeige" /></a>

Suitable for:

  • single ad placements

  • newsletters with only one ad

  • simple integrations

Multiple ads in the newsletter

If multiple ads are integrated within a newsletter, each ad is assigned its own rank.

The remaining parameters remain identical.

<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=2">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=2"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=3">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=3"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=2">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=2"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=3">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=3"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=2">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=2"        border="0"        alt="Anzeige" /></a><a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=3">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=3"        border="0"        alt="Anzeige" /></a>

Important:

  • The rank must be unique for each ad.

  • The numbering always starts at 1.

  • p_id, s_id and key remain the same within a newsletter.

Multiple ads with keyword filter

You can filter ads based on specific keywords using the query parameter.

<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Reisen;Mallorca"        border="0"        alt="Anzeige" /></a>

Suitable for:

  • topic-specific newsletters

  • targeted ads

  • content categories

Example in test mode

During implementation, you can use the adtest parameter.

In test mode, neither impressions nor clicks are recorded.

<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&adtest=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&adtest=1"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&adtest=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&adtest=1"        border="0"        alt="Anzeige" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&adtest=1">    <img        src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&adtest=1"        border="0"        alt="Anzeige" /></a>

Best Practices

Use identical parameters

The parameters in the href and src attributes must always be identical.

Assign unique rank values

Each ad within a newsletter requires its own rank.

Example:

  • rank=1

  • rank=2

  • rank=3

Use a stable user key

The key should not change for the same recipient.

For example, a hash of the email address is recommended.

Test the newsletter before sending

Check before sending:

  • are images loading correctly?

  • do all links work?

  • are all parameters correct?

  • is the order of the rank values correct?

Common sources of errors

Mismatched parameters in link and image

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

Duplicate rank values

Use a unique rank for each ad.

Dynamic user keys

Do not use random values or timestamps for the key parameter.

Missing parameters

Before sending, check in particular:

  • p_id

  • s_id

  • key

  • rank