Overview
In this article, you will find various examples of how to integrate newsletter ad blocks.
If you have not yet completed the basic setup, we recommend that you first read the article “How to integrate a newsletter ad block”.
Single newsletter ad
This example shows the integration of a single advertisement 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="Ad" /></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="Ad" /></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="Ad" /></a>
Suitable for:
single ad placements
newsletters with only one ad
simple integrations
Multiple ads in a newsletter
If multiple ads are integrated within a newsletter, each ad is given 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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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="Ad" /></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=Travel;Mallorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Mallorca" border="0" alt="Ad" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Mallorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Mallorca" border="0" alt="Ad" /></a>
<a href="https://d.adup-tech.com/newsletter/?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Mallorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Mallorca" border="0" alt="Ad" /></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 tracked.
<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="Ad" /></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="Ad" /></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="Ad" /></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:
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 newsletters 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 Error
Different 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:
