Open Measurement

Pakiet IMA SDK dla HTML5 zawiera pakiet Open Measurement (OM) SDK, czyli standard branżowy opracowany przez Interactive Advertising Bureau (IAB) w celu umożliwienia pomiaru widoczności i weryfikacji przez zewnętrznych dostawców. W przypadku korzystania z pakietu IMA SDK dla HTML5 dołączony pakiet OM SDK automatycznie analizuje tag <AdVerifications> w tagach reklamy VAST i wysyła dane widoczności do określonych dostawców usług pomiarowych za pomocą interfejsu OMID API. Opcjonalnie możesz ustawić reguły dotyczące trybu dostępu dla każdego żądania, aby kontrolować, do jakich treści ma dostęp skrypt weryfikujący.

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

Wymagania wstępne

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

  • Jeśli Twoje reklamy są kierowane przez Ad Managera, skonfiguruj dostawcę usług pomiaru widoczności w 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 weryfikacji w 4 różnych trybach dostępu, które określają, do czego skrypt weryfikacji może mieć dostęp:

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

  • CREATIVE: skrypt weryfikacyjny i element kreacji są umieszczone w piaskownicy na stronie wydawcy. Skrypt ma jednak bezpośredni dostęp do kreacji.

  • DOMAIN: skrypt weryfikacyjny jest w piaskownicy i nie ma dostępu do kreacji ani strony wydawcy. Skrypt jest jednak wczytywany w taki sposób, że może bezpośrednio potwierdzić, w której domenie wydawcy się znajduje.

  • LIMITED: skrypt weryfikacyjny działa w piaskownicy i nie ma dostępu do kreacji ani strony wydawcy, więc nie może bezpośrednio potwierdzić, w której domenie wydawcy się znajduje.

Niektórzy dostawcy usług pomiaru widoczności mogą nie obsługiwać wszystkich trybów dostępu. Aby sprawdzić, które tryby są obsługiwane, skontaktuj się z dostawcami danych o widoczności.

Ustawianie reguł trybu dostępu dla żądania

Reguły dotyczące trybu dostępu muszą być ustawione na poziomie AdsRequest. Aby ustawić różne tryby dostępu dla różnych dostawców skryptów weryfikacyjnych, prześlij słownik, który mapuje każdy parametr 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 zostaną określone żadne reguły dotyczące trybu dostępu, skrypty weryfikacyjne będą działać w trybie dostępu LIMITED dla dostawców.

W tym przykładzie wartość GOOGLE jest ustawiona na google.ima.OmidAccessMode.FULL. W przypadku wszystkich innych dostawców, w tym tych wymienionych w OmidVerificationVendor, domyślnie jest używane ustawienie 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ć te 2 czynności:

  1. Umieść odtwarzacz wideo w piaskownicy w zabezpieczonym elemencie iframe, oddzielonym od reszty witryny.

  2. Ustaw wartość parametru OmidAccessMode dla partnera w zakresie danych o widoczności na FULL.