Open Measurement w pakiecie IMA SDK

Pakiet IMA SDK na Androida 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. Gdy używasz pakietu IMA SDK na Androida, zawarty w nim 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.Pakiet IMA SDK obsługuje OM SDK w wersji 1.4, rozszerzenia GAM AdVerifications w VAST 2+ i węzeł AdVerifications w VAST 4+.Aby korzystać z Open Measurement, pamiętaj o tych kwestiach:

  • Aby korzystać z Open Measurement, musisz mieć pakiet IMA SDK na Androida w wersji 3.11.0 lub nowszej. Przykład w tym przewodniku jest jednak przeznaczony do najnowszej wersji pakietu SDK i zawiera interfejsy API wprowadzone w wersji 3.16.5.

  • Jeśli używasz VAST 4.1 lub nowszego, reklamy muszą być skonfigurowane pod kątem trafikowania pliku <AdVerifications> w tagu VAST zgodnie ze specyfikacją VAST 4.1. W przeciwnym razie użyj tagu <Extension type="AdVerifications">.

  • Nie zasłaniaj elementu AdDisplayContainer żadnymi nakładkami (przezroczystymi lub nieprzezroczystymi), ponieważ zostaną one oznaczone jako przeszkody przez pakiet OM SDK i zmniejszą widoczność.

Wymagania wstępne

Testowanie

Aby przetestować Open Measurement za pomocą pakietu IMA SDK, użyj jednej z wymaganych wersji pakietu SDK wymienionego powyżej wraz z testowym tagiem reklamy.

W odpowiedzi VAST powinna pojawić się wartość <AdVerifications> zwrócona.

Rejestrowanie przeszkód w nakładce z elementami sterującymi filmu

Elementy sterujące filmem, takie jak przyciski wstrzymywania czy paski postępu, dostarczają użytkownikom istotnych informacji i możliwości. Ze względu na nieprecyzyjne dotykanie i oczekiwania użytkowników na urządzeniach mobilnych stało się powszechną praktyką renderowanie dużych elementów sterujących dotykowych nad elementem multimedialnym. Te elementy sterujące zwykle pojawiają się i znikają po kliknięciu przez użytkownika i nie są widoczne przez większość czasu odtwarzania.

Oto przykład elementów sterujących odtwarzaniem filmu renderowanych przez aplikację YouTube:

Większość wydawców wdraża te ustawienia w ramach pakietu IMA SDK, dodając nad kontenerem reklamy displayowej widok, który jest w większości przezroczysty. Zazwyczaj elementy sterujące są elementami podrzędnymi tego widoku, który całkowicie zasłania odtwarzacz wideo. Ten przezroczysty element nakładany na ekran służy do rejestrowania zdarzeń dotyku, a następnie do renderowania elementów sterujących dla użytkowników po ich kliknięciu.

Podczas obliczania widoczności reklamy za pomocą pakietu Open Measurement SDK wszystkie widoki nakładające się na element multimedialny są uznawane za przeszkody i obniżają współczynnik widoczności. Jeśli przezroczysta nakładka kliknięcia znajduje się nad całym kontenerem wyświetlania reklamy, zasoby reklamowe mogą zostać zadeklarowane jako całkowicie niewidoczne.

Pakiet Open Measurement SDK sprawia, że elementy sterujące wideo są uznawane za „przyjazne” przeszkody, które są istotne dla wygody użytkownika. Po zarejestrowaniu jako przyjazne te opcje są wykluczane z pomiaru widoczności reklam.

Dzięki współpracy z IAB i MRC pakiet IMA SDK wprowadza interfejs API do rejestrowania tych nakładek za pomocą pakietu Open Measurement SDK. Muszą to być w pełni przezroczyste nakładki lub małe przyciski. Inne widoki, które nie są związane z elementami sterowania filmem, nie mogą być rejestrowane.

Zarejestruj się NIE REJESTRUJ
  • Przezroczysta nakładka, która rejestruje kliknięcia przez użytkownika
  • Przyciski tymczasowe
    • Wstrzymaj
    • Odtwórz
    • Pełny ekran
    • Cast/AirPlay
    • Zwiń
    • Postęp / Przewijanie
    • Inne działania związane z odtwarzaniem
  • znaki wodne,
  • Wyskakujące okienka
  • Okna
  • Przyciski trwałe
  • Inne widoki zasłaniające

Poniższy przykładowy kod pokazuje, jak zarejestrować nakładki elementów sterujących filmem w kontenerze wyświetlania reklamy: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

Gdy skończysz, możesz usunąć te blokady, wykonując te czynności: 

displayContainer.unregisterAllFriendlyObstructions();