Anzeige rendern

Wenn eine Protected Audience-Auktion einen Anzeigenkandidaten zurückgibt, wird als opaker URN zurückgegeben, die zum Rendern einer Anzeige in einem iframe oder einer FencedFrameConfig, mit dem die Anzeige in einem abgegrenzten Frame gerendert wird.

In diesem Leitfaden erfahren Sie, was ein Fechten ist und warum er benötigt wird. wie eine Anzeige mit beiden Methoden gerendert wird. Für einen tieferen Einblick in das Thema Fechten Frames erhalten, finden Sie in diesem Leitfaden oder im Angebot weitere Informationen.

Was sind Fenced Frames?

Ein Fenced Frame (<fencedframe>) ist ein HTML-Element für eingebettete Inhalte. ähnlich einem iframe. Im Gegensatz zu iframes schränkt ein Fencing Frame die Kommunikation ein. mit seinem Einbettungskontext, um dem Frame Zugriff auf websiteübergreifende Daten zu gewähren, mit dem Einbettungskontext teilen. Selbst erhobene Daten in der Der eingebettete Kontext kann nicht mit dem Fenced Frame geteilt werden.

Angenommen, news.example (der Einbettungskontext) bettet eine Anzeige aus shoes.example in einem abgegrenzten Frame. news.example kann keine Daten exfiltrieren aus der Anzeige „shoes.example“ und shoes.example kann keine selbst erhobenen Daten von news.example

Wie funktionieren Fenced Frames?

Bei abgegrenzten Frames wird zur Navigation das Objekt FencedFrameConfig verwendet. Dieses Objekt kann von einer Protected Audience-Auktion zurückgegeben werden. Dann wird das config-Objekt wie folgt festgelegt: Das Attribut config für das Fenced-Frame-Element Dies unterscheidet sich von einem iframe Dabei wird dem Attribut src eine URL oder eine opaker URN zugewiesen. Die Das FencedFrameConfig-Objekt hat ein schreibgeschütztes url-Attribut. Da die Für aktuelle Anwendungsfälle ist es erforderlich, dass die eigentliche URL der internen Ressource ausgeblendet ist. Diese Eigenschaft gibt beim Lesen die Zeichenfolge opaque zurück.

Ein Fenced Frame kann nicht über postMessage mit seinem Einbettungscode kommunizieren. Ein Fenced Frame kann jedoch postMessage mit iframes im Fenced Frame.

Fenced Frames werden auf andere Weise vom Publisher isoliert. Publisher keinen Zugriff auf das DOM innerhalb eines Fenced Frames und kann nicht auf das DOM des Publishers zugreifen. Außerdem können Sie Attribute wie name angeben, auf einen beliebigen Wert festgelegt und vom Publisher beobachtet werden, sind in Fencing nicht verfügbar. Frames.

Fenced Frames verhalten sich wie ein Browserkontext auf oberster Ebene, z. B. ) Obwohl in bestimmten Anwendungsfällen (z. B. opaque-ads) ein Fencing Frame verwendet wird websiteübergreifende Daten enthalten können (z. B. eine Interessengruppe der Protected Audience API), kann der Frame nicht auf nicht partitionierten Speicher oder Cookies zugreifen. Ein eingezäunter opaque-ads kann auf eine eindeutige, Nonce-basierte Cookie- und Speicherpartition zugreifen.

Die Eigenschaften von Fenced Frames werden in der Erläuterung näher erläutert.

Anzeige in einem abgegrenzten Frame rendern

Von einer Protected Audience-Auktion wird ein FencedFrameConfig zurückgegeben, sofern folgende Voraussetzungen erfüllt sind: der Parameter resolveToConfig von AuctionConfig auf „true“ gesetzt wurde:

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true
});

Nachdem Sie die Konfiguration abgerufen haben, können Sie sie dem config eines Fenced Frames zuweisen , um den Frame zu der Ressource zu leiten, die durch die Konfiguration dargestellt wird. Frühere Versionen von Chrome unterstützen das Attribut resolveToConfig nicht. Sie müssen also muss vor Beginn des Programms immer noch bestätigen, dass das Versprechen zu einem FencedFrameConfig aufgelöst wurde. Navigieren:

if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
  const frame = document.createElement('fencedframe');
  frame.config = frameConfig;
}

Anzeige in einem iFrame rendern

Wenn AuctionConfig nicht explizit resolveToConfig oder festgelegt ist auf „false“ setzen, gibt runAdAuction() eine opaker URN zurück. Diese URN kann als src von iframe zum Rendern der Anzeige.