Installation

How do I install a static ad unit?_

In order to use AdUp ads on your website, you must have created a page and a corresponding ad unit in your publisher account. In order for static ads to behave correctly, make sure that the "Type of integration" in the ad unit layout form is set to "Static-Ads".

How it works

The ad media is loaded within an iFrame at the position on your website where you position our embed code or the placeholder HTML container. The size of the iFrame, as well as the number and design of the ads can be freely configured by you via the ad unit layout form in the publisher frontend.

As the name "Static-Ads" implies, the size of the ad is static and therefore should rather be used in the desktop area. However, if you optimize your website for different screen sizes, then we recommend using Responsive-Ads.

Embedding types

There are two ways to embed Static-Ads on your website:

Asynchronous (Recommended)

Through the asynchronous integration, your website is loaded independently of the advertising call of our ads. First, you place the desired placeholder HTML elements at the locations on your website where you want ads to appear. Then, our delivery API is loaded once and asynchronously using a dynamic <script> tag. Once the API has finished loading, a global callback function is executed which stores your actual embedding logic.

This type of integration is especially useful if you want to place multiple AdUp ads on your site. Due to the programmatic definition of the ad units, you also have various events available to which you can react accordingly (e.g. "onClick" or "onNoAds").

Asynchronous (Recommended)
<!-- 1. Definieren des HTML-Platzhalters mit einer eindeutigen ID -->
<div id="adup1"></div>

<!-- 2. Laden unserer Javascript-API und Ersetzen des HTML-Platzhalters durch 
        die gewünschten Werbemittel im Callback sobald die API verfügbar ist -->
<script type="text/javascript">
    window.uAd_init = function() {
        window.uAd.embed("adup1", {
            param1: "value1",
            param2: "value2"
            ...
        });
    };
 
    if (typeof window.uAd === "object") window.uAd_init();
    else (function(d, t) {
        var g = d.createElement(t), s = d.getElementsByTagName(t)[0];
        g.src = "https://s.d.adup-tech.com/jsapi"
        g.async = true;
        s.parentNode.insertBefore(g, s);
    }(document, "script"));
</script>

Synchronous

With synchronous integration, a <script> tag is specified directly at the position on your website where the advertising material should appear. When your website is loaded, the script is then executed automatically (synchronously) and creates an iFrame with our ads at the corresponding position.

This is the easiest way to integrate AdUp ads. However, due to the definition of the ad unit via URL parameters, not all options are available to you here in contrast to the asynchronous integration.

<!-- Das gewünschte Werbemittel erscheint an der Stelle Ihrer Website, 
     an der Sie dieses Script positionieren -->
<script type="text/javascript" 
        src="https://s.d.adup-tech.com/ads/display.js?param1=value1&param2=value2...">
</script>

Required parameters

Name Description Example
placementkey

The unique placement key of your ad unit.

Asynchronous (programmatic)
placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"
Synchronous (URL parameter)
placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d
responsive

Activates/deactivates the Responsive-Ads feature for the ad unit. 

Note: For "Static-Ads" in the asyncrhonous integration, the parameter must always be set to "false"!

Asynchronous (programmatic)
responsive: false
Synchronous (URL parameter)
// not available

Optional parameters

Name Description Example
query

Keywords by which the ads are to be filtered. Several keywords can be separated by semicolons.

Asynchronous (programmatic)
// string
query: "Mallorca;Flight"

// array
query: ["Mallorca", "flight"]
Synchronous (URL parameter)
query=Mallorca;flight
mincpc

This is the minimum price you want to earn for a click. Generally, the lower the minimum price, the more campaigns you will be presented with and the more money you can earn due to greater competition for the position.

Asynchronous (programmatic)
mincpc: 0.15
Synchronous (URL parameter)
mincpc=0.15
pageurl

The current URL of the page on which the advertisement is played. Should always be set if our advertising material is embedded within one or more nested iFrames on your page, as we may then no longer be able to determine the url.

Asynchronous (programmatic)
=http://www.example.com
Synchronous (URL parameter)
pageurl=http%3A%2F%2Fwww.example.com
skip

Number of ads to be skipped during delivery. Useful if you place several ads on one page.

Asynchronous (programmatic)
skip: 2
Synchronous (URL parameter)
skip=2
lazy

Activates the "Lazy Loading" feature. This means that the ad is only loaded (and thus the impression is only tracked) as soon as it is visible to the user.

Asynchronous (programmatic)
lazy: true
Synchronous (URL parameter)
lazy=1
lazyoffset

By default, with "lazy loading" our advertising media are only displayed when they are visible to the user. With the help of the "lazyoffset" option, you also have the possibility to define an offset (in pixels). In this way, our advertising media load a little earlier as soon as they are "close" to the visible area.

Asynchronous (programmatic)
lazyoffset: 500
Synchronous (URL parameter)
lazyoffset=500
placeholdervalues

Values for dynamic ads placeholders can be transferred here.

Asynchronous (programmatic)
placeholdervalues: {
    "destination": "Paris",
    "price": "299,99€"
}
Synchronous (URL parameter)
// not available
flyin

Activates the "Fly-In-Ads" feature for the ad unit.

For more information and options, see the Fly-In Ads documentation.

Asynchronous (programmatic)
flyin: true
Synchronous (URL parameter)
flyin=1
adtest

Impressions and clicks are not tracked when activated. Should only be used for test purposes!

Asynchronous (programmatic)
adtest: true
Synchronous (URL parameter)
adtest=1
gfpr gdpr_consent

Normally, we determine the required GDPR data automatically via the TCF API built into the website. 

If this is not available, or if it is not possible to use it for technical reasons, you have the option of transferring the GDPR data manually here.

gdpr

true or 1 = GDPR applies

false or 0 = GDPR does not apply

null or (omit) = Unknown (default)

gdpr_consent

The IAB Consent String (base64url-encoded)

Translated with www.DeepL.com/Translator (free version)

Asynchronous (programmatic)
gdpr: true,
gdpr_consent:"[CONSENT_STRING]"
Synchronous (URL parameter)
gdpr=1&amp;gdpr_consent=[CONSENT_STRING]

Events / Callbacks

Name Description Example
onClick

Is called automatically as soon as an ad has been clicked. The first (and only) parameter returned is the rank of the ad within the ad media.

Asynchronous (programmatic)
onClick: function(rank) {
    console.log("ad " + rank + " clicked");
}
Synchronous (URL parameter)
// not available
onResize

Is called automatically as soon as the size of the ad changes (e.g. advertorial ads). The new width is returned as the first parameter and the new height as the second parameter.

Asynchronous (programmatic)
onResize: function(width, height) {
    console.log("new size is " + width + "x" + height);
}
Synchronous (URL parameter)
// not available
onAds

Is called automatically as soon as the advertising material has been loaded successfully. The container ID is returned as the first (and only) parameter.

Asynchronous (programmatic)
onAds: function(id) {
    console.log("ads for " + id);
}
Synchronous (URL parameter)
// not available
onNoAds

Is called automatically as soon as the advertising medium could not be played. The container ID is returned as the first (and only) parameter.

Asynchronous (programmatic)
onNoAds: function(id) {
    console.log("no ads for " + id);
}
Synchronous (URL parameter)
// not available