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:
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: