Open Measurement im IMA DAI SDK

Das IMA SDK für Android enthält das Open Measurement (OM) SDK einem Branchenstandard, der von der Interactive Advertising Bureau (IAB), um Drittanbieter-Apps Sichtbarkeit und Überprüfung messen. Wenn Sie das IMA SDK für Android verwenden, wird das <AdVerifications>-Tag in VAST-Anzeigen-Tags automatisch vom enthaltenen OM SDK geparst und Sichtbarkeitsdaten werden über die OMID API an die angegebenen Analyseanbieter gesendet. Das IMA SDK unterstützt das OM SDK 1.4, GAM-AdVerifications-Erweiterungen in VAST 2 und höher sowie den AdVerifications-Knoten in VAST 4 und höher. Beachten Sie die folgenden Punkte, wenn Sie Open Measurement nutzen möchten:

  • Wenn Sie Open Measurement verwenden möchten, benötigen Sie das IMA SDK for Android Version 3.11.0 oder höher. Das Beispiel in diesem Leitfaden ist jedoch für die neueste Version des SDKs konzipiert und enthält APIs, die in Version 3.16.5 eingeführt wurden.

  • Anzeigen müssen so konfiguriert sein, dass sie <AdVerifications> in ihrem VAST-Tag gemäß der VAST 4.1-Spezifikation ausliefern, wenn VAST 4.1 oder höher verwendet wird. Andernfalls sollte <Extension type="AdVerifications"> verwendet werden.

  • AdDisplayContainer darf nicht mit Overlays verdeckt werden. (transparent oder opak), da diese vom OM als Hindernisse SDK verwenden und die Sichtbarkeit verringern.

Vorbereitung

Test

Wenn Sie Open Measurement mit dem IMA SDK testen möchten, verwenden Sie eine der erforderlichen Versionen von das oben genannte SDK zusammen mit einem Testanzeigen-Tag verwenden.

Die <AdVerifications> sollte in Ihrer VAST-Antwort zurückgegeben werden.

Overlay-Hindernisse der Videosteuerelemente registrieren

Videosteuerungen wie Pause-Schaltflächen oder Fortschrittsbalken bieten Nutzern wichtige Informationen zur Wiedergabe und Aktionen. Auf Mobilgeräten: ungenaues Tippen und haben die Erwartungen der Nutzer zur Standardpraxis gemacht, große, berührungsfreundliche für das Medienelement. Diese Steuerelemente werden in der Regel und werden die meiste Zeit der Videowiedergabe nicht angezeigt.

Hier sehen Sie ein Beispiel für Videosteuerelemente, die von der YouTube App gerendert werden:

Bei Verwendung des IMA SDK implementieren die meisten Publisher diese Steuerelemente, indem sie eine Ansicht über dem Container für die Anzeigenauslieferung, die größtenteils transparent ist. Normalerweise sind die Steuerelemente untergeordnete Elemente dieser Ansicht, die den zugrunde liegenden Videoplayer vollständig verdecken. Dieses transparente Overlay wird verwendet, um Tippereignisse zu erfassen, die Steuerelemente für Nutzer rendern, wenn sie angetippt werden.

Wenn die Sichtbarkeit von Anzeigen über das Open Measurement SDK berechnet wird, werden alle Ansichten, die das Medienelement überlagern, als Hindernisse betrachtet und verringern die Sichtbarkeitsrate. Falls sich ein transparentes Tipp-Overlay über dem gesamten Anzeigencontainer haben, kann Inventar deklariert werden. vollständig unsichtbar.

Das Open Measurement SDK sieht vor, dass Videokontrollelemente als „freundliche“ Hindernisse betrachtet werden, die für die Nutzerfreundlichkeit unerlässlich sind. Einmal als freundlich registriert, werden diese Einstellungen von der Anzeigensichtbarkeit ausgeschlossen zu messen.

Dank IAB- und MRC-Unterstützung wird mit dem IMA SDK eine API zur Registrierung dieser Daten eingeführt. Overlays mit dem Open Measurement SDK verwenden. Diese Steuerelemente müssen vollständig transparente Overlays oder kleine Schaltflächen sein. Alle anderen Ansichten, die nicht mit den Videosteuerelementen in Verbindung stehen, müssen nicht registriert sein.

DO registrieren NICHT registrieren
  • Transparentes Overlay zum Erfassen von Nutzertippen
  • Vorübergehende Schaltflächen
    • Pausieren
    • Wiedergeben
    • Vollbild
    • Cast/AirPlay
    • Minimieren
    • Fortschritt/Spule
    • Andere für die Wiedergabe relevante Aktionen
  • Wasserzeichen
  • Pop-ups
  • Dialogfelder
  • Dauerhafte Schaltflächen
  • Andere verdeckende Ansichten

Im folgenden Codebeispiel wird gezeigt, wie Overlays für Videosteuerungen im Anzeigendisplaycontainer registriert werden: 

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

Wenn Sie die störenden Elemente nicht mehr benötigen, können Sie sie mithilfe der Methode folgende Methode verwenden: 

displayContainer.unregisterAllFriendlyObstructions();