Open Measurement w pakiecie IMA SDK

Pakiet IMA SDK na Androida zawiera pakiet SDK Open Measurement (OM), 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, 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.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.

  • Reklamy muszą być skonfigurowane tak, aby w swoim tagu VAST kierowały na parametr <AdVerifications> zgodnie ze specyfikacją VAST 4.1, jeśli używasz wersji VAST 4.1 lub nowszej. W przeciwnym razie należy użyć parametru <Extension type="AdVerifications">.

  • Nie zasłaniaj AdDisplayContainer żadnymi nakładkami (przezroczystymi ani nieprzezroczystymi), ponieważ OM SDK uzna je za przeszkody 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 powinien zostać zwrócony parametr <AdVerifications>.

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.

Poniżej znajdziesz przykład elementów sterujących filmem renderowanych przez aplikację YouTube:

Korzystając z pakietu IMA SDK, większość wydawców wdraża te elementy sterujące, dodając widok nad kontenerem wyświetlania reklam, 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 umożliwia traktowanie elementów sterujących filmem jako „przyjaznych” przeszkód, które są niezbędne dla wygody użytkownika. Gdy zostaną zarejestrowane jako zgodne, 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. Te elementy muszą być w pełni przezroczystymi nakładkami lub małymi przyciskami. Inne widoki, które nie są związane z elementami sterowania filmem, nie mogą być rejestrowane.

DO register NIE REJESTRUJ
  • Przezroczysta nakładka do rejestrowania kliknięć użytkownika
  • Przyciski przejściowe
    • 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 nieprzelotne
  • 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();