Open Measurement w pakiecie IMA SDK

Pakiet IMA SDK dla Android obejmuje pakiet Open Measurement SDK, standard branżowy opracowany przez Interactive Advertising Bureau (IAB), który umożliwia pomiar widoczności i weryfikacji przez firmę zewnętrzną. Jeśli używasz pakietu IMA SDK na potrzebyAndroid, uwzględniony w nim pakiet OM SDK automatycznie analizuje tag <AdVerifications> w tagach reklam VAST i wysyła dane o widoczności do wybranych dostawców usług pomiarowych za pomocą interfejsu OMID API.Pakiet IMA SDK obsługuje rozszerzenia OM SDK w wersji, rozszerzenia GAM Ad Verifications w VAST 2+ i węzeł Ad Verifications w VAST 4 lub nowszej.Aby korzystać z technologii Open Measurement, pamiętaj o tych kwestiach:

  • Aby korzystać z Open Measurement, musisz mieć pakiet IMA SDK w wersji3.11.0 lub nowszej na Androida. Przykład w tym przewodniku jest jednak zaprojektowany z myślą o najnowszej wersji pakietu SDK i zawiera interfejsy API wprowadzone w wersji 3.16.5.

  • Jeśli korzystasz z VAST w wersji 4.1 lub nowszej, musisz w nim skonfigurować ruch <AdVerifications> zgodnie ze specyfikacją VAST 4.1. W przeciwnym razie należy zastosować parametr <Extension type="AdVerifications">.

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

Wymagania wstępne

Testowanie

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

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

Rejestrowanie elementów zasłaniających nakładkę z elementami sterującymi filmu

Elementy sterujące odtwarzaniem filmu, takie jak przyciski pauzy czy paski postępu, dostarczają użytkownikom ważnych informacji o odtwarzaniu i wykonywanych przez nich działaniach. Na urządzeniach mobilnych nieprecyzyjne kliknięcia i oczekiwania użytkowników sprawiają, że powszechną praktyką jest renderowanie dużych, łatwych do dotyku elementów sterujących elementami multimedialnymi. Te elementy sterujące zwykle zanikają po dotknięciu użytkownika i są niewidoczne przez większość czasu odtwarzania.

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

Większość wydawców, którzy korzystają z pakietu IMA SDK, wdraża te ustawienia, dodając nad kontenerem wyświetlania reklamy widok, który jest w większości przezroczysty. Zwykle elementy sterujące są elementami podrzędnymi tego widoku, które całkowicie zakrywają podstawowy odtwarzacz. Ta przezroczysta nakładka służy do rejestrowania zdarzeń kliknięcia, a następnie do renderowania elementów sterujących po kliknięciu.

Przy obliczaniu widoczności reklamy za pomocą pakietu Open Measurement SDK wszystkie wyświetlenia nakładające się na element multimedialny są uznawane za elementy zakłócające, co zmniejsza współczynnik widoczności. Jeśli nad całym kontenerem reklamy displayowej znajduje się przezroczysta nakładka ekranu, zasoby reklamowe mogą zostać zadeklarowane jako całkowicie niewidoczne.

Pakiet Open Measurement SDK udostępnia elementy sterujące wideo uważane za „przyjazne” przeszkody, które mają kluczowe znaczenie dla wygody użytkowników. Po zarejestrowaniu ich jako przyjaznej kontroli są wykluczane z pomiaru widoczności reklam.

Dzięki obsłudze IAB i MRC pakiet IMA SDK wprowadza interfejs API do rejestrowania nakładek za pomocą pakietu Open Measurement SDK. Muszą to być w pełni przezroczyste nakładki lub małe przyciski. Żadne inne wyświetlenia niezwiązane z elementami sterującymi filmu nie mogą być rejestrowane.

zarejestruj się NIE rejestruj
  • Przezroczysta nakładka pozwalająca rejestrować kliknięcia użytkowników
  • Przyciski przejściowe
    • Wstrzymaj
    • Odtwórz
    • Pełny ekran
    • Przesyłanie/AirPlay
    • Zwiń
    • Postęp/Przewijanie
    • Inne działania związane z odtwarzaniem
  • znaki wodne,
  • Wyskakujące okienka
  • Okna
  • Przyciski trwałe
  • Inne zasłaniające widoki

Ten przykładowy kod pokazuje, jak zarejestrować nakładki elementów sterujących wideo w kontenerze reklamy displayowej: 

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 to zrobisz, możesz usunąć te zakłócenia, wywołując tę metodę: 

displayContainer.unregisterAllFriendlyObstructions();