google.
Une annonce peut faire partie d'une série d'annonces. Cet objet expose les métadonnées associées à cette série d'annonces, telles que le nombre d'annonces dans la série et sa position dans la série.
L'API getTotalAds contenue dans cet objet est souvent correcte, mais dans certains cas, elle représente la meilleure estimation du SDK. Pour en savoir plus, consultez la documentation de cette méthode.
Méthodes
getAdPosition
La fonction getAdPosition() renvoie le numéro
Renvoie la position de l'annonce.
- Renvoie
-
numberPosition de l'annonce dans la série d'annonces. La valeur renvoyée est basée sur un (par exemple, 1 sur 2, 2 sur 2, etc.).
getIsBumper
La fonction getIsBumper() renvoie une valeur booléenne
Renvoie la valeur "true" si l'annonce est une annonce bumper. Les annonces bumper sont de courtes annonces linéaires qui peuvent indiquer à l'utilisateur lorsqu'il démarre ou sort d'une coupure publicitaire.
- Renvoie
-
booleanIndique si l'annonce est une annonce bumper.
getMaxDuration
La fonction getMaxDuration() renvoie un nombre
Durée maximale du pod en secondes. Pour une durée inconnue, la valeur -1 est renvoyée.
- Renvoie
-
numberDurée maximale des annonces de cette série d'annonces en secondes.
getPodIndex
La fonction getPodIndex() renvoie le numéro
Côté client et vidéo à la demande pour l'insertion dynamique d'annonce: affiche l'index de la série d'annonces. Pour une série d'annonces vidéo pré-roll, renvoie 0. Pour les annonces vidéo mid-roll, renvoie 1, 2,..., Virginie du Pour une série d'annonces vidéo post-roll, la valeur renvoyée est -1. La valeur par défaut est 0 si cette annonce ne fait pas partie d'une série d'annonces ou si cette série d'annonces ne fait pas partie d'une playlist. Diffusion en direct pour l'insertion dynamique d'annonce: renvoie toujours -1.
- Renvoie
-
numberL'index de la série d'annonces dans la playlist d'annonces
getTimeOffset
La fonction getTimeOffset() renvoie la valeur
Renvoie le décalage temporel du contenu auquel la série d'annonces actuelle était planifiée. Pour les séries d'annonces dans des flux de vidéo à la demande avec des annonces insérées dynamiquement, l'heure du flux est renvoyée.
La valeur 0 est renvoyée pour la série d'annonces vidéo pré-roll. Pour les annonces vidéo mid-roll, l'heure programmée est renvoyée. Pour les annonces post-roll, -1 est renvoyé.
La valeur par défaut est 0 si cette annonce ne fait pas partie d'une série d'annonces ou si la série d'annonces ne fait pas partie d'une playlist d'annonces.
- Renvoie
-
numberDécalage horaire pour la série d'annonces actuelle.
getTotalAds
La fonction getTotalAds() renvoie le numéro
Nombre total d'annonces contenues dans cette série, y compris les bumpers. Les annonces bumper sont de courtes annonces linéaires qui peuvent indiquer à l'utilisateur quand une personne entre dans une coupure publicitaire ou la quitte.
La valeur par défaut est 1 si cette annonce ne fait pas partie d'une série d'annonces.
Dans certains cas, le SDK ne sait pas avec certitude combien d'annonces sont contenues dans cette série d'annonces. Ces scénarios incluent les séries d'annonces, qui sont plusieurs annonces dans un seul tag d'emplacement publicitaire. Dans ces scénarios, les premiers événements AdEvents déclenchés (AD_METADATA, LOADED, etc.) peuvent n'afficher que le nombre total de tags d'emplacement publicitaire issus de la réponse de la playlist. Nous vous recommandons d'utiliser l'événement FIRST_QUARTILE dans lequel les éditeurs extraient des informations de cet objet et mettent à jour les éléments visuels du lecteur, le cas échéant.
- Renvoie
-
number: nombre total d'annonces dans la série d'annonces