Zurück zur Übersicht
Einbau

Wie verbaue ich einen static Anzeigenblock?_

Damit du AdUp Werbemittel auf deiner Webseite verwenden kannst, musst du eine Seite, sowie einen entsprechenden Anzeigenblock in deinem Publisher-Account angelegt haben. 

Damit sich Static-Ads korrekt verhalten, sollte darauf geachtet werden, dass im Anzeigenblock-Layout-Formular die "Art der Einbindung" auf "Static-Ads" gesetzt ist.

 

 

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").

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

Erforderliche Parameter

Name Beschreibung Beispiel
placementkey

Der eindeutige Key Ihres Placements.

 

Asynchron (JSON)
placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"
Synchron (URL-Parameter)
placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d

Optionale Parameter

Name Beschreibung Beispiel
responsive

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

 

 

Asynchron (JSON)
responsive: false
Synchron (URL-Parameter)
// nicht verfügbar
query

Keywords, nach denen die Anzeigen gefiltert werden sollen.

Mehrere Keywords können durch Semikolon getrennt werden.

 

Asynchron (JSON)
// string
query: "Mallorca;Flug"

// array
query: ["Mallorca", "Flug"]
Synchron (URL-Parameter)
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 (JSON)
mincpc: 0.15
Synchron (URL-Parameter)
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 eingebunden ist, und dadruch unter Umständen die URL von AdUp nicht mehr ermittelt werden kann

 

Asynchron (JSON)
pageurl: "http://www.example.com"
Synchron (URL-Parameter)
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 und doppelte bzw. sich wiederholende Anzeigen zu vermeiden wollen.

 

Asynchron (JSON)
skip: 2
Synchron (URL-Parameter)
skip=2
lazy

Aktiviert das "Lazy Loading"-Feature. 

Das bedeutet, dass die Anzeige erst geladen (und somit auch die Impression erst getrackt) wird, sobald diese im für den User sichtbaren Bereich der Seite ist.

 

Asynchron (JSON)
lazy: true
Synchron (URL-Parameter)
lazy=1
lazyoffset

Standardmäßig werden die Anzeigen beim "Lazy-Loading" 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.

Die Anzeigen laden so bereits etwas früher, sobald diese in der „Nähe“ des sichtbaren Bereichs kommen.

 

Asynchron (JSON)
lazyoffset: 500
Synchron (URL-Parameter)
lazyoffset=500
colormode

Standardmäßig basiert der für die Platzierung verwendete Farbmodus auf dem vom Benutzer definierten Farbschema des Betriebssystems (Hell/Dunkel) – nicht auf dem Designmodus der jeweiligen Website.

Wenn eine Website selbst keinen nativen Dunkelmodus unterstützt, kann eine speziell dafür konfigurierte Platzierung auf einer hellen Seite optisch unpassend wirken.

Hier haben Sie die Möglichkeit, einen Farbmodus zu erzwingen:

  • auto (Standard)
  • light
  • dark
Asynchron (JSON)
colormode: "light"
Synchron (URL-Parameter)
colormode=light
placeholdervalues

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

Asynchron (JSON)
placeholdervalues: {
    "destination": "Paris",
    "price": "299,99€"
}
Synchron (URL-Parameter)
// 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 (JSON)
flyin: true
Synchron (URL-Parameter)
flyin=1
adtest

Impressions und Klicks werden nicht getrackt, wenn aktiviert. 

Sollte nur für Testzwecke verwendet werden!

 

Asynchron (JSON)
adtest: true
Synchron (URL-Parameter)
adtest=1
gdpr

Im Normalfall ermitteln wir die erforderlichen GDPR Informationen 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.

  • true bzw. 1 = GDPR gilt
  • false bzw. 0  = GDPR gilt nicht

 

Asynchron (JSON)
gdpr: true
Synchron (URL-Parameter)
gdpr=1
gdpr_consent

Im Normalfall ermitteln wir die erforderlichen GDPR Informationen 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 den IAB Consent String (base64url-encoded) zu übergeben.

 

Asynchron (JSON)
gdpr_consent:"[CONSENT_STRING]"
Synchron (URL-Parameter)
gdpr_consent=[CONSENT_STRING]

Events / Callbacks

Name Beschreibung Beispiel
onAds

Wird automatisch aufgerufen, sobald das Werbemittel erfolgreich geladen wurde.

Als Parameter wird die eindeutige Container-ID des Placements übergeben.

 

Asynchron (JSON)
onAds: function(id) {
    console.log("ads for " + id);
}
Synchron (URL-Parameter)
// nicht verfügbar
onNoAds

Wird automatisch aufgerufen, sobald das Werbemittel nicht ausgespielt werden konnte.

Als Parameter wird die eindeutige Container-ID des Placements übergeben.

 

 

Asynchron (JSON)
onNoAds: function(id) {
    console.log("no ads for " + id);
}
Synchron (URL-Parameter)
// nicht verfügbar
onClick

Wird automatisch aufgerufen, sobald eine Anzeige geklickt wurde.

Als Parameter wird der Rang der geklickten Anzeige innerhalb des Werbemittels übergeben.

 

Asynchron (JSON)
onClick: function(rank) {
    console.log("ad " + rank + " clicked");
}
Synchron (URL-Parameter)
// nicht verfügbar
onResize

Wird automatisch aufgerufen, sobald sich die Größe des Werbemittels ändert.

Als Parameter wird die neue Größe des Werbemittels übergeben.

 

Asynchron (JSON)
onResize: function(width, height) {
    console.log("new size is " + width + "x" + height);
}
Synchron (URL-Parameter)
// nicht verfügbar

Verwandte Themen