Documents and Guides

Documents & Guides

Technical integration guide of the
advanced tag for advertisers

For our basic retargeting, you just need to integrate one simple line on every page of your site without any condition.

Basic retargeting pixel:
<script type="text/javascript" charset="utf-8" src="https://ad4m.at/1a2b3c4d.js"></script>
Simple as that! However, to allow us to achieve the best possible performance we highly recommend to add some more information to the pixel.

*The script ID "1a2b3c4d.js" in the script shown above is just an example. You get your personal ID from your key account.


Extended (dynamic) retargeting pixel
In order to be able to target the visitors of the site more specifically and increase the quality of the campaigns, we recommend to additionally fill in the following parameters. If any of the information is not available, simply leave the parameter empty.

<script type="text/javascript" charset="utf-8" src="https://ad4m.at/7rcigj1o.js"></script>
<script type="text/javascript" charset="utf-8"> ADVANCEDSTORE_MAGICTAG.config({
    rtOptout: false,
    orderValue: "",
    orderId: "",
    productId: "",
    productCategory: ""
});
</script>

Explanation of all parameters
rtOptout
Indicates to stop retargeting. Set to true if the user bought something or finished the registration. Otherwise set to false.
Type: Boolean
Example: false

orderId
Unique ID of the conversion. Usually the order number of your system.
Type: Integer
Example: 1234564798

orderValue
Sales value of the conversion.
Type: Integer
Example: 19.19

productCategory
ID or name of viewed category.
Type: String or Integer
Example: 987

productID
ID or name of viewed product.
Type: String or Integer
Example: 123

If you have any question during the implementation feel free to get in contact directly. In our live chat also technical support by developers is provided.


Example for a product page:
...
<script type="text/javascript" charset="utf-8">
ADVANCEDSTORE_MAGICTAG.config({
    rtOptout: false,
    orderValue: null,
    orderId: null,
    productId: 123456,
    productCategory: 123
});
</script>

Example for a category page:
...
<script type="text/javascript" charset="utf-8">
ADVANCEDSTORE_MAGICTAG.config({
    rtOptout: true,
    orderValue: 12.23,
    orderId: 123456,
    productId: null,
    productCategory: null
});
</script>
Image Formats:
Desktop 1200x627
Mobile 627x627
Logo 200x200
File Size for Images
100 KB maximum


Content:
Headline max. 25 characters
Body text max. 90 characters
Advertiser name max. 25 characters
Caption URL max. 30 characters
Call to action max. 15 characters

Layout*:
*Arrangement of the elements can vary depending on the environment and device.

View Tracking impression tracking link SSL-compliant optional
Click Tracking URL / click link to landing page optional
Aspect Ratio 16:9 (e.g. 640x360), 4:3 (e.g. 640x480)  
File Size 300 MB maximum  
Video Length 90 seconds maximum  
Our Recommendation 17 - 22 seconds  

File Formats
Banner Size:
Skyscraper 120x600 Small Mobile 300x50
Wide Skyscraper 160x600 Banner 468x60
Small Square 200x200 Maxi Ad 640x480
Medium Rectangle 300x250 Leaderboard 728x90
Half-Page 300x600 Billboard 800x250
Mobile 320x50 Billboard Big 970x250
Large Mobile 320x75 Large Leaderboard 970x90

Requirements & File Formats
File Size
150 KB maximum

Animation
Has to stop after 30 seconds.

Ad Server
SSL

Call To Action
No strobe-effect, please!

Logo
Must always be visible.