Overview
In this article, you will find various examples for integrating newsletter ad blocks.
If you have not yet completed the basic setup, we recommend reading the article first: “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:
single ad placements
newsletters with only one ad
simple integrations
Multiple Ads in a Newsletter
When 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="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
Using the query parameter, you can 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=Travel;Majorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Majorca" 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;Majorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Majorca" 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;Majorca"> <img src="https://d.adup-tech.com/newsletter/ad.jpg?p_id=12&s_id=15&key=user1&rank=1&query=Travel;Majorca" 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 sequence of the rank values correct?
Common Error Sources
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
Check especially before sending:
