Offene Messung aktivieren

Plattform auswählen: HTML5 Android iOS

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 Sichtbarkeitsmessung und ‑überprüfung durch Drittanbieter zu ermöglichen. Wenn Sie das IMA SDK für Android verwenden, parst das enthaltene OM SDK automatisch das <AdVerifications> Tag in VAST-Anzeigen-Tags und sendet Sichtbarkeitsdaten über die OMID API an die angegebenen Messanbieter. Das IMA SDK unterstützt das OM SDK v1.4, GAM-Erweiterungen für die Anzeigenüberprüfung in VAST 2+ und den Knoten „AdVerifications“ in VAST 4+.Beachten Sie Folgendes, wenn Sie Open Measurement nutzen möchten:

  • Sie benötigen Version 3.11.0 oder höher des IMA SDK für Android. Das Beispiel in dieser Anleitung ist jedoch für die neueste Version des SDK konzipiert und enthält APIs, die in Version 3.16.5 eingeführt wurden.

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

  • Decken Sie den AdDisplayContainer nicht mit Overlays (transparent oder undurchsichtig) ab, da diese vom OM SDK als Hindernisse gekennzeichnet werden und die Sichtbarkeit verringern.

Vorbereitung

Test

Wenn Sie Open Measurement mit dem IMA SDK testen möchten, verwenden Sie eine Version des IMA SDK, die das OM SDK unterstützt, sowie ein Test-Anzeigen-Tag.

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

Overlays für Videosteuerung als Hindernisse registrieren

Videosteuerungselemente wie Pausenschaltflächen oder Fortschrittsbalken liefern Nutzern wichtige Informationen zur Wiedergabe und ermöglichen ihnen, die Wiedergabe zu steuern. Auf Mobilgeräten ist es üblich, große, touchfreundliche Steuerungselemente über dem Media-Element zu rendern, da Nutzer häufig ungenau tippen und bestimmte Erwartungen an die Bedienung haben. Diese Steuerungselemente werden in der Regel nach einem Tippen des Nutzers ein- und ausgeblendet und sind während der Wiedergabe die meiste Zeit nicht sichtbar.

Ein Beispiel für das Überlagern von Videosteuerungselementen finden Sie in der folgenden Abbildung, die die Steuerungselemente in der YouTube App zeigt:

Beispielbild für das Mess-Overlay öffnen

Wenn das IMA SDK verwendet wird, implementieren die meisten Publisher diese Steuerungselemente, indem sie eine Ansicht über dem Anzeigen-Container hinzufügen, die größtenteils transparent ist. In der Regel sind die Steuerungselemente untergeordnete Elemente dieser Ansicht, die den zugrunde liegenden Videoplayer vollständig verdecken. Dieses transparente Overlay wird verwendet, um Tippereignisse zu erfassen und die Steuerungselemente dann für Nutzer zu rendern, wenn sie darauf tippen.

Bei der Berechnung der Sichtbarkeit von Anzeigen mit dem Open Measurement SDK werden alle Ansichten, die das Media-Element überlagern, als Hindernisse betrachtet und verringern die Sichtbarkeitsrate. Wenn sich ein transparentes Tipp-Overlay über dem gesamten Anzeigen-Container befindet, kann das Inventar als vollständig nicht sichtbar deklariert werden.

Das Open Measurement SDK sieht vor, dass Videosteuerungselemente als „freundliche“ Hindernisse betrachtet werden, die für die Nutzererfahrung unerlässlich sind. Sobald diese Steuerungselemente als freundlich registriert wurden, werden sie bei der Messung der Sichtbarkeit von Anzeigen nicht berücksichtigt.

Mit Unterstützung von IAB und MRC führt das IMA SDK eine API ein, mit der diese Overlays beim Open Measurement SDK registriert werden können. Diese Steuerungselemente müssen vollständig transparente Overlays oder kleine Schaltflächen sein. Alle anderen Ansichten, die nicht mit der Videosteuerung zusammenhängen, dürfen nicht registriert werden.

Registrieren Nicht registrieren
  • Transparentes Overlay zum Erfassen von Nutzertipps
  • Temporäre Schaltflächen
    • Pausieren
    • Play
    • Vollbild
    • Übertragen/AirPlay
    • Minimieren
    • Fortschritt/Suchen
    • Andere für die Wiedergabe relevante Aktionen
  • Wasserzeichen
  • Pop-ups
  • Dialogfelder
  • Nicht temporäre Schaltflächen
  • Andere verdeckende Ansichten

Der folgende Beispielcode zeigt, wie Sie Overlays für Videosteuerungselemente im Anzeigen-Container registrieren: 

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 diese Hindernisse nicht mehr benötigen, können Sie sie mit der folgenden Methode entfernen: 

displayContainer.unregisterAllFriendlyObstructions();