Open Measurement w pakiecie IMA DAI SDK

Pakiet IMA SDK na Androida zawiera Pakiet Open Measurement SDK, standard branżowy opracowany przez Interactive Advertising Bureau (IAB), aby umożliwić zewnętrzne kampanie reklamowe pomiaru widoczności i weryfikacji. Jeśli korzystasz z pakietu IMA SDK do Android – dołączony pakiet OM SDK automatycznie analizuje <AdVerifications> w tagach reklam VAST i wysyła dane o widoczności do wymienionych dostawców usług pomiarowych za pomocą interfejsu OMID API. Pakiet IMA SDK obsługuje pakiet OM SDK. wersji 1.4, rozszerzenia GAM Ad Verification w VAST 2 i nowszych, i węzła AdVerifys w VAST 4 lub nowszej.Aby korzystać z Open Measurement, pamiętaj o następujących kwestiach:

  • Aby korzystać z Open Measurement, musisz mieć wersję 3.11.0 lub niż pakiet IMA SDK na Androida. 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 pod kątem trafikowania pliku <AdVerifications> w formacie VAST zgodnie z Specyfikacja VAST 4.1 jeśli używasz VAST 4.1 lub nowszego, w przeciwnym razie, <Extension type="AdVerifications"> należy użyć funkcji.

  • 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. Na komórkach nieprecyzyjne kliknięcia dlatego powszechną praktyką jest renderowanie dużych, przyjaznych dla dotyku reklam. 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. Zwykle to elementy podrzędne tego widoku, które całkowicie zasłaniają odtwarzacza wideo. Ta przezroczysta nakładka jest używana do rejestrowania zdarzeń dotknięcia, renderuje elementy sterujące po dotknięciu.

Przy obliczaniu widoczności reklam za pomocą pakietu Open Measurement SDK uwzględniane są wszystkie wyświetlenia nałożone na element multimedialny są uznawane za przeszkody i zmniejszają współczynnik widoczności. W przypadku, gdy nad cały kontener reklamy displayowej, zasoby reklamowe mogą być zadeklarowane 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. Jednorazowo są zarejestrowane jako przyjazne, te ustawienia są wykluczone z widoczności reklam pomiar skuteczności.

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 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 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();