Renderowanie kreacji za pomocą SafeFrame

Od 24 stycznia 2022 r. SafeFrame będzie zawsze korzystać z losowych subdomen. Zapewni to jeszcze lepsze odizolowanie zawartości SafeFrame i zagwarantuje większe bezpieczeństwo. Oznacza to, że ustawienie zabezpieczeń SafeFrame nie będzie już dostępne.

Jeśli wcześniej wybrano ustawienie „Stałe”, zabezpieczenia SafeFrame zostaną zaktualizowane.

SafeFrame to obsługujący interfejs API obiekt iframe, który zapewnia ujednolicony mechanizm komunikacji między treściami reklamodawcy i wydawcy. Technologia SafeFrame w usłudze Ad Manager umożliwia nawiązywanie przejrzystych i rozbudowanych interakcji między zawartością strony a reklamami, chroniąc jednocześnie poufne dane przed dostępem z zewnątrz i zapewniając ściślejszą kontrolę nad tym, które reklamy są wyświetlane przy użyciu kontenera SafeFrame z tagami GPT.

Zgodnie z wymaganiami standardów IAB wydawcy muszą zaktualizować strony internetowe w taki sposób, aby umożliwiały wyświetlanie reklam wewnątrz kontenerów SafeFrame. Jednak w usłudze Ad Manager technologia SafeFrame jest domyślnie włączona podczas korzystania z tagów GPT.

Aby zminimalizować szanse na wyświetlanie złośliwych kreacji, zalecamy, aby zawsze, gdy jest to możliwe, mieć włączoną funkcję SafeFrame w połączeniu z dostępnym w języku HTML5 atrybutem sandbox. Pozwoli to zapobiec nawigacji na najwyższym poziomie. Więcej informacji o atrybucie sandbox

Szczegółowe informacje, w tym pełną specyfikację SafeFrame, znajdziesz w dokumentacji IAB.

SafeFrame i typy kreacji

W zależności od typu kreacji displayowej technologia SafeFrame jest domyślnie włączona lub wyłączona.

Włączenie SafeFrame w przypadku kreacji, która ma się wyświetlać na stronie nieobsługującej tej technologii (lub odwrotnie), może spowodować problemy z renderowaniem kreacji. Dowiedz się, gdzie ma być wyświetlana dana kreacja, i odpowiednio skonfiguruj SafeFrame.

• Kreacje niestandardowe i kreacje firm zewnętrznych: wyświetlanie w SafeFrame jest domyślnie włączone, gdy dodasz nową kreację firmy zewnętrznej lub kreację niestandardową.
• Standardowe i niestandardowe szablony kreacji: wyświetlanie w SafeFrame jest domyślnie wyłączone zarówno w przypadku standardowych, jak i niestandardowych szablonów kreacji.

SafeFrame i tag wydawcy Google (GPT)

W usłudze Ad Manager możesz określić wprost, czy kreacja ma się wyświetlać przy użyciu SafeFrame w przypadku 4 typów kreacji:

• niestandardowej,
• kreacji firmy zewnętrznej,
• szablonów zdefiniowanych przez system,
• szablonów zdefiniowanych przez użytkownika.

Podczas dodawania nowej kreacji lub szablonu któregoś z tych typów zaznacz pole wyboru Wyświetlaj w SafeFrame.

Zanim włączysz funkcję SafeFrame, ustal w porozumieniu z reklamodawcami lub dostawcami kreacji, czy ich kreacje są z nią zgodne. Jeśli używasz atrybutu sandbox, uzgodnij z agencją lub reklamodawcą, że kliknięcia będą otwierać stronę docelową w nowej karcie, a nie powodować przejście z bieżącej strony.

SafeFrame nie obsługuje podglądu kreacji.

Parametr setForceSafeFrame w interfejsie API tagu wydawcy Google pozwala wymusić renderowanie reklam w dowolnym boksie reklamowym lub we wszystkich boksach na stronie przy użyciu kontenera SafeFrame.

SafeFrame na stronach AMP

Interfejs SafeFrame API jest zgodny ze wszystkimi reklamami innymi niż AMP HTML wyświetlanymi na stronach AMP przy użyciu tagów reklam AMP w usłudze Ad Manager.

Maksymalny rozmiar rozwinięcia kontenera SafeFrame jest ograniczony do rozmiaru widocznego obszaru. Element SafeFrame nie pozwala zmieniać rozmiaru boksów reklamowych w widocznym obszarze na stronach AMP. Jeśli kreacja wysyła żądanie rozwinięcia, jest ono uwzględniane tylko wtedy, gdy boks reklamowy znajduje się poza widocznym obszarem.

W przypadku stron AMP standardowe kreacje HTML zawsze wyświetlają się w SafeFrame niezależnie od wybranych opcji. Upewnij się, że kod kreacji jest zgodny z SafeFrame.

Reklamy AMP HTML

Reklamy AMP HTML nie wyświetlają się w elementach SafeFrame. Reklamy AMP HTML są bezpieczniejsze, dlatego domyślnie wyświetlają się w elementach friendly iframe.

Jeśli używasz w witrynie standardu Content Security Policy (CSP), jego ograniczenia odnoszą się również do reklam AMP HTML w elementach friendly iframe. W takim przypadku użyj wywołania googletag.pubads().setForceSafeFrame(true) przed wysłaniem jakichkolwiek żądań reklamy, aby umożliwić wyrenderowanie reklamy w międzydomenowym elemencie iframe bez uwzględnienia ograniczeń CSP.

Jak działa SafeFrame

Integracja SafeFrame z GPT obejmuje 3 elementy:

1. Kontener iframe SafeFrame utworzony przez GPT podczas wyświetlania reklamy.
2. Kod wstawiony do kreacji, który udostępnia jej (zewnętrzny) interfejs API SafeFrame i umożliwia komunikację ze stroną hosta za pomocą metody postMessage.
3. Kod działający poza elementem iframe SafeFrame jako część GPT na drugim końcu kanału komunikacji postMessage. Odpowiada on za rozwijanie kreacji i pomiar geometryczny na potrzeby widoczności.

Ad Manager obsługuje kreacje, które używają interfejsu API SafeFrame do interakcji ze stroną, np. do rozwijania boksu reklamowego (jako kreacja przesuwająca w dół lub nakładka), gdy użytkownik kliknie reklamę. Musisz jednak dostosować tag, aby za pomocą funkcji setSafeFrameConfig włączyć rozwijanie boksów reklamowych i umożliwić interakcję kreacji przesuwającej w dół lub nakładki.

GPT nie hostuje na zewnątrz tej implementacji interfejsu API, ponieważ obiekty SafeFrame są renderowane przez GPT. Możesz nadal konfigurować reklamy, korzystając z obecnego interfejsu API GPT, bez wprowadzania zmian w GPT.

Aby umożliwić kreacjom interakcję z witryną, GPT implementuje interfejs API SafeFrame firmy zewnętrznej.

Obsługiwane metody interfejsu SafeFrame API

Pobierz pełną specyfikację SafeFrame

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

/* obsługa rozwijania w trybie push i trybie nakładki;
metoda nieobsługiwana w przypadku reklam natywnych o rozmiarze elastycznym */
$sf.ext.expand

Nieobsługiwane lub częściowo obsługiwane metody interfejsu API

• Metoda $sf.ext.cookie nie jest obsługiwana, ponieważ nie pozwalamy kreacjom na dostęp do plików cookie wydawcy.
• Metoda $sf.ext.meta nie jest obsługiwana dla obiektów zdefiniowanych przez wydawcę. Jej obsługa jest ograniczona do następujących obiektów zdefiniowanych przez system:
  • {Ciąg} sf_ver – bieżąca wersja SafeFrame w postaci ciągu.
  • {Liczba} ck_on określa, czy pliki cookie są włączone w przeglądarce: 1 – tak, 0 – nie.

Rich media i widoczność w SafeFrame

SafeFrame daje wydawcy większą kontrolę, ograniczając interakcję między reklamami a treściami wydawcy do metod dostępnych w interfejsie API. Technologia ta standaryzuje formaty rich media, dzięki czemu kreacje używające interfejsu API mogą być wyświetlane w każdej sieci, która obsługuje SafeFrame.

Widoczność

Udostępniany przez SafeFrame interfejs API można wykorzystać do wyliczenia widoczności. Choć SafeFrame 1.0 nie podaje bezpośrednio danych widoczności, interfejs API umożliwia dostęp do informacji o kreacji, na których podstawie reklamodawca może określić, czy kontener SafeFrame jest widoczny.

Interfejs API udostępnia wymiary geometryczne oraz lokalizację kontenera SafeFrame i jego zawartości względem okna przeglądarki lub aplikacji i granic ekranu. Informacje o czasie trwania można ustalić, rejestrując detektor, by określić, jak długo reklama jest widoczna.

Widok aktywny, który jest dostarczanym przez Google rozwiązaniem dla widocznych wyświetleń, nie wchodzi w skład specyfikacji widoczności SafeFrame. Nie przewidujemy żadnych zmian w działaniu tej funkcji.

Korzystanie z Konsoli Google dla wydawcy

Jeśli chcesz sprawdzić, czy boks korzysta z SafeFrame, użyj Konsoli Google dla wydawcy.