Messung im IMA SDK öffnen

Das IMA SDK für Android enthält das Open Measurement (OM) SDK, einen Branchenstandard, der vom Interactive Advertising Bureau (IAB) entwickelt wurde, um die Sichtbarkeit und Überprüfung durch Drittanbieter zu ermöglichen. 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 mindestens Version 3.11.0 des IMA SDK für Android. 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.

  • Du solltest AdDisplayContainer nicht mit Overlays (transparent oder undurchsichtig) abdecken, da diese vom OM SDK als Hindernisse gekennzeichnet werden und die Sichtbarkeit verringert wird.

Vorbereitung

Test

Wenn Sie Open Measurement mit dem IMA SDK testen möchten, verwenden Sie eine der oben genannten erforderlichen SDK-Versionen zusammen mit einem Test-Anzeigen-Tag.

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

Sichtbehinderungen durch eingeblendete Videosteuerelemente registrieren

Videosteuerelemente wie Pausenschaltflächen oder Fortschrittsbalken enthalten wichtige Informationen zur Wiedergabe und Aktionen für die Nutzer. Auf Mobilgeräten sind ungenaue Tippaktionen und die Erwartungen der Nutzer dazu geführt, dass große, berührungsfreundliche Steuerelemente für das Medienelement üblich sind. Diese Steuerelemente werden in der Regel beim Tippen des Nutzers ein- und ausgeblendet und sind die meiste Zeit der Wiedergabedauer nicht sichtbar.

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

Bei Verwendung des IMA SDK implementieren die meisten Publisher diese Steuerelemente, indem sie über dem Anzeigendisplaycontainer einen weitgehend transparenten Ansicht hinzufügen. Normalerweise sind die Steuerelemente untergeordnete Elemente dieser Ansicht, die den zugrunde liegenden Videoplayer vollständig verdecken. Dieses transparente Overlay wird verwendet, um Tipp-Ereignisse zu erfassen und die Steuerelemente dann für Nutzer zu rendern, wenn sie darauf tippen.

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. Wenn ein transparentes Tipp-Overlay über dem gesamten Anzeigendisplay-Container liegt, kann das Inventar als vollständig nicht sichtbar deklariert werden.

Das Open Measurement SDK sieht vor, dass Videokontrollelemente als „freundliche“ Hindernisse betrachtet werden, die für die Nutzerfreundlichkeit unerlässlich sind. Sobald diese Steuerelemente als nutzerfreundlich registriert sind, werden sie bei der Messung der Anzeigensichtbarkeit ausgeschlossen.

Mit der IAB- und MRC-Unterstützung wird mit dem IMA SDK eine API zum Registrieren dieser Overlays mit dem Open Measurement SDK eingeführt. Dabei muss es sich um vollständig transparente Overlays oder kleine Schaltflächen handeln. Alle anderen Aufrufe, die nicht mit den Videosteuerungen zusammenhängen, dürfen nicht erfasst werden.

DO registrieren NICHT registrieren
  • Transparentes Overlay zum Erfassen von Nutzertippen
  • Vorübergehende Schaltflächen
    • Pausieren
    • Wiedergeben
    • Vollbild
    • Streamen/AirPlay
    • Minimieren
    • Fortschritt/Suchen
    • 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 mit der folgenden Methode entfernen:

displayContainer.unregisterAllFriendlyObstructions();