Włączanie pomiaru otwartego

Wybierz platformę: HTML5 Android iOS

Pakiet IMA SDK na HTML5 zawiera pakiet OM SDK (Open Measurement SDK), czyli standard branżowy opracowany przez Interactive Advertising Bureau (IAB), który umożliwia pomiar widoczności i weryfikacji przez firmy zewnętrzne. Gdy używasz pakietu IMA SDK na HTML5, dołączony pakiet OM SDK automatycznie analizuje tag <AdVerifications> w tagach reklam VAST i wysyła dane o widoczności do określonych dostawców usług pomiaru za pomocą interfejsu OMID API. Opcjonalnie możesz ustawić reguły trybu dostępu dla każdego żądania, aby kontrolować, do jakich treści skrypt weryfikacyjny może mieć dostęp.

Pakiet IMA SDK obsługuje pakiet OM SDK w wersji 1.6.

Wymagania wstępne

  • Jeśli używasz VAST w wersji 4.1 lub nowszej, reklamy muszą być skonfigurowane tak, aby dostarczać weryfikację za pomocą <AdVerifications>. Jeśli używasz wcześniejszych wersji VAST, reklamy muszą używać <Extension type="AdVerifications">.

  • Jeśli reklamy są wyświetlane w Ad Managerze, skonfiguruj dostawcę usług pomiaru widoczności w sieci Ad Managera i przypisz go do elementu zamówienia. Więcej informacji znajdziesz w artykule Konfigurowanie dostawcy usług pomiaru widoczności w sieci Ad Managera.

Tryby dostępu

Pakiet OM SDK obsługuje uruchamianie skryptów weryfikacyjnych w 4 różnych trybach dostępu, które określają, do jakich treści skrypt weryfikacyjny może mieć dostęp:

  • FULL: skrypt weryfikacyjny ma bezpośredni dostęp do kreacji i strony wydawcy.

  • CREATIVE: skrypt weryfikacyjny i kreacja są odizolowane od strony wydawcy. Skrypt ma jednak bezpośredni dostęp do kreacji.

  • LIMITED: skrypt weryfikacyjny jest odizolowany i nie ma dostępu do kreacji ani strony wydawcy. Nie może też bezpośrednio potwierdzić, w jakiej domenie wydawcy się znajduje.

Niektórzy dostawcy usług pomiaru widoczności mogą nie obsługiwać wszystkich trybów dostępu. Skontaktuj się z dostawcami usług pomiaru widoczności, aby sprawdzić, które tryby są obsługiwane. Wcześniej pakiet IMA obsługiwał tryb dostępu DOMAIN, który teraz domyślnie jest ustawiony na tryb LIMITED.

Ustawianie reguł trybu dostępu dla żądania

Reguły trybu dostępu muszą być ustawione na poziomie AdsRequest. Aby ustawić różne tryby dostępu dla różnych dostawców skryptów weryfikacyjnych , przekaż słownik, który mapuje każdego OmidVerificationVendor na jeden z wymienionych powyżej trybów dostępu. Pole OmidVerificationVendor.OTHER służy do ustawiania domyślnego trybu dostępu dla wszystkich dostawców, którzy nie są wyraźnie uwzględnieni w słowniku. Jeśli nie określono żadnych reguł trybu dostępu, skrypty weryfikacyjne są uruchamiane w trybie dostępu LIMITED dla dostawców.

Zobacz ten przykład, który ustawia GOOGLE na google.ima.OmidAccessMode.FULL. W przypadku wszystkich innych dostawców, w tym tych wymienionych w OmidVerificationVendor, domyślnie stosowane jest ustawienie OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.LIMITED;

Aby wdrożyć tryb dostępu CREATIVE, musisz wykonać oba te kroki:

  1. Odizoluj odtwarzacz wideo w bezpiecznym elemencie iframe, który jest odizolowany od reszty witryny.

  2. Ustaw OmidAccessMode dla partnera w zakresie widoczności na FULL.