Home

Support

Wie baust du einen Static Anzeigenblock ein?

Home

Support

Wie baust du einen Static Anzeigenblock ein?

Kampagne

Wie baust du einen Static Anzeigenblock ein?

Binde Static Ads schnell und zuverlässig auf deiner Website ein. Erfahre, welche Einbindungsart sich eignet, welche Parameter verfügbar sind und wie du Anzeigen optimal konfigurierst.

Funktionsweise

Das Werbemittel wird innerhalb einem iFrames an der Stelle auf Ihrer Webseite geladen, an der Sie unseren Einbindungscode bzw. den Platzhalter-HTML-Container positionieren. Die Größe des iFrames, sowie die Anzahl und das Design der Anzeigen können von Ihnen über das Anzeigenblock-Layout-Formular im Publisher-Frontend frei konfiguriert werden.

Wie der Name "Static-Ads" schon sagt, ist die Größe des Werbemittels statisch und sollte daher eher im Desktop-Bereich verwendet werden. Falls Sie Ihre Webseite jedoch für unterschiedliche Bildschirmgrößen optimieren, dann empfehlen wir die Verwendung von Responsive-Ads.

Einbindungsarten

Es gibt zwei Möglichkeiten Static-Ads auf Ihrer Webseite einzubinden:

Asynchron (Empfohlen)

Durch die asynchrone Einbindung wird Ihre Webseite unabhängig vom Werbeaufruf unserer Anzeigen geladen. Zunächst platzieren Sie die gewünschten Platzhalter-HTML-Elemente an den Stellen auf Ihrer Website, an denen  Werbeanzeigen erscheinen sollen. Anschließend wird unsere Auslieferungs-API einmalig und asynchron mittels dynamischem <script>-Tag geladen. Sobald die API fertig geladen ist, wird eine globale Callback-Funktion ausgeführt, in welcher Ihre eigentliche Einbindungslogik hinterlegt ist.​

Diese Art der Einbinung bietet sich besonders dann an, wenn Sie mehrere AdUp Werbemittel auf Ihrer Seite platzieren möchten. Durch die programmatische Definition der Werbeblöcke stehen Ihnen hier außerdem auch verschiedene Events zur Verfügung, auf die Sie entsprechende reagieren können (z.B. "onClick" oder "onNoAds").

Asynchron (Empfohlen)

<!-- 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>
<!-- 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>
<!-- 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>

Synchron

Bei der synchronen Einbindung wird ein <script>-Tag direkt an die Stelle Ihrer Webseite angegeben, an der das Werbemittel erscheinen soll. Beim Laden Ihrer Webseite wird das Script dann automatisch (synchron) ausgeführt und erstellt an der entsprechenden Position einen iFrame mit unseren Werbeanzeigen. 

Dies ist die einfachste Art AdUp Werbemittel einzubinden. Durch die Definition des Werbeblocks per URL-Parameter stehen Ihnen hier im Gegensatz zur asynchronen Einbindung jedoch nicht alle Optionen zur Verfügung.

<!-- 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>
<!-- 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>
<!-- 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>

Erforderliche Parameter

Name

Beschreibung

Beispiel

placementkey

Der eindeutige Placement-Key ihres Anzeigenblocks.

Asynchron (programmatisch)

placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"
placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"
placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"

Synchron (URL-Parameter)

placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d
placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d
placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d

responsive

Aktiviert/Deaktiviert das Responsive-Ads-Feature für den Anzeigenblock. 

Hinweis: Für "Static-Ads" in der asyncrhonen Einbindung muss der Parameter immer auf "false" gesetzt werden!

Asynchron (programmatisch)

responsive: false
responsive: false
responsive: false

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

Optionale Parameter

Name

Beschreibung

Beispiel

query

Keywords, nach denen die Anzeigen gefiltert werden sollen. Mehrere Keywords können durch Semikolon getrennt werden.

Asynchron (programmatisch)

// string
query: "Mallorca;Flug"

// array
query: ["Mallorca", "Flug"]
// string
query: "Mallorca;Flug"

// array
query: ["Mallorca", "Flug"]
// string
query: "Mallorca;Flug"

// array
query: ["Mallorca", "Flug"]

Synchron (URL-Parameter)

query=Mallorca;Flug
query=Mallorca;Flug
query=Mallorca;Flug

mincpc

Dies ist der Preis, den Sie für einen Klick mindestens verdienen wollen. Generell gilt, je niedriger der Minimumpreis, desto mehr Kampagnen werden Ihnen vorgelegt und desto mehr Geld können Sie aufgrund des größeren Wettbewerbs auf der Position verdienen. 

Asynchron (programmatisch)

mincpc: 0.15
mincpc: 0.15
mincpc: 0.15

Synchron (URL-Parameter)

mincpc=0.15
mincpc=0.15
mincpc=0.15

pageurl

Die aktuelle URL der Seite, auf der die Werbung ausgespielt wird. Sollte immer dann gesetzt werden, wenn unser Werbemittel innerhalb eines oder mehrerer verschachtelter iFrames auf Ihrer Seite eingebunden ist, da dann unter Umständen die Url von uns nicht mehr ermittelt werden kann.

Asynchron (programmatisch)

pageurl: "http://www.example.com"
pageurl: "http://www.example.com"
pageurl: "http://www.example.com"

Synchron (URL-Parameter)

pageurl=http%3A%2F%2Fwww.example.com
pageurl=http%3A%2F%2Fwww.example.com
pageurl=http%3A%2F%2Fwww.example.com

skip

Anzahl der Anzeigen, die bei der Auslieferung übersprungen werden sollen. Nützlich wenn Sie mehrere Werbemittel auf einer Seite platzieren.

Asynchron (programmatisch)

skip: 2
skip: 2
skip: 2

Synchron (URL-Parameter)

skip=2
skip=2
skip=2

lazy

Aktiviert das "Lazy Loading"-Feature. Das bedeutet, dass das Werbemittel erst geladen (und somit auch erst die Impression getrackt) wird, sobald es im für den User sichtbaren Bereich der Seite ist.

Asynchron (programmatisch)

lazy: true
lazy: true
lazy: true

Synchron (URL-Parameter)

lazy=1
lazy=1
lazy=1

lazyoffset

Standardmäßig werden beim "Lazy-Loading" unsere Werbemittel erst angezeigt, wenn diese für den Benutzer sichtbar sind. Mithilfe der Option "lazyoffset" haben Sie zusätzlich die Möglichkeit einen Versatz (in Pixel) zu definieren. Unsere Werbemittel laden so bereits etwas früher, sobald diese in der „Nähe“ des sichtbaren Bereiches sind.

Asynchron (programmatisch)

lazyoffset: 500
lazyoffset: 500
lazyoffset: 500

Synchron (URL-Parameter)

lazyoffset=500
lazyoffset=500
lazyoffset=500

placeholdervalues

Hier können Werte für Dynamic-Ads Platzhalter übergeben werden.

Asynchron (programmatisch)

placeholdervalues: {
    "destination": "Paris",
    "price": "299,99€"
}
placeholdervalues: {
    "destination": "Paris",
    "price": "299,99€"
}
placeholdervalues: {
    "destination": "Paris",
    "price": "299,99€"
}

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

flyin

Aktiviert das "Fly-In-Ads"-Feature für den Anzeigenblock.

Weitere Informationen und Optionen dazu finden Sie in der Dokumentation zu Fly-In-Ads.

Asynchron (programmatisch)

flyin: true
flyin: true
flyin: true

Synchron (URL-Parameter)

flyin=1
flyin=1
flyin=1

adtest

Impressions und Klicks werden nicht getrackt, wenn aktiviert. Sollte nur für Testzwecke verwendet werden!

Asynchron (programmatisch)

adtest: true
adtest: true
adtest: true

Synchron (URL-Parameter)

adtest=1
adtest=1
adtest=1

gfpr gdpr_consent

Im Normalfall ermitteln wir die erforderlichen GDPR-Daten automatisch über die auf der Website verbauten TCF API. 

​Sollte diese nicht vorhanden sein, oder es aus technischen Gründen nicht möglich sein diese zu verwenden, dann haben Sie hier die Möglichkeit die GDPR-Daten manuell zu übergeben.

​gdpr

true bzw. 1 = GDPR gilt

false bzw. 0  = GDPR gilt nicht

null bzw. (weglassen) = Unbekannt (Standard)

​gdpr_consent

Der IAB Consent String (base64url-encoded)

Asynchron (programmatisch)

gdpr: true,
gdpr_consent:"[CONSENT_STRING]"
gdpr: true,
gdpr_consent:"[CONSENT_STRING]"
gdpr: true,
gdpr_consent:"[CONSENT_STRING]"

Synchron (URL-Parameter)

gdpr=1&gdpr_consent=[CONSENT_STRING]
gdpr=1&gdpr_consent=[CONSENT_STRING]
gdpr=1&gdpr_consent=[CONSENT_STRING]

Events / Callbacks

Name

Beschreibung

Beispiel

onClick

Wird automatisch aufgerufen, sobald eine Werbeanzeige angeklickt wurde. Als erster (und einziger) Parameter wird der Rang der Anzeige innerhalb des Werbemittels zurückgegeben.

Asynchron (programmatisch)

onClick: function(rank) {
    console.log("ad " + rank + " clicked");
}
onClick: function(rank) {
    console.log("ad " + rank + " clicked");
}
onClick: function(rank) {
    console.log("ad " + rank + " clicked");
}

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

onResize

Wird automatisch aufgerufen, sobald sich die Größe des Werbemittels ändert (z.B. bei Advertorial-Ads). Als erster Parameter wird wird neue Breite und als zweiter Parameter die neue Höhe zurückgegeben.

Asynchron (programmatisch)

onResize: function(width, height) {
    console.log("new size is " + width + "x" + height);
}
onResize: function(width, height) {
    console.log("new size is " + width + "x" + height);
}
onResize: function(width, height) {
    console.log("new size is " + width + "x" + height);
}

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

onAds

Wird automatisch aufgerufen, sobald das Werbemittel erfolgreich geladen wurde. Als erster (und einziger) Parameter wird die Container-ID zurückgegeben.

Asynchron (programmatisch)

onAds: function(id) {
    console.log("ads for " + id);
}
onAds: function(id) {
    console.log("ads for " + id);
}
onAds: function(id) {
    console.log("ads for " + id);
}

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

onNoAds

Wird automatisch aufgerufen, sobald das Werbemittel nicht ausgespielt werden konnte. Als erster (und einziger) Parameter wird die Container-ID zurückgegeben.

Asynchron (programmatisch)

onNoAds: function(id) {
    console.log("no ads for " + id);
}
onNoAds: function(id) {
    console.log("no ads for " + id);
}
onNoAds: function(id) {
    console.log("no ads for " + id);
}

Synchron (URL-Parameter)

// nicht verfügbar
// nicht verfügbar
// nicht verfügbar

Das könnte dich auch interessieren

5 Min. Lesezeit

Beispiele für den Einbau von Static Anzeigenblöcken

Entdecke praktische Beispiele für die Einbindung von Static Anzeigenblöcken – von der einfachen Integration bis zur erweiterten asynchronen Implementierung mit mehreren Werbeflächen.

Publisher