Włączanie pomiaru otwartego

Wybierz platformę: HTML5 Android iOS

Pakiet IMA SDK na Androida zawiera pakiet Open Measurement (OM) SDK, standard branżowy opracowany przez Interactive Advertising Bureau (IAB), który umożliwia pomiar widoczności i weryfikacji przez podmioty zewnętrzne. Jeśli używasz pakietu IMA SDK na Androida, dołączony do niego pakiet OM SDK automatycznie analizuje tag <AdVerifications> w tagach reklam VAST i wysyła dane o widoczności do określonych dostawców pomiarów za pomocą interfejsu OMID API. Pakiet IMA SDK obsługuje pakiet OM SDK w wersji 1.4, rozszerzenia GAM AdVerifications w VAST 2+ oraz 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ładowy kod w tym przewodniku jest jednak przeznaczony dla najnowszej wersji pakietu SDK i zawiera interfejsy API wprowadzone w wersji 3.16.5.

  • Reklamy muszą być skonfigurowane tak, aby w pliku VAST przekazywać parametr <AdVerifications> zgodnie ze specyfikacją VAST 4.1, jeśli używana jest wersja VAST 4.1 lub nowsza. W przeciwnym razie należy użyć parametru <Extension type="AdVerifications">.

  • Nie zasłaniaj AdDisplayContainer żadnymi nakładkami (przezroczystymi ani nieprzezroczystymi), ponieważ OM SDK oznaczy je jako przeszkody i zmniejszy widoczność.

Wymagania wstępne

Testowanie

Aby przetestować Open Measurement za pomocą pakietu IMA SDK, użyj wersji IMA, która obsługuje pakiet OM SDK, oraz testowego tagu reklamy.

W odpowiedzi VAST powinien pojawić się komunikat <AdVerifications>.

Rejestrowanie przeszkód nakładki z elementami sterującymi wideo

Elementy sterujące odtwarzaniem, takie jak przyciski wstrzymywania czy paski postępu, dostarczają użytkownikom niezbędnych informacji i umożliwiają wykonywanie działań. Na urządzeniach mobilnych niedokładne kliknięcia i oczekiwania użytkowników sprawiły, że powszechną praktyką stało się renderowanie dużych, wygodnych w obsłudze elementów sterujących nad elementem multimedialnym. Te elementy sterujące zwykle pojawiają się i znikają po dotknięciu ekranu przez użytkownika i nie są widoczne przez większość czasu odtwarzania.

Przykład nakładania elementów sterujących wideo znajdziesz na tym obrazie w sekcji Elementy sterujące renderowania aplikacji YouTube:

Przykład nakładki pomiarowej

Większość wydawców korzystających z pakietu IMA SDK 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óre całkowicie zasłaniają odtwarzacz wideo. Ta przezroczysta nakładka służy do rejestrowania zdarzeń kliknięcia, a następnie do renderowania elementów sterujących użytkownikom po kliknięciu.

Gdy obliczana jest widoczność reklamy przy użyciu pakietu SDK Open Measurement, wszystkie widoki nakładające się na element multimedialny są traktowane jako 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ć uznane za całkowicie niewidoczne.

Pakiet Open Measurement SDK uwzględnia elementy sterujące wideo jako „przyjazne” przeszkody, które są niezbędne dla wygody użytkownika. Gdy te elementy sterujące zostaną zarejestrowane jako przyjazne, nie będą uwzględniane w pomiarach widoczności reklam.

Dzięki obsłudze IAB i MRC pakiet IMA SDK wprowadza interfejs API do rejestrowania tych nakładek w pakiecie Open Measurement SDK. Elementy sterujące muszą być w pełni przezroczystymi nakładkami lub małymi przyciskami. Nie należy rejestrować żadnych innych wyświetleń niezwiązanych z elementami sterującymi odtwarzaniem.

DO register NIE rejestruj
  • Przezroczysta nakładka do rejestrowania kliknięć użytkowników
  • Przyciski tymczasowe
    • Wstrzymaj
    • Odtwórz
    • Pełny ekran
    • Cast/AirPlay
    • Zwiń
    • Przewijanie
    • Inne działania związane z odtwarzaniem
  • Znaki wodne
  • Wyskakujące okienka
  • Okna
  • Przyciski nietrwałe
  • Inne widoki zasłaniające

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

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

OpenMeasurementSnippets.java

Gdy skończysz z nimi pracę, możesz je usunąć, wywołując tę metodę: 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java