Creatives mit SafeFrame rendern

Ab dem 24. Januar 2022 werden mit SafeFrames immer zufällig ausgewählte Subdomains verwendet, um SafeFrame-Inhalte für mehr Sicherheit noch besser zu isolieren. Die SafeFrame-Sicherheitseinstellung ist nicht mehr verfügbar.

Wenn Sie bisher die Einstellung „Fest“ genutzt haben, wird die SafeFrame-Sicherheitseinstellung aktualisiert.

SafeFrame ist ein API-fähiger iFrame, der einen einzelnen, einheitlichen Mechanismus für die Kommunikation zwischen Werbetreibenden- und Publisher-Content bereitstellt. Mit der SafeFrame-Technologie in Ad Manager sind transparente und komplexe Interaktionen zwischen den Seiteninhalten und den Anzeigen möglich. Dabei wird der externe Zugriff auf sensible Daten verhindert. Außerdem stehen dem Publisher mehr Steuerungsmöglichkeiten zur Verfügung, um zu bestimmen, welche Creatives mit dem SafeFrame-Container mit GPTs gerendert werden.

Gemäß den IAB-Standards müssen Publisher ihre Websites aktualisieren, damit Anzeigen in SafeFrame-Containern ausgeliefert werden. SafeFrame wird in Ad Manager unterstützt und ist standardmäßig aktiviert, wenn GPTs eingesetzt werden.

Um die Wahrscheinlichkeit zu minimieren, dass schädliche Creatives ausgeliefert werden, empfehlen wir, nach Möglichkeit SafeFrame in Verbindung mit dem HTML5-Attribut sandbox zu aktivieren, um eine Navigation auf der obersten Ebene zu verhindern. Weitere Informationen zum Attribut sandbox

Ausführliche Informationen, einschließlich der vollständigen SafeFrame-Spezifikation, finden Sie in der IAB-Dokumentation.

SafeFrame und Creative-Typen

SafeFrame ist je nach verwendeter Art von Display-Creative standardmäßig entweder aktiviert oder deaktiviert.

Wenn Sie SafeFrame für ein Creative aktivieren, das auf einer Seite ohne SafeFrame ausgeliefert werden soll, können Probleme beim Rendern des Creatives auftreten. Das Gleiche gilt für Creatives mit deaktiviertem SafeFrame auf Seiten mit SafeFrame. Daher ist es wichtig zu ermitteln, wo das Creative ausgeliefert werden soll, und SafeFrame entsprechend zu aktivieren bzw. zu deaktivieren.

• Benutzerdefinierte und Drittanbieter-Creatives: „In einem SafeFrame ausliefern“ ist standardmäßig aktiviert, wenn Sie ein neues Drittanbieter-Creative oder benutzerdefiniertes Creative hinzufügen.
• Standard-Creatives und Creatives vom Typ „Benutzerdefinierte Vorlage“: „In einem SafeFrame ausliefern“ ist standardmäßig deaktiviert, wenn Sie Standard-Creatives und Creatives vom Typ „Benutzerdefinierte Vorlage“ hinzufügen.

SafeFrame und das Google Publisher-Tag (GPT)

In Ad Manager lässt sich für die folgenden vier Creative- bzw. Creative-Vorlagentypen explizit steuern, ob das Creative in einem SafeFrame gerendert wird:

• Benutzerdefiniert
• Drittanbieter
• Vom System definierte Vorlage
• Benutzerdefinierte Vorlage

Klicken Sie das Kästchen In einem SafeFrame ausliefern an, wenn Sie ein neues Creative oder eine neue Creative-Vorlage der oben genannten Typen hinzufügen möchten.

Bevor Sie SafeFrame aktivieren, sollten Sie die Werbetreibenden oder Anbieter fragen, ob die Creatives, die Sie von ihnen erhalten, SafeFrame-kompatibel sind. Wenn Sie das Attribut sandbox verwenden, arbeiten Sie mit der Agentur oder dem Werbetreibenden zusammen, um sicherzustellen, dass die Landingpage nach einem Anzeigenklick nicht auf der aktuellen Seite, sondern auf einem neuen Tab geöffnet wird.

SafeFrame unterstützt die Creative-Vorschau nicht.

Mit der Google Publisher Tag API können Sie mit dem Parameter setForceSafeFrame erzwingen, dass eine bestimmte Anzeigenfläche oder alle Anzeigenflächen auf einer Seite mithilfe eines SafeFrame-Containers gerendert werden.

SafeFrame mit AMP-Seiten

Die SafeFrame API ist mit jeder nicht auf AMPHTML basierenden Anzeige kompatibel, die auf einer AMP-Seite mit AMP-Anzeigen-Tags von Ad Manager ausgeliefert wird.

Der SafeFrame-Container kann maximal auf die Größe des Darstellungsbereichs erweitert werden. SafeFrame unterstützt keine Größenanpassung der Anzeigenflächen innerhalb des Darstellungsbereichs auf AMP-Seiten. Daher wird eine Anfrage zum Ändern der Größe eines Creative nur verarbeitet, wenn sich die Anzeigenfläche außerhalb des Darstellungsbereichs befindet.

Bei AMP-Seiten werden Standard-HTML-Creatives unabhängig von Ihrer Auswahl immer im SafeFrame ausgeliefert. Ihr Creative-Code muss mit SafeFrame kompatibel sein.

AMPHTML-Anzeigen

AMPHTML-Anzeigen werden nicht in SafeFrames, sondern in Friendly iFrames ausgeliefert, da AMPHTML mehr Sicherheit bietet.

Wenn Sie auf Ihrer Website eine Content Security Policy (CSP) verwenden, gelten ihre Einschränkungen auch für AMPHTML-Anzeigen in Friendly iFrames. In diesem Fall müssen Sie googletag.pubads().setForceSafeFrame(true) aufrufen, bevor Anzeigenanfragen gesendet werden. So kann die Anzeige in einem domainübergreifenden iFrame ohne die Einschränkungen der CSP gerendert werden.

Funktionsweise von SafeFrame

Die GPT-SafeFrame-Integration umfasst die folgenden drei Teile:

1. Den SafeFrame-iFrame-Container, der bei der Auslieferung der Anzeige vom GPT erstellt wird
2. Den in das Creative eingefügten Code, der die externe SafeFrame API für das Creative bereitstellt und über postMessage mit der Hostseite kommuniziert
3. Den Code, der außerhalb des SafeFrame-iFrames ausgeführt wird und Teil des GPTs ist, das das andere Ende des postMessage-Kommunikationskanals darstellt. Dieser Code führt alle Maximierungs- und geometrischen Messungen in Bezug auf die Sichtbarkeit aus.

In Ad Manager werden Creatives unterstützt, in denen zur Interaktion mit Websites eine SafeFrame API verwendet wird, etwa zum Maximieren eines Anzeigenblocks (entweder als Push-down oder Overlay), wenn ein Nutzer auf eine Anzeige klickt. Allerdings müssen Sie Ihr Tag ändern, damit die Maximierung der Anzeigenflächen und eine Push-down- oder Overlay-Interaktion möglich ist. Hierzu wird die Funktion setSafeFrameConfig verwendet.

Für GPTs wird diese API-Implementierung nicht extern gehostet, weil das Rendern des SafeFrames von den GPTs übernommen wird. Sie können weiterhin die GPT API zum Einrichten Ihrer Anzeigen verwenden, ohne Ihre GPTs zu ändern.

Über GPTs wird die SafeFrame API eines externen Anbieters implementiert, damit Creatives mit der Website interagieren können.

Unterstützte SafeFrame-API-Methoden

Laden Sie die vollständige SafeFrame API-Spezifikation herunter.

$sf.ext.register
$sf.ext.supports
$sf.ext.geom
$sf.ext.status
$sf.ext.inViewPercentage

/* supports expansion in both push and overlay modes;
not supported for fluid-sized native ads */
$sf.ext.expand

Nicht unterstützte oder teilweise unterstützte API-Methoden

• $sf.ext.cookie wird nicht unterstützt, da wir Creatives nicht den Zugriff auf Publisher-Cookies erlauben.
• $sf.ext.meta wird nicht für vom Publisher definierte Objekte unterstützt und ist auf folgende systemdefinierte Objekte beschränkt:
  • {String} sf_ver: Die Stringdarstellung der aktuellen Version von SafeFrame.
  • {Number} ck_on: Anhand dieses Strings sehen Sie, ob im Browser Cookies aktiviert sind. Mögliche Werte sind 1 (wahr) und 0 (falsch).

Rich Media und Sichtbarkeit mit SafeFrame

Mit SafeFrame hat der Publisher mehr Kontrolle, weil zwischen Anzeigen- und Publisher-Content nur Interaktionen möglich sind, die über die in der API verfügbaren Methoden ausgeführt werden können. Die Technologie standardisiert Rich Media-Formate, sodass Creatives, in denen die API eingesetzt wird, in jedem Netzwerk ausgeliefert werden können, das SafeFrame unterstützt.

Sichtbarkeit

Die von SafeFrame bereitgestellte API kann zur Berechnung der Sichtbarkeit verwendet werden. SafeFrame 1.0 erstellt zwar nicht direkt Berichte mit Messwerten zur Sichtbarkeit, aber die API bietet Zugriff auf Creative-Informationen, mit denen der Werbetreibende feststellen kann, ob der SafeFrame-Container sichtbar ist oder nicht.

Über die API sind geometrische Dimensionen verfügbar sowie die Position des SafeFrame-Containers und seines Contents im Verhältnis zum Browser- oder Anwendungsfenster und zu den Bildschirmgrenzen. Informationen zur Dauer können abgerufen werden, indem ein Listener registriert wird, um festzustellen, wie lange die Anzeige sichtbar ist.

Active View, eine von Google bereitgestellte Lösung für sichtbare Impressionen, ist nicht Teil der Spezifikation zur SafeFrame-Sichtbarkeit. Active View funktioniert auch weiterhin, ohne dass Änderungen notwendig sind.

Google Publisher Console verwenden

Mit der Google Publisher Console können Sie feststellen, ob in einer Anzeigenfläche SafeFrame verwendet wird.