Wie baust du einen Static Anzeigenblock ein?

Überblick

Mit einem Static Anzeigenblock bindest du Werbemittel mit einer festen Größe auf deiner Website ein. Die Anzeigen werden innerhalb eines iFrames geladen und an der Position ausgespielt, an der du den Einbindungscode platzierst.

Static Ads eignen sich besonders für klassische Desktop-Platzierungen mit festen Werbeformaten.

Wenn deine Website vollständig responsiv aufgebaut ist oder Anzeigen flexibel auf unterschiedlichen Bildschirmgrößen dargestellt werden sollen, empfehlen wir stattdessen die Verwendung von Responsive Ads.

Voraussetzungen

Bevor du einen Static Anzeigenblock einbindest, benötigst du:

• eine angelegte Website in deinem Publisher-Account

• einen Anzeigenblock

• ein passendes Anzeigenblock-Layout

Wichtig:

Im Layout des Anzeigenblocks muss die Art der Einbindung auf „Static Ads“ gesetzt sein.

So funktionieren Static Ads

Beim Laden deiner Website wird ein iFrame erzeugt, in dem die AdUp-Anzeigen ausgeliefert werden.

Größe, Anzahl und Design der Anzeigen kannst du im Anzeigenblock-Layout frei konfigurieren.

Der Anzeigenblock wird immer genau dort eingebunden, wo du den Einbindungscode oder den HTML-Container platzierst.

Einbindungsarten

Static Ads können auf zwei Arten eingebunden werden.

Asynchrone Einbindung (empfohlen)

Die asynchrone Einbindung ist die empfohlene Variante.

Dabei wird zunächst deine Website geladen. Anschließend lädt die AdUp JavaScript-API im Hintergrund die Anzeigen nach.

Das sorgt für:

• schnellere Ladezeiten

• bessere Performance

• weniger Blockierung beim Seitenaufbau

• mehr Flexibilität

Außerdem stehen dir zusätzliche Funktionen wie Callbacks und Events zur Verfügung.

Diese Einbindungsart eignet sich besonders, wenn du mehrere Anzeigenblöcke auf einer Seite verwendest.

Beispiel

<div id="adup1"></div><script>window.uAd_init = function () {    window.uAd.embed("adup1", {        placementkey: "DEIN_PLACEMENT_KEY"    });};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"));}<

<div id="adup1"></div><script>window.uAd_init = function () {    window.uAd.embed("adup1", {        placementkey: "DEIN_PLACEMENT_KEY"    });};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"));}<

<div id="adup1"></div><script>window.uAd_init = function () {    window.uAd.embed("adup1", {        placementkey: "DEIN_PLACEMENT_KEY"    });};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"));}<

Synchrone Einbindung

Bei der synchronen Einbindung wird ein Script direkt an der gewünschten Stelle der Website eingebunden.

Beim Seitenaufruf wird das Werbemittel sofort geladen.

Diese Variante eignet sich für einfache Integrationen, bietet jedoch weniger Konfigurationsmöglichkeiten als die asynchrone Einbindung.

Beispiel

<scriptsrc="https://s.d.adup-tech.com/ads/display.js?placementkey=DEIN_PLACEMENT_KEY"></script>

Erforderlicher Parameter

placementkey

Der placementkey identifiziert eindeutig den Anzeigenblock.

Beispiel (asynchron):

placementkey: "dd9e2c6e8a1ec4bc5d1561564fcf946d"

Beispiel (synchron):

placementkey=dd9e2c6e8a1ec4bc5d1561564fcf946d

Wichtige optionale Parameter

responsive

Aktiviert das Responsive-Feature für den Anzeigenblock.

responsive: true

lazy

Lädt Anzeigen erst, wenn sie in den sichtbaren Bereich der Seite gelangen.

Das verbessert Ladezeiten und verhindert unnötige Impressionen.

lazy: true

lazyoffset

Legt fest, wie viele Pixel vor dem sichtbaren Bereich Anzeigen bereits geladen werden.

Beispiel:

lazyoffset: 500

query

Filtert Anzeigen anhand bestimmter Keywords.

Einzelner Begriff:

query: "Mallorca"

Mehrere Begriffe:

query: ["Mallorca", "Flug"]

mincpc

Definiert den Mindestpreis pro Klick.

Je niedriger der Wert, desto größer ist in der Regel die Anzahl möglicher Kampagnen.

mincpc: 0.15

pageurl

Sollte gesetzt werden, wenn sich der Anzeigenblock innerhalb verschachtelter iFrames befindet.

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

skip

Überspringt eine definierte Anzahl bereits ausgelieferter Anzeigen.

Praktisch, wenn mehrere Anzeigenblöcke auf derselben Seite eingebunden sind.

skip: 2

colormode

Erzwingt einen bestimmten Farbmodus.

Verfügbare Werte:

• auto

• light

• dark

colormode: "light"

placeholdervalues

Übergibt Werte an Dynamic Ads.

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

flyin

Aktiviert Fly-In Ads.

flyin: true

Weitere Informationen findest du im Artikel zu Fly-In Ads.

adtest

Aktiviert den Testmodus.

Während des Testmodus werden weder Impressionen noch Klicks gezählt.

adtest: true

gdpr

Übergibt den GDPR-Status manuell.

Normalerweise werden diese Informationen automatisch über die TCF API ermittelt.

gdpr: true

gdpr_consent

Übergibt den IAB Consent String manuell.

gdpr_consent: "[CONSENT_STRING]"

Verfügbare Events (nur asynchron)

onAds

Wird ausgeführt, sobald Anzeigen erfolgreich geladen wurden.

onNoAds

Wird aufgerufen, wenn keine passende Anzeige ausgeliefert werden konnte.

onClick

Reagiert auf Klicks innerhalb des Anzeigenblocks.

onResize

Wird ausgelöst, wenn sich die Größe des Werbemittels ändert.

Best Practices

Verwende möglichst die asynchrone Einbindung

Sie verbessert die Performance deiner Website und bietet zusätzliche Funktionen wie Events und Callbacks.

Lazy Loading aktivieren

Aktiviere Lazy Loading, um Anzeigen erst dann zu laden, wenn sie tatsächlich sichtbar werden.

Das verbessert die Ladezeit und sorgt für eine präzisere Impressionserfassung.

Platzierungen eindeutig definieren

Verwende für jeden Anzeigenblock einen eigenen placementkey, damit Anzeigen korrekt ausgeliefert und ausgewertet werden können.

Anzeigen im Live-Betrieb testen

Nutze während der Implementierung den Parameter adtest, um Integrationen zu prüfen, ohne Impressionen oder Klicks zu erfassen.

Häufige Fehlerquellen

Falscher Placement Key

Ein ungültiger oder fehlender placementkey verhindert die Auslieferung von Anzeigen.

Mehrfaches Initialisieren

Ein Anzeigenblock sollte nur einmal initialisiert werden. Mehrfache Aufrufe können zu unerwartetem Verhalten führen.

Fehlende Datenschutzinformationen

Falls keine TCF API verfügbar ist, müssen gdpr und gdpr_consent manuell übergeben werden.

Synchrone Einbindung bei vielen Anzeigen

Werden mehrere Anzeigenblöcke synchron eingebunden, kann sich dies negativ auf die Ladezeit deiner Website auswirken.