Sichtbarkeit

In diesem Thema erfahren Sie mehr über die Viewability-Funktion des Brightcove-Players.

Einleitung

Die Sichtbarkeit eines Players ist von grundlegender Bedeutung für die Integration von Werbung sowie für einige UI-Behandlungen wie schwebende Player. In diesem Zusammenhang definieren wir "Sichtbarkeit" als den Prozentsatz eines Players, der zu einem bestimmten Zeitpunkt im Browserfenster sichtbar ist. Ein Player gilt als "sichtbar", wenn sich ein bestimmter Prozentsatz des Players im Ansichtsfenster befindet.

Brightcove Player 7 führt DOM-Ereignisse zur Nachverfolgung der Sichtbarkeit und einige nützliche Verhaltensweisen ein, die vom Sichtbarkeitsstatus des Players abhängen.

Player-Konfiguration

Die Sichtbarkeitsereignisse und das Verhalten des Players können in der JSON-Konfiguration des Players konfiguriert werden. Alle Konfigurationen sind unter der Eigenschaft Sichtbarkeit verfügbar.

Eigentum Beschreibung Typ Standardwert
viewability_threshold Eine Zahl zwischen 0 und, die den Teil des Spielers 1 darstellt, der sich im Viewport befinden muss, damit er als „sichtbar“ gilt. number 0.6
min_duration_for_viewable_impression Stellt die Anzahl der Millisekunden dar, die nach Beginn der Anzeigenwiedergabe gewartet werden soll, bevor auf eine sichtbare Impression getestet wird.

In der Standardeinstellung bedeutet dies, dass der Player nach 2 Sekunden Anzeigenwiedergabe meldet, ob die Anzeigenimpressionen anhand eines viewable-ad-impression Events sichtbar waren.		 number 2000
threshold_percentage_increment Das Ausmaß der Änderung der Sichtbarkeit, die zwischen den viewable-percent-change Ereignissen erforderlich ist.

Standardmäßig 5 bedeutet dieser Wert, dass viewable-percent-change Ereignisse nur ausgelöst werden, wenn sich die Sichtbarkeit des Spielers um 5% geändert hat (z. B. von 45% auf 50%).

Es wird empfohlen, diese Einstellung nicht weiter zu verfeinern, da dadurch eine Vielzahl von Ereignissen ausgelöst wird.		 number 5
delay_autoplay_if_not_viewable Interagiert nur mit Playern, die für Autoplay konfiguriert sind.

In true diesem Fall verzögert der Player seinen Wiedergabeversuch, bis der Player sichtbar ist.

In false diesem Fall versucht der Player die Wiedergabe unabhängig von seiner Sichtbarkeit. Dies ist das Standardverhalten eines Autoplay-Players..		 boolean false
delay_autoplay_on_mobile_only In true diesem Fall wird die verzögerte Autoplay-Funktion nur in mobilen Umgebungen (iOS oder Android) aktiviert.

HINWEIS: In diesem Fall werden Tablets als mobile Umgebungen betrachtet.		 boolean true
pause_when_not_viewable Wenn true, unterbricht der Player die Wiedergabe, wenn sie nicht sichtbar wird. Sobald der Player wieder sichtbar ist, wird die Wiedergabe fortgesetzt.

Wenn false, schaltet der Spieler nicht zwischen Pause und Spiel um viewable-change. Dies ist das Standardverhalten eines Spielers..		 boolean false

Beispiel

Hier ist das JSON für eine Playerkonfiguration, die die Anzeigefähigkeit einschließt:

{
  ... other properties ...
  "viewability": {
    "viewability_threshold": 0.3,
    "pause_when_not_viewable": true
  }
}

In diesem Beispiel wird die Wiedergabe angehalten, wenn weniger als 30 % des Players im Ansichtsfenster des Browsers zu sehen sind, weil der Benutzer den Player aus dem Sichtfeld herausrollt. Die Wiedergabe wird fortgesetzt, wenn der Player wieder sichtbar wird.

Viewability-Ereignisse

Die Nutzer können sich in drei neue Ereignisse einklinken, die sich auf die Sichtbarkeit beziehen.

  • viewable-change

    Dieses Ereignis wird ausgelöst, wenn der Player in einen sichtbaren Zustand übergeht oder diesen verlässt.

    Eigentum Typ Beschreibung
    viewable boolescher Wert Stellt dar, ob sich der Player in einem sichtbaren Zustand befindet oder nicht
    viewablePercent Zahl Stellt den Prozentsatz des Players dar, der sich derzeit im Ansichtsfenster befindet
    Beispiel 
    player.on('viewable-change', (e) => {
  if (e.viewable) {
    player.log('the player is viewable!');
  } else {
    player.log('the player is not viewable!');
  }
});

  • viewable-percent-change

    Dieses Ereignis wird ausgelöst, wenn sich der sichtbare Prozentsatz des Players ändert.

    Eigentum Typ Beschreibung
    viewable boolescher Wert Stellt dar, ob sich der Player in einem sichtbaren Zustand befindet oder nicht
    viewablePercent Zahl Stellt den Prozentsatz des Players dar, der sich derzeit im Ansichtsfenster befindet
    Beispiel 
    player.on('viewable-percent-change', (e) => {
  player.log(`the player is ${e.viewablePercent}% viewable!`);
});

  • viewable-ad-impression

    Dieses Ereignis wird ausgelöst, wenn eine sichtbare Anzeigenimpression gemessen wird. Sie wird nicht außerhalb des Kontextes der Anzeigenwiedergabe ausgelöst.

    Mit anderen Worten, sobald eine Anzeige gestartet und für die angegebene Anzahl von Millisekunden abgespielt wurde, min_duration_for_viewable_impression wobei der Player sichtbar ist, wird dieses Ereignis ausgelöst.

    Bei diesem Ereignis werden keine zusätzlichen Daten übermittelt.