AdUp Technology

Contact

+49 (0) 40 350 1698-199

Interested or any questions? Contact us!

© 2019 Axel Springer Teaser Ad GmbH

Static-Ads

Voraussetzung

Damit Sie AdUp Werbemittel auf Ihrer Webseite verwenden können, müssen Sie eine Seite, sowie ein entsprechenden Anzeigenblock in Ihrem Publisher-Account angelegt haben.

Mehr dazu finden Sie auf der Seite FAQ für Publisher.

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

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.

 

Erforderliche Parameter

Name

Beschreibung

Beispiel

placementkey

Der eindeutige Placement-Key ihres Anzeigenblocks.

Asynchron (programmatisch)

Synchron (URL-Parameter)

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)

Synchron (URL-Parameter)

 

Optionale Parameter

Name

Beschreibung

Beispiel

query

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

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)

Synchron (URL-Parameter)

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)

Synchron (URL-Parameter)

skip

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

Synchron (URL-Parameter)

Asynchron (programmatisch)

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)

Synchron (URL-Parameter)

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)

Synchron (URL-Parameter)

placeholdervalues

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

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)

Synchron (URL-Parameter)

adtest

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

 

Events / Callbacks

Name

Beschreibung

Beispiel

onClick

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

onResize

Wird automatisch aufgerufen wird, 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)

Synchron (URL-Parameter)

onAds

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

onNoAds

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

Asynchron (programmatisch)

Synchron (URL-Parameter)

 

Beispiele

Einfaches Beispiel für eine asynchrone Einbindung

Völlig ausreichend wenn der Einbindungscode an nur einer Stelle auf Ihrer Seite platziert werden soll.

Schritt 1

Erstellen Sie zuerst die <div>-Container mit eindeutigen IDs an den Stellen im <body>-Bereich Ihrer Webseite, an denen die Werbeanzeigen geladen werden sollen.

Schritt 2

Laden Sie unsere Auslieferungs-API und initialisieren Sie den Callback "window.uAd_init" einmalig am Ende Ihrer Seite. Innerhalb des Callbacks haben Sie nun die Möglichkeit die Werbemittel mit Hilfe der "window.uAd.embed" Methode und den gewünschten Parametern zu konfigurieren.

Erweitertes Beispiel für eine asynchrone Einbindung

Hierbei wird die Logik aus dem (obigen) einfachen Beispiel in eine Funktion mit dem Namen "adup" ausgelagert. Diese kümmert sich darum, dass unsere Auslieferungs-API nur einmalig geladen wird. Als Parameter wird eine Callback-Funktion mit Ihrer gewünschten Einbindungslogik übergeben, welche automatisch ausgeführt wird sobald die API bereit ist. Dies ist besonders dann Nützlich wenn Sie beispielsweise mehrere Werbemittel an unterschiedlichen Stellen auf Ihrer Seite verbaut haben und/oder Werbemittel erst während der Laufzeit auf ihrer Seite platziert werden sollen.

Schritt 1

Platzieren Sie folgenden Code in den <head>-Bereich Ihrer Webseite.

Schritt 2

Platzieren Sie die <div>-Container mit eindeutigen IDs an den Stellen im <body>-Bereich Ihrer Webseite, an denen die Werbeanzeigen geladen werden sollen und binden diese anschließend unter Verwendung der globalen Funktion "adup" und den gewünschten Parametern ein.

Beispiel für eine synchrone Einbindung

Fügen Sie die <script>-Tags mit den gewünschten URL-Parametern an der Stellen im <body>-Bereich auf Ihrer Seite ein, an der die Werbemittel angezeigt werden sollen.