Open Measurement

Pakiet IMA SDK dla HTML5 zawiera pakiet SDK Open Measurement (OM), standard branżowy opracowany przez Interactive Advertising Bureau (IAB), który umożliwia pomiar widoczności i weryfikacji przez firmę zewnętrzną. Jeśli korzystasz z pakietu IMA SDK na potrzeby HTML5, dołączony pakiet OMID SDK automatycznie analizuje tag <AdVerifications> w tagach reklam VAST i wysyła dane o widoczności do określonych dostawców usług pomiarowych za pomocą interfejsu OMID API. Dla każdego żądania możesz opcjonalnie ustawić reguły trybu dostępu, aby kontrolować, do jakiej treści ma dostęp skrypt weryfikacyjny.

Pakiet IMA SDK obsługuje pakiet Open Measurement SDK w wersji1.4.

Wymagania wstępne

  • Jeśli korzystasz z VAST 4.1 lub nowszego, musisz skonfigurować reklamy tak, aby dostarczały weryfikację za pomocą metody <AdVerifications>. Jeśli używasz poprzednich wersji VAST, reklamy muszą używać parametru <Extension type="AdVerifications">.

  • Jeśli reklamy są trafikowane przez Ad Managera, skonfiguruj dostawcę usług pomiaru widoczności dla swojej 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ą zakres dostępu skryptu weryfikacyjnego:

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

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

  • DOMAIN: skrypt weryfikacyjny znajduje się w piaskownicy i nie ma dostępu do kreacji lub strony wydawcy. Skrypt jest jednak wczytywany w taki sposób, że może bezpośrednio sprawdzić, do jakiej domeny wydawcy należy.

  • LIMITED: skrypt weryfikacyjny działa w piaskownicy i nie ma dostępu do kreacji ani strony wydawcy. Nie może też bezpośrednio potwierdzić, do której domeny wydawcy należy dana domena.

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.

Ustawianie reguł trybu dostępu dla żądania

Reguły trybu dostępu należy ustawić 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żdy element OmidVerificationVendor na jeden z trybów dostępu wymienionych powyżej. Pole OmidVerificationVendor.OTHER służy do ustawiania domyślnego trybu dostępu dla wszystkich dostawców, których nie ma wyraźnie w słowniku. Jeśli nie określono żadnych reguł trybu dostępu, skrypty weryfikacyjne uruchamiane są w przypadku dostawców w trybie dostępu LIMITED.

Poniżej znajdziesz przykład ustawienia GOOGLE na google.ima.OmidAccessMode.FULL. W przypadku wszystkich innych dostawców, w tym tych wymienionych w OmidVerificationVendor, domyślna wartość to OmidVerificationVendor.OTHER.

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

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

  1. Umieść odtwarzacz w piaskownicy w bezpiecznym elemencie iframe, odizolowanym od reszty witryny.

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