Demande d'annonces

new AdsRequest()

Implémentations

google.ima.AdsRequestInterface

URL du tag d'emplacement publicitaire

string

Indique l'URL du tag d'emplacement publicitaire qui est demandée à l'ad server. Pour savoir comment créer l'URL du tag d'emplacement publicitaire, consultez l'article Créer manuellement un tag publicitaire vidéo principal.

Ce paramètre est obligatoire.

Réponse pour les annonces

(document nul, chaîne ou non nul)

Spécifie un document VAST 2.0 à utiliser comme réponse à l'annonce au lieu d'envoyer une demande via une URL de tag d'emplacement publicitaire. Cela peut être utile pour le débogage et d'autres situations dans lesquelles une réponse VAST est déjà disponible.

Ce paramètre est facultatif.

contentDuration

(nul ou nombre)

Indique la durée d'affichage du contenu, en secondes. Elle est utilisée dans deux cas: 1) ciblage des annonces AdX et 2) détermination du préchargement d'une annonce post-roll VMAP.

Ce paramètre est facultatif.

Mots clés pour le contenu

(tableau de chaînes nul ou non nul)

Spécifie les mots clés utilisés pour décrire le contenu à afficher. Utilisé dans les demandes AdX.

Ce paramètre est facultatif.

TitreTitre

(nul ou chaîne)

Titre du contenu à afficher. Utilisé dans les demandes AdX.

Ce paramètre est facultatif.

forceNonLinearFullSlot

booléen

Forcer les annonces AdSense non linéaires à s'afficher en plein espace linéaire. Si ce paramètre est défini, la vidéo de contenu est mise en pause, et l'annonce textuelle ou illustrée non linéaire s'affiche en plein espace. La vidéo du contenu reprendra lorsque l'annonce sera ignorée ou fermée.

Hauteur de l'espace publicitaire linéaire

number (nombre)

Spécifie la hauteur de la zone rectangulaire dans laquelle une annonce linéaire est affichée. Cette valeur est utilisée comme critère de sélection des annonces. Cette valeur ne doit pas nécessairement correspondre à la hauteur réelle de l'annonce.

Ce paramètre est obligatoire.

LargeurDeL'EmplacementLinéaire

number (nombre)

Spécifie la largeur de la zone rectangulaire dans laquelle une annonce linéaire est affichée. Cette valeur est utilisée comme critère de sélection des annonces. Cette valeur ne doit pas nécessairement correspondre à la largeur réelle de l'annonce.

Ce paramètre est obligatoire.

liveStreamPrefetchSeconds

number (nombre)

Indique la durée maximale (en secondes) après l'appel de requestAds, avant de demander l'URL du tag d'emplacement publicitaire. Cette approche permet d'échelonner les requêtes lors d'un événement de diffusion en direct afin de limiter les pics.

Hauteur de l'espace publicitaire non linéaire

number (nombre)

Spécifie la hauteur de la zone rectangulaire dans laquelle une annonce non linéaire est affichée. Cette valeur est utilisée comme critère de sélection des annonces. Cette valeur ne doit pas nécessairement correspondre à la hauteur réelle de l'annonce.

Ce paramètre est obligatoire.

Largeur de l'annonce non linéaire

number (nombre)

Spécifie la largeur de la zone rectangulaire dans laquelle une annonce non linéaire est affichée. Cette valeur est utilisée comme critère de sélection des annonces. Cette valeur ne doit pas nécessairement correspondre à la largeur réelle de l'annonce.

Ce paramètre est obligatoire.

omidAccessModeRules

Objet non nul avec des propriétés de chaîne

Objet de paramètres permettant de mapper les fournisseurs de services de vérification sur les modes d'accès OMID. Les clés doivent être des valeurs dans google.ima.OmidVerificationVendor, et les valeurs doivent être des valeurs dans google.ima.OmidAccessMode.

Les URL du script de validation sont mises en correspondance en interne par rapport aux expressions régulières fournies par le fournisseur pour être résolues avec une clé OmidVerificationVendor. IMA recherche ensuite le mode d'accès du fournisseur donné à l'aide de cet objet.

Pour les URL de script qui ne sont pas associées à un fournisseur connu, ou si le fournisseur OmidVerificationVendor n'est pas fourni dans cet objet, IMA utilisera le mode d'accès fourni pour OmidVerificationVendor.OTHER Si OmidVerificationVendor.OTHER n'est pas fourni, le mode d'accès LIMITED sera utilisé.

URL de la page

(nul ou chaîne)

Spécifie l'URL complète de la page qui sera incluse dans la demande d'annonce Google à des fins de ciblage. L'URL doit être valide. Si cette valeur est spécifiée, elle est utilisée pour la macro VAST [PAGEURL].

Ce paramètre est facultatif.

vastLoadTimeout

number (nombre)

Remplacement du délai de chargement VAST par défaut en millisecondes pour un seul wrapper. Le délai avant expiration par défaut est de 5 000 ms.

Ce paramètre est facultatif.

Définir une annonce automatique

setAdWillAutoPlay(autoPlay) renvoie void

Indique au SDK si le lecteur a l'intention de lancer le contenu et l'annonce en réponse à une action de l'utilisateur, ou s'il est lu automatiquement. La modification de ce paramètre n'aura aucune incidence sur la lecture des annonces.

Renvoie

void 

setAdWillPlayCoupé

setAdWillPlaymuted(muted) renvoie

Notifie le SDK si le lecteur a l'intention de lancer l'annonce avec le son coupé. La modification de ce paramètre n'aura pas d'incidence sur la lecture des annonces, mais enverra le signal approprié dans la demande d'annonce pour permettre aux acheteurs d'enchérir sur un inventaire dont le son est coupé.

Renvoie

void 

setContinuousPlayback

setContinuousPlayback(continuousPlayback) renvoie void

Indique au SDK si le lecteur a l'intention de lire les contenus vidéo en continu, l'un après l'autre, comme pour la diffusion télévisée. La modification de ce paramètre n'aura pas d'incidence sur la lecture des annonces, mais enverra le signal approprié dans cette demande d'annonce pour permettre aux acheteurs d'enchérir sur le type d'inventaire publicitaire.

Renvoie

void