Beiträge in diesem Abschnitt

Weitere anzeigen

Placement-Switch: Werbeflächen abhängig vom Seitenpfad ausliefern (Special Ad Unit)

Support
  • Aktualisiert
Folgen

Der Placement-Switch ermöglicht das Ausliefern unterschiedlicher Werbeflächen je nach Seitenpfad, z. B. für spezielle Content-Bereiche ohne Rotationswerbung. Über ein JSON-Regelwerk im

Anwendungsfall

Mit dem Placement-Switch können Sie auf einer Seitenposition unterschiedliche Werbeflächen ausliefern, abhängig vom Pfad der aufgerufenen Seite.

Typischer Einsatz ist eine Special Ad Unit: Bestimmte Bereiche Ihrer Webseite (z. B. bezahlte Content-Hubs unter /contentpfad) sollen standardmäßig keine Rotationswerbung erhalten, sondern nur explizit gebuchte Kampagnen. Dazu legen Sie für diese Bereiche eine separate Werbefläche an, auf der ausschließlich die gewünschten Kampagnen gebucht werden. Der Placement-Switch sorgt dafür, dass auf den betroffenen Pfaden automatisch diese Werbefläche geladen wird, während auf allen anderen Seiten weiterhin die normale Rotationsfläche ausgeliefert wird.

Einbau

Ersetzen Sie den bestehenden AdSpirit-Tag an der gewünschten Position durch:

<ins data-asm-placement-switch='[
 {"pid": 123, "path": "/contentpfad"},
 {"pid": 456}
]'
 data-asm-host="name.adspirit.de"
 data-asm-cdn="cdn.adspirit.de"
 style="display:inline-block; width:970px; height:250px;"></ins>

<script src="https://cdn.adspirit.de/adplacementswitch.min.js" async></script>

Ersetzen Sie name.adspirit.de durch Ihren Delivery-Host und die pid-Werte durch Ihre Werbeflächen-IDs.

Regelwerk (data-asm-placement-switch)

Das Attribut enthält ein JSON-Array mit Regeln. Wichtig: Es muss valides JSON sein – Eigenschaftsnamen in doppelten Anführungszeichen, das Attribut selbst daher in einfachen Anführungszeichen

Eigenschaft

Pflicht

Bedeutung

pid

pid 

ID der Werbefläche.

path

optional

Pfad-Präfix, das mit location.pathname verglichen wird.

Die Regeln werden von oben nach unten geprüft. Der erste Treffer gewinnt.

  • Hat eine Regel ein path, matcht sie, wenn der Seitenpfad mit diesem Wert beginnt (Präfix-Vergleich an Pfadsegment-Grenzen).
  • Beispiel: "path": "/contentpfad" matcht /contentpfad/artikel-xyz, aber nicht /contentpfad-spezial.
  • Hat eine Regel keinen path, matcht sie immer (Fallback). Deshalb sollte sie als letzter Eintrag stehen.
  • Spezifischere Pfade müssen vor allgemeineren stehen, z. B. /contentpfad/artikel-xyz vor /contentpfad.
  • Matcht keine Regel, wird keine Werbefläche ausgeliefert.

Attribute des <ins>-Elements

AttributPflichtBedeutung
data-asm-placement-switchJaRegelwerk als JSON-Array.
data-asm-hostBedingtIhr Delivery-Host. Kann entfallen, wenn das Script direkt von Ihrem Delivery-Host geladen wird. Dann wird der Host automatisch aus der Script-URL übernommen.
data-asm-cdnNeinCDN-Host. Standardmäßig wird der Host verwendet, von dem das Script geladen wurde, ansonsten data-asm-host.
styleEmpfohlenBreite und Höhe der Werbefläche wie beim normalen Async-Tag.

Funktionsweise

Nach der Auswahl der passenden Regel wird das <ins>-Element in einen regulären asynchronen AdSpirit-Tag umgewandelt. Anschließend wird die Auslieferung wie gewohnt über adasync.min.js gestartet.

Alle bekannten Funktionen bleiben unverändert erhalten, unter anderem:

  • Consent-/TCF-Handling
  • Viewability
  • Responsive Auslieferung

Empfehlung für Kampagnen auf exakten Artikelpfaden

Statt für jeden gebuchten Artikel einen eigenen Array-Eintrag zu pflegen, empfehlen wir, eine Special-Werbefläche für den gesamten Bereich (z. B. /contentpfad) anzulegen. Die Einschränkung auf den exakten Artikel erfolgt anschließend über das URL- oder Referrer-Targeting der jeweiligen Kampagne.

Dadurch muss der Tag auf der Webseite bei neuen Buchungen nicht angepasst werden.

Hinweise

  • Der Pfad wird einmalig beim Seitenaufruf ausgewertet.
  • Bei Single-Page-Applications (SPA) mit clientseitigem Routing kann die Verarbeitung neuer <ins>-Elemente nach einem Routenwechsel über window.asm_placement_switch.initi() erneut angestoßen werden.
  • Zusätzliche Auslieferungsparameter können über data-asm-params am <ins>-Element gesetzt werden. Diese bleiben erhalten und werden an den generierten pid-Parameter angehängt.
  • Ungültiges JSON im Attribut verhindert die Auslieferung der Werbefläche. In der Browser-Konsole erscheint in diesem Fall ein Hinweis mit dem Präfix AdSpirit Switch.