Open Measurement

Pakiet IMA SDK dla HTML5 zawiera pakiet Open Measurement (OM) SDK – standard branżowy opracowany przez organizację Interactive Advertising Bureau (IAB) na potrzeby zewnętrznych usług pomiaru widoczności i weryfikacji. Jeśli używasz pakietu IMA SDK dla HTML5, dołączony OM 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. 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 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 weryfikacyjnych w 4 różnych trybach dostępu, które kontrolują dostęp skryptu weryfikacyjnego:

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

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

  • DOMAIN: skrypt weryfikacyjny znajduje się 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 znajduje się w piaskownicy, więc nie ma dostępu do kreacji ani strony wydawcy i nie może bezpośrednio potwierdzić, do jakiej domeny wydawcy należy.

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 trybu dostępu należy ustawić na poziomie StreamRequest. 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 zostali uwzględnieni w słowniku. Jeśli nie podasz żadnych reguł trybu dostępu, skrypty weryfikacyjne będą uruchamiane w trybie dostępu LIMITED dla dostawców.

W poniższym przykładzie ustaw GOOGLE jako google.ima.dai.api.OmidAccessMode.FULL. W przypadku wszystkich pozostałych dostawców, w tym tych wymienionych w OmidVerificationVendor, domyślnie obowiązują ustawienia opcji OmidVerificationVendor.OTHER.

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

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

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

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