Włączanie pomiaru otwartego

Wybierz platformę: HTML5 Android iOS

Pakiet IMA SDK dla HTML5 zawiera pakiet Open Measurement (OM) SDK, który jest standardem branżowym opracowanym przez Interactive Advertising Bureau (IAB) i umożliwia pomiar widoczności oraz weryfikację przez firmy zewnętrzne. Jeśli korzystasz z pakietu IMA SDK dla 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 pomiarowych za pomocą interfejsu OMID API. Możesz opcjonalnie 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ły dane weryfikacyjne za pomocą elementu <AdVerifications>. Jeśli używasz poprzednich wersji VAST, reklamy muszą korzystać z <Extension type="AdVerifications">.

  • Jeśli Twoje reklamy są trafikowane przez Ad Managera, 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 czego 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ą umieszczone w piaskownicy na stronie wydawcy. Skrypt ma jednak bezpośredni dostęp do kreacji.

  • LIMITED: skrypt weryfikacyjny jest umieszczony w piaskownicy i nie ma dostępu do kreacji ani strony wydawcy, więc nie może 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 trybem 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żdy element 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 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 poniższy przykład, w którym parametr GOOGLE ma wartość google.ima.OmidAccessMode.FULL. Wszyscy pozostali dostawcy, w tym wymienieni w OmidVerificationVendor, domyślnie korzystają z ustawień 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ć obie te czynności:

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

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