Overview
In this article, you will find various examples of how to integrate newsletter ad blocks.
If you have not yet set up the basic configuration, we recommend that you first read the article "How do you 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:
individual 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 given its own rank.
The other 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 use the query parameter to filter ads based on specific keywords.
<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="Ad" /></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="Ad" /></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="Ad" /></a>
Suitable for:
topic-specific newsletters
targeted advertisements
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="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.
An email address hash is recommended, for example.
Test 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 Causes of Errors
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, please check in particular:
