Campaign
Setting up the retargeting pixel
Learn how to integrate the AdUp Retargeting Pixel, track user interactions, and transmit product data for personalised retargeting campaigns.
Prerequisites
To use the Retargeting Pixel, you need:
an active campaign
a product feed
the AdUp Retargeting Pixel
identical product IDs in tracking and the product feed
Important: The transmitted product IDs must match the IDs in your product feed exactly. Only then can users be shown the appropriate products again later.
Integration in Three Steps
Step 1 – Integrate the Retargeting API
Include the JavaScript file once in the <head> of your website.
<script async src="https://s.d.adup-tech.com/services/retargeting.js"></script>
Note: The script must only be loaded once per page view.
Step 2 – Initialize the Callback
After loading,
window.AdUpRetargeting()
is automatically called.
The complete tracking logic takes place within this function.
window.AdUpRetargeting = function(api) { // Tracking};
Step 3 – Send Tracking
Information is collected using various set...() methods and then transmitted using a track...() method.
Example:
api.setAccount(1234).setProduct(["ABC123","DEF456"]).trackProductList();
What Information Can Be Transmitted?
Account Information
Method | Description |
|---|---|
| Advertiser ID |
User Information
Method | Description |
|---|---|
| Email address (automatically hashed) |
| Already hashed email address |
Search Parameters
Any search parameters can be transmitted using setSearch().
For example:
Travel dates
Number of people
Rooms
Filters
Categories
These values can be used later for segmentation or personalisation.
Product Information
The relevant products are transmitted using setProduct().
Supported formats:
single product ID
multiple product IDs
product objects with price and quantity
Transactions
setTransaction() adds order information to the tracking.
Optionally, further information such as new customer status or order number can be added.
Devices
The device type is usually detected automatically.
If required, it can be set manually:
setMobile()setTablet()setDesktop()
Conversion
Additionally, a conversion can be recorded using
setConversionCode()
.
GDPR
If no TCF API is available, consent information can also be transmitted manually using
setGdpr()
.
Available Tracking Methods
A different tracking method is used depending on the page type.
Method | Use Case |
|---|---|
| Homepage |
| Category and search results |
| Product detail page |
| Shopping basket |
| Order or booking confirmation |
Recommended Implementation
Homepage
api.setAccount(1234).trackHomepage();
Category
api.setAccount(1234).setProduct(["ID1","ID2","ID3"]).trackProductList();
Product Detail
api.setAccount(1234).setProduct("ID1").trackProductPage();
Shopping Basket
api.setAccount(1234).setProduct([ { id:"ID1", price:49.90, quantity:2 }]).trackBasket();
Purchase Completion
api.setAccount(1234).setProduct([...]).setTransaction("ORDER123").setConversionCode("SALE").trackSale();
Optionally, users or products can subsequently be removed from retargeting:
.setDemarkProducts()or.setDemarkUser()
Best Practices
Only load the Retargeting API once per page view.
Use the same product IDs as in the product feed.
Only track products that are actually visible on category and search pages.
Add order information on the confirmation page.
Use conversion codes for more precise success measurement.
Only remove users or products from retargeting after a purchase if this aligns with your campaign strategy.
Conclusion
The AdUp Retargeting Pixel forms the foundation for personalised retargeting campaigns. By combining the product feed, user interactions, and conversion tracking, advertisements can be automatically matched to users' actual interests and delivered along the customer journey.