Renderowanie reklamy

Gdy aukcja z użyciem Protected Audience API zwróci kandydaturę, może ona zostać zwracany jako nieprzezroczysty numer URN, używany do renderowania reklamy w iframe lub FencedFrameConfig, który służy do renderowania reklamy w chronionej ramce.

W tym przewodniku wyjaśniono, czym jest ramka ogrodzona i do czego jest potrzebna. sposób renderowania reklamy za pomocą obu tych metod. Więcej informacji na temat więcej informacji znajdziesz w tym przewodniku lub w ofercie pakietowej.

Czym są ogrodzone ramki?

Chroniona ramka (<fencedframe>) to element HTML dla umieszczonej treści. podobnie jak iframe. W przeciwieństwie do elementów iframe ogrodzona ramka ogranicza komunikację. z kontekstem wektora dystrybucyjnego, aby umożliwić ramce dostęp do danych z innych witryn bez udostępniając je wraz z kontekstem umieszczania. Podobnie wszystkie dane własne w sekcji kontekstu wektora dystrybucyjnego nie można udostępnić ramce chronionej.

Na przykład załóżmy, że news.example (kontekst wektora dystrybucyjnego) umieszcza reklamę z shoes.example w ogrodzonej ramce. news.example nie może wydobyć danych z: reklama shoes.example i shoes.example nie mogą uczyć się danych własnych z news.example

Jak działają ramki ogrodowe?

Ramki chronione używają do nawigacji obiektu FencedFrameConfig. Ten obiekt może w wynikach z aukcji z Protected Audience API. Następnie obiekt config jest ustawiany jako atrybut config na ogrodzonej ramce. To się różni od iframe gdzie adres URL lub nieprzezroczysty numer URN jest przypisany do atrybutu src. Obiekt FencedFrameConfig ma tylko do odczytu właściwość url; jednak w bieżących przypadkach użycia trzeba ukryć rzeczywisty URL zasobu wewnętrznego, ta właściwość zwraca ciąg nieprzezroczysty podczas odczytu.

Ramka chroniona nie może komunikować się z elementem umieszczanym za pomocą postMessage. Ramka ogrodzona może jednak korzystać z elementów postMessage z elementami iframe wewnątrz z zabezpieczoną ramką.

Chronione ramki będą odizolowane od wydawcy na inne sposoby. Wydawca DOM nie ma dostępu do DOM wewnątrz ogrodzonej ramki, nie może uzyskać dostępu do DOM wydawcy. Atrybuty takie jak name, które mogą mogą mieć dowolną wartość i być obserwowane przez wydawcę. Nie są dostępne w ramki.

Chronione ramki zachowują się jak kontekst przeglądania najwyższego poziomu (np. przeglądarka ). Chociaż ramka chroniona w niektórych przypadkach użycia (takich jak opaque-ads) mogą zawierać dane z różnych witryn (np. dane o grupie zainteresowań interfejsu Protected Audience API), ramka nie ma dostępu do niepartycjonowanej pamięci lub plików cookie. Ogrodzony: opaque-ads Ramka może uzyskać dostęp do unikalnej partycji pamięci masowej i plików cookie opartej na liczbie jednorazowej.

Cechy płodnych ramek są szczegółowo opisane w tym artykule.

Renderowanie reklamy w ogrodzonej ramce

Wartość FencedFrameConfig jest zwracana z aukcji z Protected Audience API, pod warunkiem że że parametr resolveToConfig metody AuctionConfig ma wartość prawda:

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

Po uzyskaniu konfiguracji możesz ją przypisać do ramki ogrodzonej config. do przejścia między ramką do zasobu reprezentowanego przez konfigurację. Wcześniejsze wersje Chrome nie obsługują właściwości resolveToConfig, więc nadal musi potwierdzić, że obietnica została rozwiązana na FencedFrameConfig nawigacja:

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

Renderowanie reklamy w elemencie iframe

Jeśli zasada AuctionConfig nie ma jawnie ustawionej wartości resolveToConfig lub jest ona ustawiona Wartość false (fałsz), runAdAuction() zwraca nieprzezroczysty numer URN. Ten numer URN można ustawić jako src aplikacji iframe, aby wyświetlić reklamę.