API du SDK IMA DAI de Google

    1. google.ima.dai.api.Ad
    2. google.ima.dai.api.AdPodInfo
    3. google.ima.dai.api.AdProgressData
    4. google.ima.dai.api.CompanionAd
    5. google.ima.dai.api.CuePoint
    6. google.ima.dai.api.LiveStreamRequest
    7. google.ima.dai.api.StreamData
    8. google.ima.dai.api.StreamEvent
    9. google.ima.dai.api.StreamEvent.Type
    10. google.ima.dai.api.StreamManager
    11. google.ima.dai.api.StreamRequest
    12. google.ima.dai.api.VODStreamRequest
    13. google.ima.VERSION

Class google.ima.dai.api.Ad

Méthodes

Classe représentant un objet publicitaire lors de l'insertion dynamique d'annonces. Cette classe expose un sous-ensemble des propriétés ima.Ad.

getAdId()


Renvoie string :

getAdPodInfo()


Renvoie google.ima.dai.api.AdPodInfo :

getAdSystem()


Renvoie string :

getAdvertiserName()


Renvoie string :

getApiFramework()


Renvoie string :

getCompanionAds()


Renvoie Array.<google.ima.dai.api.CompanionAd> :

getCreativeAdId()


Renvoie string :

getCreativeId()


Renvoie string :

getDealId()


Renvoie string :

getDescription()


Renvoie string :

getDuration()


Renvoie number :

getTitle()


Renvoie string :

getVastMediaHeight()


Renvoie number :

getVastMediaWidth()


Renvoie number :

getWrapperAdIds()


Renvoie Array.<string> :

getWrapperAdSystems()


Renvoie Array.<string> :

getWrapperCreativeIds()


Renvoie Array.<string> :

Class google.ima.dai.api.AdPodInfo

Méthodes

Classe représentant un objet d'informations sur le bloc d'annonces lors de l'insertion dynamique d'annonces. Cette classe expose un sous-ensemble des propriétés ima.AdPodInfo.

getAdPosition()


Renvoie number :

getMaxDuration()


Renvoie number :

getPodIndex()


Renvoie number :

getTimeOffset()


Renvoie number :

getTotalAds()


Renvoie number :

Classe google.ima.dai.api.AdProgressData

Fields

Classe permettant de spécifier les données de progression des annonces.

Propriétés

Nom Type Description
adBreakDuration

adPosition

currentTime

duration

totalAds

Class google.ima.dai.api.CompanionAd

Méthodes

Classe représentant un objet d'annonce associée lors de l'insertion dynamique d'annonces. Cette classe expose un sous-ensemble des propriétés ima.CompanionAd.

getAdSlotId()


Renvoie string :

getContent()


Renvoie string :

getContentType()


Renvoie string :

getHeight()


Renvoie number :

getWidth()


Renvoie number :

Class google.ima.dai.api.CuePoint

Fields

Classe permettant de spécifier les propriétés d'un repère, qui représente une coupure publicitaire dans les flux VOD DAI.

Propriétés

Nom Type Description
end

Heure de fin de ce repère.
played

Indique si ce point de repère a été lu.
start

Heure de début de ce point de repère.

Class google.ima.dai.api.LiveStreamRequest

Fields

Classe permettant de spécifier les propriétés de la requête de diffusion en direct.

Constructeur :
Paramètre Type Description
opt_liveStreamRequest Object

objet auquel des propriétés de demande de flux sont déjà attribuées.

Propriétés

Nom Type Description
assetKey

Il permet de déterminer le flux à lire. La clé de l'élément de la demande de diffusion en direct est un identifiant que vous pouvez trouver dans l'UI DFP.

Classe google.ima.dai.api.StreamData

Fields

Classe permettant de spécifier les données de flux.

Propriétés

Nom Type Description
adProgressData

Informations sur le timing de l'annonce en cours de lecture.
cuepoints

Points de repère publicitaires pour le flux à la demande. Ces valeurs peuvent changer au fur et à mesure de la diffusion. Cette valeur ne sera renseignée dans l'écouteur d'événements que pour l'événement CUEPOINTS_CHANGED AdEvent.
errorMessage

streamId

subtitles

url

Class google.ima.dai.api.StreamEvent

Méthodes

Ce type d'événement est déclenché par le gestionnaire de flux sous forme de notification lorsque l'état du flux change.

getAd()


Renvoie google.ima.dai.api.Ad : renvoie l'objet avec les informations sur l'annonce.

getStreamData()


Renvoie google.ima.dai.api.StreamData : renvoie l'objet avec les informations du flux.

Enum google.ima.dai.api.StreamEvent.Type

Fields

Liste des types d'événements compatibles avec le SDK IMA.

Valeurs

Valeur Description
AD_BREAK_ENDED

Déclenché lorsqu'une coupure publicitaire se termine.
AD_BREAK_STARTED

Déclenché lorsqu'une coupure publicitaire commence.
AD_PROGRESS

Déclenché lorsqu'il y a une mise à jour de la progression d'une annonce.
CLICK

Déclenché lorsque l'utilisateur clique ou appuie sur l'élément cliquable pendant la lecture d'une annonce.
COMPLETE

Déclenché lorsqu'une annonce est terminée.
CUEPOINTS_CHANGED

Déclenchée pour les flux à la demande lorsque les points de repère changent.
ERROR

Déclenché lorsqu'une erreur se produit.
FIRST_QUARTILE

Déclenché lorsqu'une annonce atteint son premier quartile.
LOADED

Déclenché lorsque le fichier manifeste du flux est disponible.
MIDPOINT

Déclenché lorsqu'une annonce atteint son point médian.
STARTED

Déclenché lorsqu'une annonce commence.
STREAM_INITIALIZED

Déclenché lorsque le flux est initialisé.
THIRD_QUARTILE

Déclenché lorsqu'une annonce atteint son troisième quartile.

Class google.ima.dai.api.StreamManager

Méthodes

Gère les flux d'insertion dynamique d'annonces. Il gère les interactions avec le backend DAI et les pings de suivi, et transmet les événements de flux et d'annonces à l'éditeur. Ce gestionnaire n'hérite pas de BaseAdsManager, car il ne s'agit pas d'un gestionnaire pour une annonce spécifique, mais pour l'ensemble du flux.

Constructeur :
Paramètre Type Description
videoElement HTMLVideoElement

Élément du lecteur vidéo.

contentTimeForStreamTime(streamTime)

Renvoie la durée du contenu sans publicité pour une durée de flux donnée. Renvoie l'heure de diffusion donnée pour les diffusions en direct.

Returns number : renvoie le code temporel du contenu qui correspond au code temporel du flux donné une fois les annonces supprimées.

Paramètre Type Description
streamTime number

Durée du flux avec les annonces insérées (en secondes).

onTimedMetadata(metadata)

Transmet les données dans un dictionnaire de métadonnées traitées. Le dictionnaire attend la clé "TXXX" avec la chaîne de métadonnées définie par l'utilisateur comme valeur. Si votre lecteur fournit des métadonnées brutes, appelez plutôt ima.dai.api.StreamManager.processMetadata.

Paramètre Type Description
metadata Object

Dictionnaire des métadonnées.

previousCuePointForStreamTime(streamTime)

Renvoie le point de repère précédent pour le code temporel du flux donné. Renvoie la valeur "null" si aucun point de repère de ce type n'existe. Cette méthode est utilisée pour implémenter des fonctionnalités telles que le retour à la position initiale. Elle est appelée lorsque l'éditeur détecte que l'utilisateur a effectué une recherche afin de le renvoyer à un emplacement de coupure publicitaire.

Renvoie google.ima.dai.api.CuePoint : le repère précédent pour le code temporel du flux donné.

Paramètre Type Description
streamTime number

Heure du flux à laquelle l'utilisateur a fait une recherche.

processMetadata(type, data, timestamp)

Traite les métadonnées temporelles pour les diffusions en direct. Utilisez cette méthode si votre lecteur vidéo fournit des métadonnées non analysées avec des codes temporels. Sinon, appelez ima.dai.api.StreamManager.onTimedMetadata.

Paramètre Type Description
type string

Type de métadonnées. Doit être "ID3".
data Uint8Array

Données brutes des tags. Pour ID3, il doit s'agir de l'intégralité du tag.
timestamp number

Heure à laquelle les données doivent être traitées.

requestStream(streamRequest)

Demande le chargement d'un flux à l'aide des paramètres de flux fournis.

Paramètre Type Description
streamRequest google.ima.dai.api.StreamRequest

contient des paramètres permettant de charger les métadonnées du flux.

setClickElement(clickElement)

Définit l'élément de clic sur les annonces. Cet élément est utilisé comme récepteur de clics ou de tapotements pendant la lecture d'une annonce et peut entraîner une navigation hors de la page actuelle.

Paramètre Type Description
clickElement Element

l'élément utilisé comme lien de redirection vers l'annonce.

streamTimeForContentTime(contentTime)

Renvoie le temps de flux avec des annonces pour un temps de contenu donné. Renvoie le temps de contenu donné pour les diffusions en direct.

Renvoie number la durée de visionnage qui correspond au contenu donné une fois les annonces insérées.

Paramètre Type Description
contentTime number

Durée du contenu sans publicité (en secondes).

Classe google.ima.dai.api.StreamRequest

Fields

Classe permettant de spécifier les propriétés de la requête de flux.

Propriétés

Nom Type Description
adTagParameters

Vous pouvez ignorer un ensemble limité de paramètres de tag d'emplacement publicitaire dans votre demande de flux. Pour en savoir plus, consultez Indiquer des paramètres de ciblage dans votre flux. Vous pouvez utiliser les paramètres dai-ot et dai-ov pour définir vos préférences concernant les variantes de flux. Pour en savoir plus, consultez Remplacer les paramètres de la variante de flux.
apiKey

Clé API de la requête de flux. Il est configuré dans l' interface utilisateur de l'administrateur DFP et fourni à l'éditeur pour déverrouiller son contenu. Il vérifie les applications qui tentent d'accéder au contenu.
streamActivityMonitorId

ID à utiliser pour déboguer le flux avec le contrôle de l'activité des flux. Cela permet aux éditeurs de trouver facilement un journal de flux dans l'outil de contrôle de l'activité des flux.

Class google.ima.dai.api.VODStreamRequest

Fields

Classe permettant de spécifier les propriétés de la requête de flux VOD.

Constructeur :
Paramètre Type Description
opt_VODStreamRequest Object

objet auquel des propriétés de demande de flux sont déjà attribuées.

Propriétés

Nom Type Description
contentSourceId

Identifiant unique du contenu de l'éditeur, provenant d'un CMS. Obligatoire pour les flux à la demande.
videoId

Identifiant de la source du contenu vidéo. Obligatoire pour les flux à la demande.

Constante google.ima.VERSION

Chaîne contenant la version complète du SDK.