Visibilité

Dans cette rubrique, vous découvrirez la fonction de visualisation du lecteur Brightcove.

Introduction

La visibilité d'un lecteur est d'une importance fondamentale pour les intégrations publicitaires ainsi que pour certains traitements de l'interface utilisateur tels que les lecteurs flottants. Dans ce contexte, nous définissons la "visualisation" comme le pourcentage d'un lecteur visible dans la fenêtre du navigateur à un moment donné. Un lecteur est considéré comme "visible" si un certain pourcentage du lecteur se trouve dans la fenêtre de visualisation.

Brightcove Player 7 introduit des événements DOM de suivi de la visualisation et des comportements utiles qui dépendent de l'état de visualisation du lecteur.

Configuration du lecteur

Les événements et le comportement de visualisation du lecteur peuvent être configurés dans la configuration JSON de votre lecteur. Toutes les configurations sont disponibles sous la propriété de visualisation.

Propriété Description Type Défaut
viewability_threshold Nombre compris entre 0 et 1 représentant la partie du joueur qui doit figurer dans la fenêtre d'affichage pour qu'elle soit considérée comme « visible ». number 0.6
min_duration_for_viewable_impression Représente le nombre de millisecondes à attendre après le début de la lecture de la publicité avant de tester une impression visible.

Par défaut, cela signifie que le lecteur indiquera si l'impression publicitaire a été visible à l'aide d'un viewable-ad-impression événement après 2 secondes de diffusion de l'annonce.		 number 2000
threshold_percentage_increment La quantité de changement de visibilité requise entre les viewable-percent-change événements.

Par défaut, cette valeur 5 signifie que les viewable-percent-change événements ne se déclencheront que si la visibilité du joueur a changé de 5 % (par exemple, de 45 % à 50 %).

Il est recommandé de ne pas aller plus loin dans la granularité, car cela déclencherait un grand nombre d'événements...		 number 5
delay_autoplay_if_not_viewable N'interagit qu'avec les joueurs configurés pour la lecture automatique.

Si true, le lecteur retarde sa tentative de lecture jusqu'à ce qu'il soit visible.

Si false, le lecteur essaiera de le lire, quel que soit son état de visibilité. C'est le comportement par défaut d'un lecteur autoplay...		 boolean false
delay_autoplay_on_mobile_only Dans true ce cas, la fonction de lecture automatique différée ne sera activée que sur les environnements mobiles (iOS ou Android).

REMARQUE: Dans ce cas, les tablettes sont considérées comme des environnements mobiles .		 boolean true
pause_when_not_viewable Si true, le lecteur interrompt la lecture si elle n'est plus visible. Lorsque le lecteur redevient visible, la lecture reprend.

Si false, le joueur n'active pas la pause ou la lecture viewable-change. C'est le comportement par défaut d'un lecteur...		 boolean false

Exemple

Voici le JSON d'une configuration de lecteur qui inclut la visibilité :

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

Dans cet exemple, la lecture s'interrompt lorsque moins de 30 % du lecteur est visible dans la fenêtre du navigateur, en raison du défilement du lecteur par l'utilisateur. La lecture reprend lorsque le lecteur redevient visible.

Événements relatifs à la visibilité

Les utilisateurs peuvent participer à trois nouveaux événements liés à la visibilité.

  • viewable-change

    Cet événement se déclenche lorsque le lecteur passe à un état visible ou en sort.

    Propriété Type Description
    viewable booléen Représente le fait que le lecteur est ou non dans un état visible
    viewablePercent numéro Représente le pourcentage du lecteur qui se trouve actuellement dans la fenêtre de visualisation
    Exemple 
    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

    Cet événement se déclenche lorsque le pourcentage visible du lecteur change.

    Propriété Type Description
    viewable booléen Représente le fait que le lecteur est ou non dans un état visible
    viewablePercent numéro Représente le pourcentage du lecteur qui se trouve actuellement dans la fenêtre de visualisation
    Exemple 
    player.on('viewable-percent-change', (e) => {
  player.log(`the player is ${e.viewablePercent}% viewable!`);
});

  • viewable-ad-impression

    Cet événement se déclenche lorsqu'une impression publicitaire visible est mesurée. Il ne se déclenche pas en dehors du contexte de la lecture d'une publicité.

    En d'autres termes, une fois qu'une annonce a été lancée et diffusée pendant le nombre de millisecondes correspondant min_duration_for_viewable_impression à la visibilité du joueur, cet événement se déclenche.

    Aucune donnée supplémentaire n'est transmise avec cet événement.