Open Measurement w pakiecie IMA SDK

Pakiet IMA SDK na iOS zawiera pakiet Open Measurement (OM) SDK – standard branżowy opracowany przez organizację Interactive Advertising Bureau (IAB) w celu umożliwienia pomiarów widoczności i weryfikacji za pomocą usług firm zewnętrznych. Gdy używasz pakietu IMA SDK na iOS, 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 pakiet OM SDK w wersji 1.4, rozszerzenia GAM AdVerifications w VAST 2+ i węzeł AdVerifications w VAST 4+. Aby korzystać z otwartego pomiaru, pamiętaj o tych kwestiach:

  • Aby korzystać z Open Measurement, musisz mieć pakiet IMA SDK w wersji 3.9.0 lub nowszej na iOS.

  • 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 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 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.

Poniżej znajdziesz przykład elementów sterujących filmem 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.

W przypadku obliczania widoczności reklam za pomocą pakietu Open Measurement SDK wszystkie wyświetlenia nakładające się na element multimedialny są uznawane za przeszkody i obniżają współczynnik widoczności. W sytuacji, gdy przezroczysta nakładka do kliknięcia znajduje się nad całym kontenerem reklam, zasoby reklamowe mogą zostać uznane za 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 tych ustawień jako elementów niestandardowych są one 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: 

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"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];