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 Sichtbarkeits- und Überprüfungsmessung 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 Daten zur Sichtbarkeit über die OMID API an die angegebenen Messanbieter. Das IMA SDK unterstützt OM SDK v1.6, GAM AdVerifications-Erweiterungen in VAST 2+ und den AdVerifications-Knoten in VAST 4+.Beachten Sie Folgendes, um Open Measurement zu nutzen:

  • Wenn Sie Open Measurement verwenden möchten, benötigen Sie 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.

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

  • Decken Sie die 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 von IMA, die das OM SDK unterstützt, sowie ein Test-Anzeigen-Tag.

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

Registrieren von Hindernissen für das Overlay mit den Videosteuerelementen

Videosteuerelemente wie Pausenschaltflächen oder Fortschrittsbalken liefern Nutzern wichtige Informationen zur Wiedergabe und ermöglichen ihnen, Aktionen auszuführen. Auf Mobilgeräten ist es aufgrund von ungenauen Tippvorgängen und Nutzererwartungen üblich, große, berührungsfreundliche Steuerelemente über dem Media-Element zu rendern. Diese Steuerelemente werden in der Regel durch Tippen des Nutzers ein- und ausgeblendet und sind während der Wiedergabe nicht sichtbar.

Ein Beispiel für das Überlagern von Videosteuerelementen finden Sie im folgenden Bild zu den Steuerelementen der YouTube App:

Beispielbild für das Messungs-Overlay öffnen

Bei Verwendung des IMA SDK implementieren die meisten Publisher diese Steuerelemente, indem sie einen größtenteils transparenten View über dem Container für die Anzeigendarstellung hinzufügen. 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 und die Steuerelemente dann für Nutzer zu rendern, wenn sie darauf tippen.

Wenn die Anzeigensichtbarkeit mit dem Open Measurement SDK berechnet wird, gelten alle Ansichten, die das Media-Element überlagern, als Hindernisse und verringern die Sichtbarkeitsrate. Wenn sich ein transparentes Tipp-Overlay über dem gesamten Anzeigencontainer befindet, kann das Inventar als nicht sichtbar deklariert werden.

Das Open Measurement SDK berücksichtigt Videosteuerelemente als „freundliche“ Hindernisse, die für die Nutzerfreundlichkeit unerlässlich sind. Sobald sie als „freundlich“ registriert sind, werden sie nicht mehr in die Messung der Anzeigen-Sichtbarkeit einbezogen.

Mit der Unterstützung von IAB und MRC wird im IMA SDK eine API zum Registrieren dieser Overlays mit dem Open Measurement SDK eingeführt. Diese Steuerelemente müssen vollständig transparente Overlays oder kleine Schaltflächen sein. Alle anderen Aufrufe, die nicht mit der Videosteuerung zusammenhängen, dürfen nicht registriert werden.

DO register NICHT registrieren
  • Transparentes Overlay zum Erfassen von Nutzer-Taps
  • Temporäre Schaltflächen
    • Pausieren
    • Play
    • Vollbild
    • Cast/AirPlay
    • Minimieren
    • Fortschritt/Suchen
    • Andere für die Wiedergabe relevante Aktionen
  • Wasserzeichen
  • Pop-ups
  • Dialogfelder
  • Nicht vorübergehende Schaltflächen
  • Andere verdeckende Ansichten

Im folgenden Beispielcode wird gezeigt, wie Video-Steuerelement-Overlays im Anzeigecontainer registriert werden: 

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

Wenn Sie fertig sind, können Sie diese Hindernisse mit der folgenden Methode entfernen: 

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