Paramètres d'URL du tag d'emplacement publicitaire VAST

Tous les paramètres du tag d'emplacement publicitaire VAST

Liste complète des paramètres, quelle que soit l'implémentation

Cet article présente la liste complète des paramètres pouvant être utilisés dans un tag d'emplacement publicitaire VAST. Cela peut vous être utile si vous souhaitez en savoir plus sur un paramètre spécifique.

Remarque : La catégorisation de cette page s'applique à l'utilisation de ces paramètres pour la diffusion d'annonces. Toutefois, certains paramètres peuvent également être obligatoires ou recommandés pour des types d'implémentation ou des utilisations de fonctionnalités spécifiques. Consultez les exigences et les recommandations concernant votre type d'implémentation spécifique.

Sur cette page

Listes de paramètres par type d'implémentation

Si vous utilisez une implémentation spécifique, vous pouvez utiliser des listes de paramètres personnalisées qui décrivent l'utilisation et les exigences de cette implémentation. Utilisez la liste des paramètres personnalisés pour :

Web  Application mobile  TV connectée  Audio  Publicité extérieure numérique

Tous les paramètres

Tout développer Tout réduire

Paramètres requis pour la diffusion d'annonces

En général, ces paramètres sont requis pour la diffusion d'annonces dans la plupart des cas de figure. Toutefois, il peut arriver qu'ils ne soient pas nécessaires. Pour obtenir la liste la plus précise, utilisez la liste des paramètres pour votre type d'implémentation spécifique.

correlator (corrélateur)

Description

Le paramètre de corrélation (correlator) accepte une valeur variable qui est partagée par plusieurs demandes provenant de la même page vue. Il permet de définir des exclusions réciproques, y compris dans les environnements exempts de cookies.

Exemples d'utilisation

correlator=4345645667

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Utilisation du SDK
  • Si vous utilisez le SDK IMA, la valeur du paramètre "correlator" est automatiquement définie. Si votre lecteur tente de définir cette valeur, le SDK la remplace par sa propre valeur.
  • Si vous n'utilisez pas le SDK IMA, veillez à la définir sur une valeur entière positive réellement aléatoire qui n'est pas réutilisée par plusieurs pages vues.

Revenir à la vue sous forme de liste

description_url (URL de description)

Description

Le paramètre d'URL de description (description_url) accepte une valeur variable qui doit décrire la vidéo lue sur la page.

L'URL de description doit concerner les vidéos lues sur une page spécifique d'une application Web, mobile ou TV. Il ne doit pas s'agir du domaine de premier niveau de toutes les vidéos ni de toutes les demandes d'annonce. Par exemple, si vous avez une page https://www.sample.com/golf.html pour diffuser des vidéos sur le golf, définissez-la comme valeur de description_url.

Exemples d'utilisation

La valeur description_url doit être encodée sous forme d'URL pour les pages Web contenant des vidéos et les appareils de TV connectée/service de distribution par contournement. Toutefois, la valeur description_url ne doit pas être encodée pour les applications mobiles.

Valeur encodée sous forme d'URL :
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

Valeur non encodée sous forme d'URL :
description_url=
https://www.sample.com/golf.html

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile.

Ce paramètre est obligatoire pour implémenter la diffusion d'annonces sur le Web et dans les applications mobiles. Il est également obligatoire si vous utilisez Ad Exchange ou AdSense pour l'allocation dynamique.

Ce paramètre est recommandé pour la monétisation programmatique.

Utilisation du SDK

Ce paramètre n'est pas défini automatiquement par le SDK IMA. Vous devez le configurer manuellement.

Consultez les guides du SDK IMA pour votre plate-forme.

Revenir à la vue sous forme de liste

env (environnement)

Description

Le paramètre d'environnement (env) accepte une valeur constante qui indique qu'il s'agit d'une demande InStream ou que la demande provient spécifiquement d'un lecteur vidéo.

Les valeurs possibles sont instream, qui peut être utilisée pour les annonces audio et vidéo, ou vp, qui ne peut être utilisée que pour les annonces vidéo.

Exemples d'utilisation

Vidéo et/ou audio :
env=instream

Vidéo uniquement :
env=vp

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Ce paramètre est requis pour générer des rapports précis sur le type de requête ventilé par "Tag vidéo".

Revenir à la vue sous forme de liste

gdfp_req (indicateur de schéma)

Description

Le paramètre d'indicateur de schéma Google Ad Manager (gdfp_req) accepte une valeur constante qui indique que la demande d'annonce concerne l'inventaire Google Ad Manager.

Exemples d'utilisation

gdfp_req=1

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Revenir à la vue sous forme de liste

iu (bloc d'annonces)

Description

Le paramètre de bloc d'annonces (iu) accepte une valeur variable qui doit être définie au niveau du bloc d'annonces actuel, au format suivant : /network_code/.../ad_unit.

Exemples d'utilisation

iu=/6062/videodemo

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Revenir à la vue sous forme de liste

output (résultat)

Description

Le paramètre de format de sortie (output) accepte une valeur constante qui doit être définie sur le format de sortie de l'annonce.

Exemples d'utilisation

Utilisez la version VAST par défaut de votre réseau:

output=vast

Utilisez VAST 4 (vous pouvez définir des versions spécifiques pour des tags spécifiques):

output=xml_vast4

Utilisez le paramètre VMAP par défaut de votre réseau:

output=vmap

Utilisez VMAP 1:

output=xml_vmap1

Utilisez VMAP 1, avec renvoi de VAST 4 (si vous renvoyez VAST dans VMAP):

output=xml_vmap1_vast4

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire pour implémenter la diffusion d'annonces sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique. Il est nécessaire pour générer le format de réponse de diffusion d'annonces approprié.

Utilisation du SDK

Pour VAST, si votre lecteur vidéo utilise le SDK IMA, le paramètre de sortie d'une demande d'annonce vidéo sera toujours défini sur output=xml_vast4. Il n'y a pas de risque en termes de fiabilité, car le SDK est rétrocompatible avec toutes les versions de VAST susceptibles d'être diffusées par un ad server tiers.

Revenir à la vue sous forme de liste

sz (taille)

Description

Le paramètre de taille (sz) accepte une valeur variable qui doit être définie sur la taille de l'espace publicitaire de l'annonce vidéo maître.

Si vous spécifiez plusieurs tailles, séparez-les par une barre verticale (|).

N'ajoutez pas v après la taille.

Exemples d'utilisation

Taille unique :
sz=400x300

Tailles multiples :
sz=300x250|400x300

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée et la publicité extérieure numérique.

Ce paramètre est facultatif si votre demande ne concerne que des annonces audio (ad_type=audio).

Revenir à la vue sous forme de liste

unviewed_position_start (impressions différées)

Description

Le paramètre d'impressions différées (unviewed_position_start) accepte une valeur constante qui indique les impressions différées pour la vidéo.

Exemples d'utilisation

unviewed_position_start=1

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web et les applications mobiles lorsqu'il y a une opportunité d'impression différée. 

Revenir à la vue sous forme de liste

url (URL)

Description

Le paramètre d'URL (url) accepte une valeur variable qui doit être définie sur l'URL complète à partir de laquelle la demande est envoyée. Cette valeur obligatoire permet aux acheteurs d'identifier et de comprendre le contexte d'origine de la demande. Dans la mesure du possible, cette valeur doit être renseignée dynamiquement dans la demande d'annonce. 

  • Sur le Web, il s'agit de l'URL de la page qui affiche le lecteur vidéo.
  • Pour les environnements autres que le Web, cette valeur doit être définie sur une URL qui représente le plus précisément possible l'inventaire vidéo ou audio monétisé. C'est par exemple le cas lorsqu'un utilisateur regarde une vidéo sur une application mobile et que cette vidéo est également disponible sur ordinateur via une URL*.

Remarque : Le paramètre url diffère du paramètre description_url, car url fait référence à l'emplacement depuis lequel une demande d'annonce a été envoyée, alors que description_url est une page Web explorable qui décrit le contenu de la vidéo.

La valeur de ce paramètre doit être encodée.

Exemples d'utilisation

url=https%3A%2F%2Fwww.example.com%2Fvideo.html

* Pour les applications, s'il n'est pas possible de définir une valeur d'URL variable pour ce paramètre, nous vous recommandons de définir une valeur au format suivant : url=https%3A%2F%2F<app/bundleid>.example.com

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire si vous souhaitez diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Utilisation du SDK

Si vous utilisez le SDK IMA, la valeur de l'URL est définie automatiquement. Si votre lecteur définit cette valeur, le SDK IMA respectera la valeur définie.

Revenir à la vue sous forme de liste

vpmute (lecture de la vidéo sans le son)

Description

Le paramètre de lecture de la vidéo sans le son (vpmute) accepte une valeur constante qui indique si la lecture de l'annonce commence avec le son du lecteur vidéo coupé. Ce paramètre ne change pas l'état du lecteur vidéo. Le comportement de lecture doit être géré directement par le lecteur vidéo.

Exemples d'utilisation

La lecture commence avec le son coupé :
vpmute=1

La lecture commence avec le son activé :
vpmute=0

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire pour la monétisation programmatique des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Ce paramètre est également recommandé conformément aux Règles de mesure des annonces vidéo du MRC (Media Rating Council).

Revenir à la vue sous forme de liste

Paramètres requis pour le programmatique

ott_placement (formats personnalisés)

Description

Le paramètre de formats personnalisés (ott_placement) accepte une valeur constante qui indique une demande d'emplacement service de distribution par contournement (OTT, over-the-top) autre qu'InStream.

Définitions des emplacements pour les exemples ci-dessous:

  • Pause: format OutStream qui s'affiche en superposition sur le contenu vidéo lorsqu'un utilisateur met la lecture en pause.
  • Écran d'accueil: annonce qui s'affiche sur l'écran d'accueil d'un appareil pour la TV connectée ou d'une application OTT. Cela inclut les implémentations de masthead, de bannière et de bloc sur un écran d'accueil.
  • Picture-in-picture (Mode Picture-in-picture) : annonce vidéo InStream lue dans un lecteur vidéo publicitaire distinct à côté du contenu vidéo. Cela nécessite généralement de réduire le contenu vidéo et de charger un deuxième lecteur vidéo.
  • Bannière en L: annonce display InStream qui consiste à réduire le contenu vidéo et à créer une annonce autour de la vidéo. Il s'agit généralement d'une zone de contenu publicitaire en forme de L, mais pas nécessairement.
  • Superposition: tout format d'annonce InStream qui s'affiche au-dessus du contenu vidéo, mais qui n'occupe pas tout l'écran. Il peut s'agir d'une annonce display ou vidéo.

Exemples d'utilisation

Formats compatibles et valeurs correspondantes:

Pause:
cust_fmt=1

Écran d'accueil:
cust_fmt=2

Picture-in-picture:
cust_fmt=3

Bannière en L:
cust_fmt=4

Superposition:
cust_fmt=5

Personnalisé/Autre:
cust_fmt=99

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée.

Ce paramètre n'est obligatoire que pour la monétisation programmatique sur le Web, les applications mobiles et la TV connectée pour les éditeurs qui monétisent des emplacements non standards dans des environnements de streaming OTT.

Revenir à la vue sous forme de liste

plcmt (emplacement)

Description

Le paramètre d'emplacement (plcmt) accepte une valeur constante qui est utilisée pour indiquer si l'inventaire InStream est déclaré ou non comme "InStream" ou "Associé", conformément aux conseils des spécifications de l'IAB.

Pour les demandes non InStream, ce champ est rempli automatiquement pour les acheteurs en fonction du format d'inventaire déclaré, qui remplace toute déclaration InStream ou associée.

Exemples d'utilisation

Demande InStream :
plcmt=1

Demande de contenu associé :
plcmt=2

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Revenir à la vue sous forme de liste

venuetype (type de lieu)

Description

Le paramètre de type de lieu (venuetype) permet d'indiquer le type du lieu extérieur. Les valeurs éligibles sont les ID d'énumération entiers qui sont conformes à la taxonomie 1.1 de l'IAB sur les types de lieux OpenOOH.

Exemples d'utilisation

Chambres d'hôtel :
venuetype=80703

Tablette à l'arrière d'un taxi :
venuetype:103

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre est obligatoire pour la monétisation programmatique dans la publicité extérieure numérique.

Revenir à la vue sous forme de liste

vpa (lecture automatique de la vidéo)

Description

Le paramètre de lecture automatique de la vidéo (vpa) accepte une valeur constante qui indique si le contenu vidéo d'une annonce commence à être lu automatiquement ou après un clic.

Les valeurs possibles sont click si une action de l'utilisateur est requise, et auto si la vidéo est lue automatiquement. Ce paramètre ne change pas l'état du lecteur vidéo. Le comportement de lecture doit être géré directement par le lecteur vidéo.

Exemples d'utilisation

Lecture automatique :
vpa=auto

Lecture après un clic :
vpa=click

Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur.

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio.

Ce paramètre est obligatoire pour la monétisation programmatique des annonces pour le Web, les applications mobiles, la TV connectée et l'audio.

Ce paramètre est également recommandé conformément aux Règles de mesure des annonces vidéo du MRC (Media Rating Council).

Revenir à la vue sous forme de liste

aconp (lecture continue de l'audio)

Description

Le paramètre de lecture en continu (aconp) accepte une valeur constante qui indique si le lecteur va lire le contenu audio en continu. Cela permet à Google Ad Manager de sélectionner les annonces les plus adaptées à l'expérience utilisateur.

Exemples d'utilisation

Lecture en continu activée :
aconp=2

Lecture en continu désactivée :
aconp=1

Si vous ne savez pas si l'audio est lu en continu, ne définissez pas ce paramètre ou définissez-le sur aconp=0.

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Ce paramètre est également recommandé conformément aux Règles de mesure des annonces audio du MRC (Media Rating Council).

Revenir à la vue sous forme de liste

an (nom de l'application)

Description

Les paramètres d'ID (msid) et de nom d'application (an) acceptent des valeurs variables qui doivent être appliquées aux demandes envoyées à partir d'appareils pour applications mobiles et pour la télévision connectée, car la plupart des annonces vidéo programmatiques les requièrent.

Bien que le nom de l'application doive être lisible, sur iOS et tvOS, le SDK ne peut pas accéder à l'ID de l'application. Dans ces cas de figure, le paramètre msid n'est pas envoyé, et le SDK envoie l'app bundle par le biais du paramètre an.

Exemples d'utilisation

msid=com.package.publisher&an=sample%20app

Les ID d'application sont nommés et formatés différemment selon les plates-formes de téléchargement d'applications. Consultez les Consignes de l'IAB pour l'identification des applications ou des exemples d'identifiants uniques courants.

Pour les plates-formes où il n'existe pas de plate-forme de téléchargement d'applications, l'IAB recommande aux éditeurs d'utiliser le format suivant pour les ID de plate-forme de téléchargement d'applications : com.publisher.deviceplatform

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique dans les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Pour garantir la brand safety et offrir plus de transparence aux acheteurs, nous vous recommandons vivement d'inclure les informations sur l'application.

Utilisation du SDK

Le SDK IMA insère automatiquement les valeurs des deux paramètres, mais vous devez les spécifier manuellement dans les environnements autres que SDK, y compris pour les appels VAST directs, ou lorsque vous utilisez la bibliothèque d'accès programmatique (PAL) ou l'inventaire authentifié par l'éditeur (PAI).

Remarque: Si vous utilisez le SDK IMA HTML5, les informations sur l'application ne sont pas utilisées.

Revenir à la vue sous forme de liste

dth (indice sur le type d'appareil)

Description

Le paramètre d'indication de type d'appareil (dth) accepte une valeur constante qui permet de réduire les classifications incorrectes d'appareils, en particulier sur les environnements de TV connectée et de boîtier décodeur.

Une mauvaise classification de l'appareil peut résulter d'erreurs involontaires de l'éditeur ou de l'OEM de TV connectée. Ce paramètre est utilisé conjointement avec d'autres signaux pour que Google signale automatiquement les cas où l'inventaire pour la TV connectée pourrait être reclassé.

Exemples d'utilisation

Requêtes provenant de :

  • Feature phone : dth=1
  • Smartphone : dth=2
  • Ordinateur de bureau : dth=3
  • Tablette : dth=4
  • TV connectée : dth=5
  • Console de jeu : dth=6
  • Boîtier décodeur : dth=7

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Utilisation du SDK

Ce paramètre est recommandé pour les implémentations PAL et PAI (non-SDK). Il n'est pas nécessaire pour le SDK IMA ni le SDK DAI.

Revenir à la vue sous forme de liste

givn (nonce vidéo)

Description

Pour les intégrations qui utilisent Programmatic Access Library (PAL), le paramètre nonce vidéo accepte une valeur de chaîne variable.

Le nonce est adapté aux URL. Vous n'avez pas besoin de l'encoder en URL.

Remarque : Si vous avez déjà fourni un nonce à l'aide de l'ancien paramètre paln, nous vous recommandons vivement de passer au paramètre givn et d'arrêter d'envoyer paln. N'incluez pas les deux paramètres.

Exemples d'utilisation

Pour en savoir plus sur la valeur transmise à ce paramètre, consultez les guides de démarrage de PAL.

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Revenir à la vue sous forme de liste

hl (langue)

Description

Le paramètre de langue (hl) accepte une valeur constante qui sert à demander des annonces dans la langue en question, et à indiquer la langue de sélection d'une annonce et du rendu des annonces vidéo pour l'allocation dynamique dans les éléments vidéo Ad Exchange ou AdSense.

Exemples d'utilisation

Demander des annonces en italien :
hl=it

La valeur du paramètre peut être un code de langue ISO 639-1 (à deux lettres) ou ISO 639-2 (à trois lettres). Pour connaître la liste des codes valides, consultez cette page.

En cas d'omission, la valeur par défaut est une langue pour laquelle le ciblage linguistique des annonces dans Ad Exchange est activé.

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Revenir à la vue sous forme de liste

msid (ID de l'application)

Description

Les paramètres d'ID (msid) et de nom d'application (an) acceptent des valeurs variables qui doivent être appliquées aux demandes envoyées à partir d'appareils pour applications mobiles et pour la télévision connectée, car la plupart des annonces vidéo programmatiques les requièrent.

Bien que le nom de l'application doive être lisible, sur iOS et tvOS, le SDK ne peut pas accéder à l'ID de l'application. Dans ces cas de figure, le paramètre msid n'est pas envoyé, et le SDK envoie l'app bundle par le biais du paramètre an.

Exemples d'utilisation

msid=com.package.publisher&an=sample%20app

Les ID d'application sont nommés et formatés différemment selon les plates-formes de téléchargement d'applications. Consultez les Consignes de l'IAB pour l'identification des applications ou des exemples d'identifiants uniques courants.

Pour les plates-formes où il n'existe pas de plate-forme de téléchargement d'applications, l'IAB recommande aux éditeurs d'utiliser le format suivant pour les ID de plate-forme de téléchargement d'applications : com.publisher.deviceplatform

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique dans les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Pour garantir la brand safety et offrir plus de transparence aux acheteurs, nous vous recommandons vivement d'inclure les informations sur l'application.

Utilisation du SDK

Le SDK IMA insère automatiquement les valeurs des deux paramètres, mais vous devez les spécifier manuellement dans les environnements autres que SDK, y compris pour les appels VAST directs, ou lorsque vous utilisez la bibliothèque d'accès programmatique (PAL) ou l'inventaire authentifié par l'éditeur (PAI).

Remarque: Si vous utilisez le SDK IMA HTML5, les informations sur l'application ne sont pas utilisées.

Revenir à la vue sous forme de liste

omid_p (nom du partenaire OMID)

Description

Le paramètre de nom du partenaire OMID (omid_p) accepte une valeur variable qui indique le nom du partenaire intégrant la mesure OMID et la version du partenaire.

Le paramètre des API SDK compatibles (sdk_apis) accepte des valeurs variables qui peuvent être une liste unique ou séparée par des virgules d'API compatibles.

Ces paramètres font partie d'un ensemble de paramètres utilisés pour la visibilité et la validation des annonces.

Exemples d'utilisation

Si vous n'utilisez pas PAL :
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

Consultez la liste des valeurs possibles pour le framework de l'API.

Si vous utilisez PAL :
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Utilisation du SDK
  • Ce paramètre ne s'applique qu'aux éditeurs qui souhaitent effectuer des mesures Active View lorsqu'ils utilisent le SDK Open Measurement (SDK OM).
  • Pour indiquer qu'OMID est compatible avec Programmatic Access Library (PAL), vous devez utiliser omidPartnerName et omidPartnerVersion afin de définir le nom et la version du partenaire. Lorsque vous n'utilisez pas le SDK PAL ou IMA, vous devez définir les paramètres omid_p et sdk_apis.
  • Il ne doit pas être utilisé lorsque vous utilisez le SDK IMA, car il est défini automatiquement.

Revenir à la vue sous forme de liste

rdid (identifiant d'appareil réinitialisable)

Description

Les paramètres d'identifiants d'appareil réinitialisables (rdid, idtype et is_lat) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).

Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid, idtype et is_lat.

Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil

La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.

Avertissement

Depuis iOS 14.5, Apple a abandonné le signal LAT.À la place, Google s'appuie sur la présence d'un IDFA non nul, qui indique que l'utilisateur a accepté le suivi sur les versions d'iOS compatibles avec App Tracking Transparency. Vous devez donc ajouter un UserAgent valide indiquant la version correcte du système d'exploitation.

Exemples d'utilisation

Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ces paramètres ne sont pas obligatoires pour diffuser des annonces, quel que soit le type d'implémentation visé, mais ils sont obligatoires pour la monétisation programmatique des annonces pour les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Pour les implémentations sur le Web, les identifiants d'appareil réinitialisables ne sont pas utilisés.

Utilisation du SDK

Avec le SDK IMA, ces paramètres sont transmis automatiquement. Les éditeurs qui utilisent le SDK PAL doivent les transmettre manuellement.

Revenir à la vue sous forme de liste

sid (ID de session)

Description

Le paramètre d'ID de session (sid) accepte une valeur variable qui est un identifiant publicitaire respectueux de la confidentialité et utilisable seulement pour limiter la fréquence d'exposition.

L'ID de session peut être utilisé pour les demandes d'annonces vidéo InStream provenant de TV connectées et avec l'inventaire vidéo InStream à partir d'appareils équipés d'applications mobiles. Ce paramètre n'est actuellement pas accepté pour le Web.

Vous pouvez désactiver la transmission de l'ID de session en définissant sid=0.

Exemples d'utilisation

sid=123e4567-e89b-12d3-a456-426614174000

Conformément aux Consignes de l'IAB concernant les identifiants publicitaires, ce paramètre doit être défini en respectant le format UUID. En savoir plus sur l'utilisation des identifiants d'appareil réinitialisables pour cibler les utilisateurs

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est obligatoire pour la monétisation programmatique des annonces pour la publicité extérieure numérique.

Ce paramètre est recommandé pour la monétisation programmatique des annonces pour les applications mobiles, la TV connectée et l'audio.

Utilisation du SDK

Ce paramètre est envoyé automatiquement par le SDK IMA.

Revenir à la vue sous forme de liste

vconp (lecture continue de la vidéo)

Description

Le paramètre de lecture continue de la vidéo (vconp) accepte une valeur constante qui indique si le lecteur doit lire le contenu vidéo en continu, à la manière d'une émission télévisée.

Exemples d'utilisation

Lecture continue ACTIVÉE :
vconp=2

Lecture continue DÉSACTIVÉE :
vconp=1

Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur.

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est recommandé pour la monétisation programmatique des annonces pour le Web, les applications mobiles, la TV connectée et l'audio.

Ce paramètre est également recommandé conformément aux Règles de mesure des annonces vidéo du MRC (Media Rating Council).

Revenir à la vue sous forme de liste

vid_d (durée de la vidéo)

Description

Le paramètre de durée de la vidéo (vid_d) accepte une valeur variable qui spécifie la durée du contenu, en secondes. 

  • Les paramètres vid_d et allcues servent à diffuser des annonces mid-roll sans ingestion de contenu.
  • L'utilisation des Règles relatives aux annonces est obligatoire pour renvoyer des annonces mid-roll. Si vous avez défini des repères temporels dans vos règles relatives aux annonces (par exemple, "Toutes les n seconde(s)" ou "À des moments précis"), ce sont eux qui sont utilisés. Les repères transmis dans le paramètre allcues sont ignorés. Pour les annonces mid-roll, le paramètre de durée vid_d reste obligatoire et doit être transmis.

Exemples d'utilisation

Contenu vidéo d'une durée de 90 000 secondes (25 heures) :
vid_d=90000

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est recommandé pour la monétisation programmatique des annonces pour le Web, les applications mobiles et la TV connectée.

Revenir à la vue sous forme de liste

vpos (positionnement de la vidéo)

Description

Le paramètre de position de la vidéo (vpos) accepte une valeur constante qui indique si la demande d'annonce est envoyée depuis une position d'annonce pré-roll, mid-roll ou post-roll.

Exemples d'utilisation

Pré-roll :
vpos=preroll

Mid-roll :
vpos=midroll

Post-roll :
vpos=postroll

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est recommandé pour la monétisation programmatique des annonces pour le Web, les applications mobiles, la TV connectée et l'audio.

Si vous utilisez des Règles relatives aux annonces, ce paramètre n'est pas obligatoire, car il est ajouté automatiquement par l'ad server.

Revenir à la vue sous forme de liste

wta (pourquoi cette annonce ?)

Description

Le paramètre "Pourquoi cette annonce ?" (wta) accepte une valeur constante qui indique si le lecteur vidéo accepte l'identification des publicités par des badges.

Exemples d'utilisation

Si le lecteur doit afficher l'icône Choisir sa pub fournie dans la réponse VAST, utilisez le paramètre suivant :

  • wta=1 (ou omettez le paramètre wta, ou transmettez wta sans valeur définie)

    Les demandes d'annonces audio doivent utiliser wta=1 si l'icône Choisir sa pub fournie dans la réponse VAST doit s'afficher sur les annonces associées ou être présentée à l'utilisateur.

Si le lecteur ne doit pas afficher l'icône Choisir sa pub fournie dans la réponse VAST, utilisez le paramètre suivant :

  • wta=0

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est recommandé pour la monétisation programmatique des annonces pour le Web, les applications mobiles, la TV connectée et l'audio.

Lorsque le paramètre est utilisé :

  • Avec &wta=0, le trafic n'est pas éligible à certains types de personnalisation des annonces issues de la demande Google.
  • Avec &wta=0, le trafic provenant de l'EEE n'est pas éligible aux créations pour lesquelles l'identification des publicités par des badges est activée dans les éléments de campagne de type "Réservation" et "Programmatique garanti" gérés par l'éditeur.

Les annonces doivent respecter les exigences réglementaires applicables aux annonces diffusées dans l'Espace économique européen (EEE). Cela inclut un mécanisme permettant aux utilisateurs de signaler du contenu illégal. Les éditeurs doivent informer Google de tout signalement de contenu illégal à l'aide du formulaire Signaler un contenu sur Google.

Utilisation du SDK
Lorsque vous utilisez le SDK IMA, l'identification des publicités par des badges est automatiquement prise en charge. Si vous n'utilisez pas ce SDK, les lecteurs vidéo doivent intégrer les paramètres VAST Icon et IconClickFallbackImage, conformément à la norme VAST de l'IAB.

Revenir à la vue sous forme de liste

Autres paramètres

En général, ces paramètres ne sont pas explicitement requis pour diffuser des annonces, mais ils peuvent l'être pour utiliser certaines fonctionnalités ou pour certains types d'implémentation.

ad_rule (règle relative aux annonces)

Description

Le paramètre de règle relative aux annonces (ad_rule) accepte une valeur constante qui indique s'il convient de renvoyer une création VAST ou une réponse de règle relative aux annonces.

Le paramètre par défaut pour les règles relatives aux annonces dépend d'un paramètre de réseau Google Ad Manager qui permet à toutes les demandes d'être des demandes de règles relatives aux annonces. Si le paramètre des réseaux est utilisé, vous n'avez pas besoin de définir ad_rule dans le tag d'emplacement d'annonce. Si vous souhaitez désactiver la fonctionnalité par demande d'annonce, vous pouvez définir ad_rule=0 pour remplacer le paramètre des réseaux. De plus, si aucune règle relative aux annonces n'est activée par défaut, vous pouvez en activer/désactiver en définissant respectivement ad_rule=1 et ad_rule=0.

Exemples d'utilisation

Si le paramètre des règles relatives aux annonces est désactivé :

  • Demande de création VAST :
    ad_rule=0 ou pas d'activation

Si le paramètre des règles relatives aux annonces est activé :

  • Demande de création VAST :
    ad_rule=0
  • Demande de règles relatives aux annonces (VMAP) :
    ad_rule=1 ou pas d'activation

Si vous choisissez de ne pas utiliser de règles relatives aux annonces, vous pouvez utiliser des paramètres de tag d'emplacement publicitaire pour indiquer la coupure publicitaire et la durée de la série d'annonces pour vos tags VAST à l'aide de pmnd, pmxd et pmad.

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces pour un type d'implémentation spécifique, il est nécessaire pour utiliser correctement les règles relatives aux annonces vidéo.

Revenir à la vue sous forme de liste

addtl_consent (consentement supplémentaire)

Description

Le paramètre de consentement supplémentaire (addtl_consent) accepte les valeurs variables. Il est utilisé par les éditeurs qui souhaitent intégrer la version 2.0 du TCF de l'IAB et qui utilisent un fournisseur ne figurant pas encore sur la liste globale des fournisseurs de l'IAB Europe, mais bien sur la liste des fournisseurs de technologie publicitaire de Google

Pour en savoir plus sur les valeurs transmises à ce paramètre, consultez la Spécification technique concernant le Mode Consentement supplémentaire de Google.

Exemple d'utilisation

addtl_consent=1~1.35.41.101

Revenir à la vue sous forme de liste

adtest (test de l'annonce)

Description

Le paramètre de test des annonces (adtest) doit être utilisé pour s'assurer que les requêtes utilisées pour tester l'inventaire des annonces de remplissage (non garanti) ne sont pas identifiées comme du trafic incorrect et n'ont pas d'impact sur les revenus.

Lorsque vous testez les annonces de remplissage, définissez ce paramètre sur Activé pour vous assurer qu'aucune annonce n'enregistre d'impressions ni de clics à utiliser pendant les tests. Définissez cette valeur sur Désactivé dans les environnements autres que les environnements de test pour une facturation normale. Si ce paramètre n'est pas configuré, il est défini par défaut sur Désactivé.

Remarque : Lorsque vous testez des éléments de campagne vendus directement, vous devez plutôt utiliser des éléments de campagne de test sans impact sur les revenus.

Exemples d'utilisation

Activé :
adtest=on

Désactivé :
adtest=off

Revenir à la vue sous forme de liste

ad_type (type d'annonce)

Description

Le paramètre de type d'annonce (ad_type) accepte une valeur constante qui indique les types d'annonces à renvoyer pour la requête.

Quand ad_type est défini sur audio ou audio_video, le paramètre vpmute doit être défini sur 0.

Exemples d'utilisation

Autorise uniquement les annonces audio :
ad_type=audio

Autorise les annonces vidéo désactivables et non désactivables :
ad_type=video

Autorise les annonces audio et vidéo :
ad_type=audio_video

Cette valeur audio_video permet aux deux formats d'entrer en concurrence, mais un seul est diffusé. Elle ne doit être utilisée que pour diffuser des créations vidéo dans des contenus audio compatibles avec la lecture d'annonces vidéo ou des créations audio dans des lecteurs vidéo InStream pour les contenus "écoutables" par nature, comme le sport, les flux, les vidéocasts, les actualités, etc. En savoir plus sur l'audio dans le contenu vidéo.

Autorise uniquement les annonces vidéo désactivables :
ad_type=skippablevideo

Autorise uniquement les annonces vidéo non désactivables :
ad_type=standardvideo

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio.

  • Si votre application contient du contenu vidéo, définissez ce paramètre sur video, audio_video ou laissez-le non défini.
  • Si votre application ne comporte que du contenu audio (par exemple, une application de radio ou de discours), vous devez définir ce paramètre sur audio. Faute de quoi, aucune annonce audio ne sera renvoyée.

Revenir à la vue sous forme de liste

afvsz (tailles d'annonces non linéaires)

Description

Le paramètre de tailles d'annonces non linéaires (afvsz) accepte des valeurs constantes sous la forme d'une liste de tailles d'annonces non linéaires séparées par une virgule qui peuvent être affichées dans l'espace publicitaire vidéo.

Ces tailles doivent correspondre à l'une des tailles acceptées suivantes :

  • 200 x 200
  • 250 x 250
  • 300 x 250
  • 336 x 280
  • 450 x 50
  • 468 x 60
  • 480 x 90
  • 729 x 90

Lorsque vous utilisez le SDK IMA, ce champ est remplacé et rempli avec toutes les tailles acceptées pour les paramètres nonLinearAdSlotWidth et nonLinearAdSlotHeight.

Ce paramètre peut être omis ou laissé vide lorsqu'aucune taille non linéaire n'est acceptée.

Exemples d'utilisation

Toutes les tailles sont acceptées :
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90

La largeur maximale est de 250 :
afvsz=200x200,250x250

La hauteur maximale est de 60 :
afvsz=450x50,468x60

La largeur maximale est de 100 :
//empty; no values supported

Conditions requises et recommandations

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation ou de transaction visé, mais il est obligatoire pour diffuser des annonces vidéo non linéaires si vous n'utilisez pas le SDK IMA.

Revenir à la vue sous forme de liste

allcues (tous les repères)

Description

Le paramètre correspondant l'ensemble des repères (allcues) accepte des valeurs variables qui correspondent à une liste de points de repère séparés par une virgule, en millisecondes. Pour chaque valeur, Google Ad Manager renvoie une coupure publicitaire.

  • Les paramètres vid_d et allcues servent à diffuser des annonces mid-roll sans ingestion de contenu.
  • Les règles relatives aux annonces sont aussi requises pour renvoyer des annonces vidéo mid-roll. Si vous avez défini des repères temporels dans vos règles relatives aux annonces (par exemple, "Toutes les n seconde(s)" ou "À des moments précis"), ce sont eux qui sont utilisés. Les repères transmis dans le paramètre allcues sont ignorés. Pour les annonces mid-roll, le paramètre de durée vid_d reste obligatoire et doit être transmis.

Exemples d'utilisation

Points de repère à 10 et 20 secondes :
allcues=10000,20000

Revenir à la vue sous forme de liste

ciu_szs (tailles des annonces associées)

Description

Le paramètre de tailles associées (ciu_szs) accepte des valeurs variables qui doivent correspondre à une liste de tailles associées séparées par une virgule.

Les valeurs séparées par une barre verticale (|) indiquent un espace publicitaire multitaille.

Exemples d'utilisation

ciu_szs=728x90,300x250

Tailles avec un emplacement multitaille :
ciu_szs=728x90,300x200|300x250

Revenir à la vue sous forme de liste

cmsid (ID de la source de contenu)

Description

Les paramètres ID de la source de contenu (cmsid) et ID vidéo (vid) acceptent les valeurs de variable

Pour cibler du contenu vidéo avec des annonces, votre tag vidéo maître doit inclure ces paramètres simultanément.

  • Le paramètre cmsid est un numéro unique attribué à chaque source de contenu. Pour le repérer dans Google Ad Manager, cliquez sur Vidéo, puis sur Sources de contenu, puis sur le nom de la source.
  • Le paramètre vid est une chaîne ou un numéro qui identifie une vidéo spécifique. Cet identifiant est attribué par le système de gestion de contenu qui héberge votre contenu. Pour le repérer dans Google Ad Manager, cliquez sur Vidéo, puis sur Contenu, puis sur le contenu vidéo spécifique.

Exemples d'utilisation

cmsid=[valeur]&vid=[valeur]

Si vous créez un tag pour la vidéo à la demande avec insertion dynamique d'annonces, il est conseillé d'utiliser les macros qui insèrent dynamiquement la source de contenu et l'ID vidéo appropriés. 

Par exemple : cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Conditions requises et recommandations

Bien que ces paramètres ne soient pas obligatoires pour diffuser des annonces pour un type d'implémentation ou de transaction spécifiques, ils sont obligatoires pour utiliser le ciblage de contenu vidéo.

Revenir à la vue sous forme de liste

cust_params (paramètres personnalisés)

Description

Le paramètre personnalisé (cust_params) accepte des valeurs variables qui sont des paires clé-valeur qui vous permettent de définir un ciblage spécifique, tel que les données démographiques, certaines positions sur une page, ou une ou plusieurs pages données.

Exemples d'utilisation

Découvrez des exemples d'ajout de paires clé-valeur.

Revenir à la vue sous forme de liste

excl_cat (catégorie d'exclusion)

Description

Le paramètre de catégorie d'exclusion (excl_cat) accepte des valeurs variables et sert à bloquer des éléments de campagne contenant le libellé d'exclusion dans la demande d'annonce. Utilisez le paramètre cust_params pour définir la catégorie d'exclusion et les libellés d'exclusion.

Exemples d'utilisation

Pour définir une catégorie d'exclusion pour deux libellés d'exclusion (airline_excl_label et train_excl_label), séparez les libellés à l'aide d'une barre verticale (|) :

  • excl_cat=airline_excl_label%7Ctrain_excl_label

Appliquez ensuite l'encodage d'URL et utilisez la chaîne encodée dans cust_params :

  • &cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label

Revenir à la vue sous forme de liste

gdpr (RGPD)

Description

Le paramètre RGPD (gdpr) accepte les valeurs constantes et est utilisé par les éditeurs qui souhaitent intégrer la version 2.0 du TCF de l'IAB. Les demandes VAST directes ne lisent pas automatiquement les valeurs, mais elles sont acceptées lorsqu'elles sont ajoutées aux tags d'emplacement publicitaire.

Seules 0 et 1 sont des valeurs valides pour ce paramètre, où 0 signifie que le RGPD ne s'applique pas et 1 signifie qu'il s'applique. Si le RGPD s'applique, vous devez également fournir une chaîne TC (Transparency & Consent) valide à l'aide du paramètre gdpr_consent.

Pour en savoir plus sur les valeurs transmises à ce paramètre, consultez les conseils généraux d'implémentation du framework ou la section consacrée à la chaîne TC de la version 2.0 du TCF de l'IAB.

Exemples d'utilisation

Le RGPD s'applique :
gdpr=1

Le RGPD ne s'applique pas :
gdpr=0

Revenir à la vue sous forme de liste

gdpr_consent (consentement RGPD)

Description

Le paramètre de consentement RGPD (gdpr_consent) accepte les valeurs variables et est utilisé par les éditeurs qui souhaitent intégrer la version 2.0 du TCF de l'IAB. Les demandes VAST directes ne lisent pas automatiquement les valeurs, mais elles sont acceptées lorsqu'elles sont ajoutées aux tags d'emplacement publicitaire.

Pour en savoir plus sur les valeurs transmises à ce paramètre, consultez les conseils généraux d'implémentation du framework ou la section consacrée à la chaîne TC de la version 2.0 du TCF de l'IAB.

Exemples d'utilisation

gdpr_consent=GDPR_CONSENT_123

Revenir à la vue sous forme de liste

iabexcl (URL d'exclusion de l'IAB)

Description

Le paramètre d'URL d'exclusion de l'IAB (iabexcl) accepte des valeurs variables, qui correspondent à une liste de catégories séparées par une virgule.

Exemples d'utilisation

iabexcl=3,14,527 exclut les catégories "Camions commerciaux", "Véhicules tout terrain" et "Rugby".

Vous pouvez télécharger la liste des catégories de la taxonomie de contenu de l'IAB et leurs ID.

Revenir à la vue sous forme de liste

idtype (Type d'appareil)

Description

Les paramètres d'identifiants d'appareil réinitialisables (rdid, idtype et is_lat) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).

Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid, idtype et is_lat.

Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil

La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.

Avertissement

Depuis iOS 14.5, Apple a abandonné le signal LAT.À la place, Google s'appuie sur la présence d'un IDFA non nul, qui indique que l'utilisateur a accepté le suivi sur les versions d'iOS compatibles avec App Tracking Transparency. Vous devez donc ajouter un UserAgent valide indiquant la version correcte du système d'exploitation.

Exemples d'utilisation

Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ces paramètres ne sont pas obligatoires pour diffuser des annonces, quel que soit le type d'implémentation visé, mais ils sont obligatoires pour la monétisation programmatique des annonces pour les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Pour les implémentations sur le Web, les identifiants d'appareil réinitialisables ne sont pas utilisés.

Utilisation du SDK

Avec le SDK IMA, ces paramètres sont transmis automatiquement. Les éditeurs qui utilisent le SDK PAL doivent les transmettre manuellement.

Revenir à la vue sous forme de liste

ipd (domaine du partenaire d'inventaire)

Description

Le paramètre de domaine du partenaire d'inventaire (ipd) accepte des valeurs variables qui doivent être définies sur les déclarations inventorypartnerdomain du fichier app-ads.txt (ou ads.txt).

Le paramètre inventorypartnerdomain (IPD) est une spécification de l'IAB qui permet aux éditeurs de désigner le domaine d'un partenaire de partage d'inventaire pour valider le fichier ads.txt/app-ads.txt.

La déclaration IPD est particulièrement importante dans les cas d'utilisation de partage d'inventaire où l'inventaire publicitaire dont provient une demande peut être détenu par un autre partenaire (le partenaire de partage d'inventaire).

En savoir plus sur les fichiers ads.txt/app-ads.txt et les partenaires de partage d'inventaire

Exemples d'utilisation

Le inventorypartnerdomain se trouve dans le fichier app-ads.txt qui pointe vers le fichier .txt du partenaire pouvant monétiser l'inventaire. La valeur du paramètre ipd doit correspondre à une valeur du fichier app-ads.txt reprise sous l'un des éléments inventorypartnerdomain.

Conditions requises et recommandations

Ce paramètre est obligatoire pour les éditeurs qui monétisent un inventaire qui ne leur appartient pas.

Revenir à la vue sous forme de liste

ipe (entité qui pingue les impressions)

Description

Le paramètre de l'entité qui pingue les impressions (ipe) accepte une valeur constante qui permet d'indiquer les pings d'impression et les conversions provenant du serveur, pas du client. 

L'entité de ping d'impression est utilisée lorsqu'un serveur envoie des pings/balises d'impression depuis le serveur. 

Exemples d'utilisation

Balisage côté serveur :
ipe=ssb

Revenir à la vue sous forme de liste

is_lat (suivi publicitaire limité)

Description

Les paramètres d'identifiants d'appareil réinitialisables (rdid, idtype et is_lat) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).

Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid, idtype et is_lat.

Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil

La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.

Avertissement

Depuis iOS 14.5, Apple a abandonné le signal LAT.À la place, Google s'appuie sur la présence d'un IDFA non nul, qui indique que l'utilisateur a accepté le suivi sur les versions d'iOS compatibles avec App Tracking Transparency. Vous devez donc ajouter un UserAgent valide indiquant la version correcte du système d'exploitation.

Exemples d'utilisation

Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ces paramètres ne sont pas obligatoires pour diffuser des annonces, quel que soit le type d'implémentation visé, mais ils sont obligatoires pour la monétisation programmatique des annonces pour les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Pour les implémentations sur le Web, les identifiants d'appareil réinitialisables ne sont pas utilisés.

Utilisation du SDK

Avec le SDK IMA, ces paramètres sont transmis automatiquement. Les éditeurs qui utilisent le SDK PAL doivent les transmettre manuellement.

Revenir à la vue sous forme de liste

lip (dernière position dans une série d'annonces)

Description

Le paramètre de dernière position dans une série d'annonces (lip) accepte une valeur constante pour indiquer une demande issue de la dernière position d'une série d'annonces à des fins de ciblage ou de création de rapports.

Remarque: Ce paramètre ne s'applique pas aux séries d'annonces optimisées et est ignoré s'il est utilisé.

Exemples d'utilisation

lip=1

Revenir à la vue sous forme de liste

ltd (annonces limitées)

Description

Le paramètre d'annonces limitées (ltd) accepte une valeur constante qui indique s'il faut diffuser des annonces de façon limitée en l'absence de consentement des utilisateurs concernant l'utilisation des cookies ou d'autres identifiants locaux.

Ce paramètre permet d'indiquer une demande d'annonces limitées. Il est différent du paramètre is_lat. Il désactive la personnalisation et l'utilisation d'identifiants à ces fins.

Contrairement aux autres paramètres d'URL, le paramètre ltd=1 modifie le comportement du SDK IMA de sorte qu'il traite la demande comme étant sans ID et interdise le stockage.

Exemples d'utilisation

ltd=1

Revenir à la vue sous forme de liste

max_ad_duration (durée maximale de l'annonce)

Description

Les paramètres de durée minimale de l'annonce (min_ad_duration) et de durée maximale de l'annonce (max_ad_duration) acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une annonce.

Ce paramètre peut être utilisé pour limiter les créations à une durée requise dans le tag d'emplacement publicitaire pour les annonces uniques ou les demandes de séries d'annonces optimisées.

Exemples d'utilisation

min_ad_duration=15000&max_ad_duration=30000

Revenir à la vue sous forme de liste

min_ad_duration (durée minimale de l'annonce)

Description

Les paramètres de durée minimale de l'annonce (min_ad_duration) et de durée maximale de l'annonce (max_ad_duration) acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une annonce.

Ce paramètre peut être utilisé pour limiter les créations à une durée requise dans le tag d'emplacement publicitaire pour les annonces uniques ou les demandes de séries d'annonces optimisées.

Exemples d'utilisation

min_ad_duration=15000&max_ad_duration=30000

Revenir à la vue sous forme de liste

mridx (numéro d'annonce vidéo mid-roll)

Description

Le paramètre de numéro d'annonce vidéo mid-roll (mridx) accepte une valeur variable qui indique le numéro ordinal de l'annonce vidéo mid-roll (par exemple, annonce vidéo mid-roll 1, annonce vidéo mid-roll 2, etc.).

Exemples d'utilisation

mridx=2

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces auprès d'une implémentation ou d'un type de transaction spécifique, il est nécessaire pour cibler une annonce mid-roll spécifique, créer des rapports sur celle-ci et effectuer des prévisions la concernant.

Revenir à la vue sous forme de liste

nofb (pas de remplacement)

Description

Le paramètre "Pas de remplacement" (nofb) accepte une valeur constante pour indiquer que la demande d'annonce ne doit pas renvoyer de playlist d'annonces vidéo de remplacement.

Exemples d'utilisation

Création de remplacement désactivée :
nofb=1

Vous pouvez désactiver les créations de remplacement pour une seule annonce et les annonces indépendantes pour les séries d'annonces optimisées par demande d'annonce en transmettant nofb=1.

Revenir à la vue sous forme de liste

npa (annonce non personnalisée)

Description

Le paramètre d'annonces non personnalisées (npa) accepte une valeur constante pour indiquer que la demande d'annonce doit être traitée comme étant non personnalisée.

Vous devez soit définir spécifiquement le paramètre npa=1, soit inclure simplement npa (sans valeur définie) pour ajouter un tag à la demande en tant que demande non personnalisée. Les demandes d'annonces qui n'incluent pas ce paramètre ou pour lesquelles il est configuré sur npa=0 utilisent par défaut des annonces personnalisées.

Exemples d'utilisation

Annonces non personnalisées:
npa=1

Conditions requises et recommandations

Ce paramètre n'est obligatoire que si l'utilisateur désactive la personnalisation. Les éditeurs doivent s'assurer de représenter l'état exact de l'utilisateur lorsqu'ils contrôlent cet état.

Revenir à la vue sous forme de liste

paln (nonce de la bibliothèque d'accès programmatique, ancien)

Description

Pour les intégrations qui utilisent Programmatic Access Library (PAL), le paramètre nonce vidéo accepte une valeur de chaîne variable.

Le nonce est adapté aux URL. Vous n'avez pas besoin de l'encoder en URL.

Remarque : Si vous avez déjà fourni un nonce à l'aide de l'ancien paramètre paln, nous vous recommandons vivement de passer au paramètre givn et d'arrêter d'envoyer paln. N'incluez pas les deux paramètres.

Exemples d'utilisation

Pour en savoir plus sur la valeur transmise à ce paramètre, consultez les guides de démarrage de PAL.

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.

Revenir à la vue sous forme de liste

pmad (nombre maximal d'annonces pour la série d'annonces)

Description

Le paramètre de nombre maximal d'annonces dans une série d'annonces (pmad) accepte une valeur variable qui indique le nombre maximal d'annonces dans une série d'annonces.

Ce paramètre limite le nombre total d'annonces dans une série d'annonces optimisée, une fonctionnalité disponible pour les éditeurs disposant d'un package vidéo avancé.

Ce paramètre ne doit pas être utilisé pour les annonces VMAP (avec le paramètre ad_rule=1).

Exemples d'utilisation

pmad=4

Revenir à la vue sous forme de liste

pmnd (durée minimale de la série d'annonces)

Description

Les paramètres de durée minimale (pmnd) et de durée maximale (pmxd) d'une série d'annonces acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une série d'annonces.

Ces paramètres permettent de demander plusieurs annonces dans une série d'annonces optimisée, une fonctionnalité disponible pour les éditeurs disposant d'un package vidéo avancé. Lorsque des règles d'annonces sont utilisées, Google Ad Manager ajoute automatiquement ces informations.

Ce paramètre ne doit pas être utilisé pour les annonces VMAP (avec le paramètre ad_rule=1).

Exemples d'utilisation

pmnd=0&pmxd=60000

Revenir à la vue sous forme de liste

pmxd (durée maximale de la série d'annonces)

Description

Les paramètres de durée minimale (pmnd) et de durée maximale (pmxd) d'une série d'annonces acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une série d'annonces.

Ces paramètres permettent de demander plusieurs annonces dans une série d'annonces optimisée, une fonctionnalité disponible pour les éditeurs disposant d'un package vidéo avancé. Lorsque des règles d'annonces sont utilisées, Google Ad Manager ajoute automatiquement ces informations.

Ce paramètre ne doit pas être utilisé pour les annonces VMAP (avec le paramètre ad_rule=1).

Exemples d'utilisation

pmnd=0&pmxd=60000

Revenir à la vue sous forme de liste

pmxfwt (durée de visionnage forcée maximale de la série d'annonces)

Description

Le paramètre de durée de visionnage forcée maximale de la série d'annonces (pmxfwt) accepte une valeur variable qui spécifie la durée maximale non désactivable d'une série d'annonces, en millisecondes.

Si vous acceptez les séries d'annonces vidéo composées d'annonces non désactivables et désactivables et que vous souhaitez limiter la durée des annonces pour les utilisateurs, utilisez ce paramètre pour définir la durée maximale de visionnage d'annonce non désactivable pour l'utilisateur.

Remarque : Le paramètre de durée maximale des séries d'annonces (pmxd) remplace ce paramètre pour la définition de la durée totale maximale de la série d'annonces (y compris la durée complète des annonces désactivables).

Exemple d'utilisation

pmxfwt=30000

Revenir à la vue sous forme de liste

pod (numéro de série d'annonces)

Description

Le paramètre de numéro de série d'annonces (pod) accepte une valeur variable qui représente le nombre ordinal de la série d'annonces (par exemple, série d'annonces 1, série d'annonces 2, etc.).

Exemples d'utilisation

pod=3

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces auprès d'une implémentation ou d'un type de transaction spécifique, il est nécessaire pour permettre la diffusion de la même annonce dans différents séries d'annonces, et pour utiliser correctement les exclusions réciproques, la limitation de la fréquence d'exposition et les fonctionnalités associées.

Revenir à la vue sous forme de liste

pp (profil de création)

Description

Le paramètre de profil de création (pp) accepte une valeur variable qui contrôle les créations éligibles pour une diffusion basée sur la configuration définie dans un profil de création audio et vidéo.

Exemples d'utilisation

pp=creative_profile

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces auprès d'une implémentation spécifique, il est nécessaire pour limiter les fichiers multimédias des créations hébergées Google Ad Manager avec des profils de création vidéo et audio. Pour les redirections ou les annonces programmatiques, cette option permet de s'assurer que l'exigence est disponible, mais ne limite pas les fichiers multimédias à ceux sélectionnés dans le profil de la création.

Revenir à la vue sous forme de liste

ppt (traitement de la confidentialité pour les éditeurs)

Description

Le paramètre "Traitement de la confidentialité pour les éditeurs" (ppt) accepte une valeur constante qui est utilisée pour indiquer s'il faut désactiver la personnalisation des annonces pour la demande d'annonce.

Ce paramètre permet d'appliquer des annonces non personnalisées qui peuvent différer de npa=1 et rdp=1. Il affecte à la fois les réservations et la demande programmatique.

En savoir plus sur le Traitement de la confidentialité pour les éditeurs

Exemples d'utilisation

Désactiver la personnalisation des annonces:
ppt=1

Revenir à la vue sous forme de liste

ppid (identifiant fourni par l'éditeur)

Description

Le paramètre PPID (identifiant fourni par l'éditeur) accepte une valeur variable qui est utilisée pour la limitation de la fréquence d'exposition, la segmentation de l'audience, le ciblage, la rotation séquentielle des annonces et d'autres commandes de diffusion des annonces en fonction de l'audience sur les différents types d'appareils.

En savoir plus sur les identifiants fournis par l'éditeur

Exemples d'utilisation

ppid=12JD92JD8078S8J29SDOAKC0EF230337

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces auprès d'une implémentation ou d'un type de transaction spécifique, vous devez utiliser un identifiant cohérent, indépendant de la plate-forme. Il peut être utilisé lorsque d'autres identifiants ne sont pas présents et peut être fourni aux acheteurs.

Revenir à la vue sous forme de liste

ppos (position dans la série d'annonces)

Description

Le paramètre de position dans une série d'annonces (ppos) accepte une valeur variable qui représente la position dans une série d'annonces (par exemple, position 1, position 2, etc.).

Ce paramètre ne s'applique qu'aux séries d'annonces standards. Il est nécessaire pour la diffusion automatique d'une annonce associée. Lorsque vous utilisez des règles relatives aux annonces, Google Ad Manager ajoute automatiquement ces informations.

Exemples d'utilisation

ppos=2

Conditions requises et recommandations

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces auprès d'une implémentation ou d'un type de transaction spécifique, il est obligatoire pour les séries d'annonces standards lorsque le ciblage par position est nécessaire, ainsi que pour les prévisions et les rapports sur les séries d'annonces standards. Il est également nécessaire pour utiliser correctement les exclusions réciproques, la limitation de la fréquence d'exposition et les fonctionnalités connexes.

Revenir à la vue sous forme de liste

ppsj (JSON des signaux fournis par l'éditeur)

Description

Le paramètre JSON des signaux fournis par l'éditeur (ppsj) accepte une valeur variable, qui est un objet JSON encodé en base64 contenant des données d'audience et contextuelles fournies par l'éditeur pour améliorer la monétisation programmatique. 

Ce paramètre peut être utilisé pour envoyer certains signaux aux acheteurs/enchérisseurs.

En savoir plus sur les signaux fournis par l'éditeur et les taxonomies compatibles

Exemples d'utilisation

Objet JSON :
{
 "PublisherProvidedTaxonomySignals": [{
   "taxonomy": "IAB_AUDIENCE_1_1",
   "values": ["6", "284"]
 }]
}

Appliquer la valeur encodée en base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ

Pour en savoir plus sur les paires clé-valeur JSON valides, consultez l'
exemple de SDK IMA pour HTML5.

Revenir à la vue sous forme de liste

ptpl (ID du modèle de coupure publicitaire)

Description

Les paramètres d'ID (ptpl) et de nom (ptpln) du modèle de coupure publicitaire acceptent des valeurs variables qui permettent d'indiquer quel modèle de coupure publicitaire doit s'appliquer à la demande de série d'annonces optimisée.

Les modèles de coupures publicitaires vous permettent de définir les emplacements publicitaires ou les emplacements publicitaires personnalisés que vous souhaitez inclure dans une coupure publicitaire, ainsi que leur ordre de diffusion.

Un seul de ces paramètres est requis pour demander un modèle de coupure publicitaire.

Exemples d'utilisation

Découvrez comment configurer et demander des modèles de coupures publicitaires.

Conditions requises et recommandations

Ces paramètres ne sont requis que si vous demandez directement un modèle de coupure publicitaire.

Revenir à la vue sous forme de liste

ptpln (nom du modèle de coupure publicitaire)

Description

Les paramètres d'ID (ptpl) et de nom (ptpln) du modèle de coupure publicitaire acceptent des valeurs variables qui permettent d'indiquer quel modèle de coupure publicitaire doit s'appliquer à la demande de série d'annonces optimisée.

Les modèles de coupures publicitaires vous permettent de définir les emplacements publicitaires ou les emplacements publicitaires personnalisés que vous souhaitez inclure dans une coupure publicitaire, ainsi que leur ordre de diffusion.

Un seul de ces paramètres est requis pour demander un modèle de coupure publicitaire.

Exemples d'utilisation

Découvrez comment configurer et demander des modèles de coupures publicitaires.

Conditions requises et recommandations

Ces paramètres ne sont requis que si vous demandez directement un modèle de coupure publicitaire.

Revenir à la vue sous forme de liste

pubf (prix planchers publics dans les tags Ad Exchange)

Description

Le prix plancher public pour le paramètre Ad Exchange (pubf) et le prix plancher privé pour le paramètre Ad Exchange (pvtf) acceptent des valeurs variables qui permettent d'ajouter des prix planchers aux tags Ad Exchange.

Ces paramètres équivaut à google_ad_public_floor et google_ad_private_floor.

Exemples d'utilisation

Prix plancher public:
pubf=123

Prix plancher privé:
pvtf=123

Conditions requises et recommandations

Ces paramètres ne sont disponibles que pour les éditeurs situés dans l'Espace économique européen (EEE) ou en Suisse qui ont été autorisés à utiliser la fonctionnalité "Prix plancher".

Découvrez comment envoyer une demande.

Revenir à la vue sous forme de liste

pvid (ID du groupe d'applications)

Description

Le paramètre d'ID de groupe d'applications (pvid) accepte une valeur variable définie sur l'ID du groupe d'applications Android, tandis que le paramètre de champ d'application du groupe d'applications (pvid_s) accepte une valeur constante qui représente le champ d'application de l'ID du groupe d'applications (scope_app ou scope_developer).

Consultez la documentation Android sur la manière de récupérer l'ID du groupe d'applications.

Exemples d'utilisation

pvid=[AppSetID_value]

pvid_s=scope_app

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique dans une application mobile sur des appareils Android.

Utilisation du SDK

Bien que le SDK IMA/PAL transmette automatiquement ce champ, les éditeurs qui n'utilisent pas le SDK doivent appeler le SDK du groupe d'applications et transférer ces paramètres manuellement lors de la demande d'annonce.

Revenir à la vue sous forme de liste

pvid_s (champ d'application du groupe d'applications)

Description

Le paramètre d'ID de groupe d'applications (pvid) accepte une valeur variable définie sur l'ID du groupe d'applications Android, tandis que le paramètre de champ d'application du groupe d'applications (pvid_s) accepte une valeur constante qui représente le champ d'application de l'ID du groupe d'applications (scope_app ou scope_developer).

Consultez la documentation Android sur la manière de récupérer l'ID du groupe d'applications.

Exemples d'utilisation

pvid=[AppSetID_value]

pvid_s=scope_app

Conditions requises et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile.

Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique dans une application mobile sur des appareils Android.

Utilisation du SDK

Bien que le SDK IMA/PAL transmette automatiquement ce champ, les éditeurs qui n'utilisent pas le SDK doivent appeler le SDK du groupe d'applications et transférer ces paramètres manuellement lors de la demande d'annonce.

Revenir à la vue sous forme de liste

pvtf (prix planchers privés dans les tags Ad Exchange)

Description

Le prix plancher public pour le paramètre Ad Exchange (pubf) et le prix plancher privé pour le paramètre Ad Exchange (pvtf) acceptent des valeurs variables qui permettent d'ajouter des prix planchers aux tags Ad Exchange.

Ces paramètres équivaut à google_ad_public_floor et google_ad_private_floor.

Exemples d'utilisation

Prix plancher public:
pubf=123

Prix plancher privé:
pvtf=123

Conditions requises et recommandations

Ces paramètres ne sont disponibles que pour les éditeurs situés dans l'Espace économique européen (EEE) ou en Suisse qui ont été autorisés à utiliser la fonctionnalité "Prix plancher".

Découvrez comment envoyer une demande.

Revenir à la vue sous forme de liste

rdp (traitement restreint des données)

Description

Le paramètre de traitement restreint des données (rdp) accepte une valeur constante qui indique que la demande d'annonce doit restreindre le traitement des données.

Vous pouvez restreindre le traitement des données au niveau du réseau en activant le paramètre réseau Traitement restreint des données.

Exemples d'utilisation

Restreindre le traitement des données :
rdp=1 ou rdp (sans valeur définie)

Ne pas restreindre le traitement des données :
rdp=0

Revenir à la vue sous forme de liste

schain (chaîne d'approvisionnement)

Description

Le paramètre de chaîne d'approvisionnement (schain) accepte une valeur variable qui doit être un objet SupplyChain sérialisé. Lorsque ce paramètre est utilisé, Google ajoute un nœud à tous les objets schain reçus avant de les envoyer aux acheteurs.

Consultez la documentation complète de l'IAB pour en savoir plus sur la communication des informations sur l'objet SupplyChain au moyen d'un tag (plutôt qu'avec OpenRTB).

Voir les exigences pour une analyse correcte de schain

Conformément à la documentation de l'IAB, le code suivant définit la sérialisation de l'objet SupplyChain :

  • Les propriétés {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject et SupplyChainNode sont séparées par des virgules afin que les champs facultatifs puissent être omis et que ces séparateurs puissent éventuellement être exclus.
  • Chaque élément SupplyChainNode est séparé par un signe !.
  • Si la valeur d'une propriété contient des caractères nécessitant un encodage sous forme d'URL (, ou !, par exemple), elle doit être encodée sous forme d'URL avant la sérialisation.

Ordre de sérialisation

Les propriétés SupplyChainObject sont sérialisées dans cet ordre :

ver,complete

Les propriétés SupplyChainNode sont sérialisées dans cet ordre :

asi,sid,hp,rid,name,domain,ext

Remarque : Le contenu de la propriété ext est propre à la place de marché. Google Ad Manager n'analyse pas cette propriété.

Exemples de sérialisation de l'objet SupplyChain

Voici deux exemples de sérialisation de l'objet SupplyChain ci-dessus :

Sérialisation avec des virgules pour les champs facultatifs vides

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Sérialisation sans virgules pour les champs facultatifs vides

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

En savoir plus sur l'objet SupplyChain

Exemples d'utilisation

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Si la propriété asi avait la valeur exchange,1, la sérialisation avec des caractères d'échappement se présenterait comme suit :

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Exigences et recommandations

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation ou de transaction visé, mais il est obligatoire lorsque les éditeurs utilisent des intermédiaires de paiement en amont de la demande envoyée à Google Ad Manager. Cela inclut les éditeurs qui utilisent la technologie d'ad server tiers.

Revenir à la vue sous forme de liste

scor (corrélateur de flux)

Description

Le paramètre de corrélateur de flux (scor) accepte une valeur variable qui doit être un entier généré pour chaque flux vidéo.

Les paramètres score et correlator n'ont pas obligatoirement la même valeur entière. Toutefois, ils doivent conserver leurs valeurs respectives tout au long de la lecture de chaque flux vidéo pour identifier une session de visionnage unique.

Exemples d'utilisation

scor=17

Exigences et recommandations

Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour le Web mobile. Cliquez ici pour afficher la liste des paramètres VAST obligatoires ou recommandés pour la TV connectée. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour l'audio. Cliquez ici pour consulter la liste des paramètres VAST obligatoires ou recommandés pour la publicité extérieure numérique.

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation ou de transaction visé, mais il est recommandé pour diffuser des annonces pour le Web, les applications mobiles, la TV connectée, l'audio et la publicité extérieure numérique.

Ce paramètre est utilisé pour les exclusions réciproques, la limitation de la fréquence d'exposition et les fonctionnalités connexes lorsqu'un utilisateur regarde plusieurs vidéos sur la même page.

Revenir à la vue sous forme de liste

sdk_apis (cadre de l'API du SDK)

Description

Le paramètre de framework de l'API du SDK (sdk_apis) accepte une liste de valeurs entières constantes séparées par une virgule. Ces valeurs indiquent tous les frameworks de l'API qui sont compatibles avec le lecteur.

Exemples d'utilisation

sdk_apis=2,7,9

Consultez la liste des valeurs possibles pour le framework de l'API.

Exigences et recommandations

Utilisation du SDK

Ce paramètre est destiné aux éditeurs qui utilisent le SDK PAL (Programmatic Access Library). Si vous utilisez le SDK IMA et que vous tentez de définir des valeurs pour ce paramètre, elles seront remplacées par celles acceptées par le SDK IMA.

Revenir à la vue sous forme de liste

sdmax (durée max. des annonces désactivables)

Description

Le paramètre de durée maximale des annonces désactivables (sdmax) accepte une valeur variable qui permet aux éditeurs de spécifier la durée maximale souhaitée pour les annonces désactivables.

Cette durée, exprimée en millisecondes, représente la limite supérieure autorisée pour la durée des créations vidéo/audio désactivables pour la demande d'annonce spécifique.

Utilisez le paramètre sdmax indépendamment pour les annonces désactivables, ou conjointement avec le paramètre max_ad_duration existant si vous souhaitez définir des durées maximales différentes pour les annonces désactivables et non désactivables.

Exemples d'utilisation

Définition des paramètres suivants :

  • max_ad_duration = 15 000 (15 secondes)
  • sdmax = 45 000 (45 secondes)

Pour ces créations :

  • Création A : non désactivable ; 30 s
  • Création B : désactivable ; 30 s

Résultats :

  • La création A sera filtrée, car elle n'est pas désactivable, et sa durée dépasse la durée maximale pour les annonces non désactivables.
  • La création B ne sera pas filtrée, car même si sa durée est supérieure à la durée maximale (max_ad_duration), elle est désactivable, et sa durée ne dépasse pas la durée maximale pour les annonces désactivables.

Revenir à la vue sous forme de liste

ssss (source d'assemblage côté serveur)

Description

Le paramètre de source d'assemblage côté serveur (ssss) accepte une valeur constante qui doit être définie sur une valeur reconnue et fournie par Google pour votre fournisseur de technologie d'assemblage vidéo.

Google attribue cette valeur aux fournisseurs de technologie d'assemblage vidéo qui utilisent des intégrations de serveur à serveur avec Google, et ils peuvent vous la fournir. Si vous avez des questions sur la valeur à définir pour ce paramètre, vous pouvez contacter votre responsable de compte Google.

Exemples d'utilisation

ssss=mystitcher

Exigences et recommandations

Ce paramètre n'est pas obligatoire pour diffuser des annonces, quel que soit le type d'implémentation visé, mais il est obligatoire pour utiliser des implémentations côté serveur.

Revenir à la vue sous forme de liste

tfcd (tag pour les contenus destinés aux enfants)

Description

Le paramètre de traitement adapté au contenu destiné aux enfants (tfcd) accepte une valeur constante qui indique que la demande doit être traitée comme étant destinée aux enfants.

Exemples d'utilisation

tfcd=1

Revenir à la vue sous forme de liste

trt (type de trafic)

Description

Le paramètre de type de trafic (trt) accepte une valeur constante qui sert à faire une demande de trafic généré par les liens commerciaux ou par les résultats naturels.

Exemples d'utilisation

Demande de trafic généré par les liens commerciaux :
trt=1

Demande de trafic généré par les résultats naturels :
trt=2

Exigences et recommandations

Utilisation du SDK

Le SDK IMA n'insère pas de valeur par défaut s'il manque le paramètre de type de trafic dans une demande. Dans ce cas, le serveur fournit la valeur par défaut 0 (trafic indéfini).

Revenir à la vue sous forme de liste

us_privacy (confidentialité de l'IAB aux États-Unis)

Description

La chaîne us_national a été abandonnée par l'IAB au profit de la GPP. Toutefois, Ad Manager continue de lire et de respecter la chaîne si elle est transmise pour assurer la rétrocompatibilité. Nous recommandons aux éditeurs de consulter la GPP ou d'autres paramètres de confidentialité et de cesser d'utiliser us_national.

Revenir à la vue sous forme de liste

vad_type (type d'annonce vidéo)

Description

Le paramètre de type de l'annonce vidéo (vad_type) accepte une valeur constante qui indique si une annonce linéaire ou non linéaire doit être renvoyée.

Exemples d'utilisation

Renvoyer une annonce linéaire :
vad_type=linear

Renvoyer une annonce non linéaire :
vad_type=nonlinear

Revenir à la vue sous forme de liste

vid (ID vidéo)

Description

Les paramètres ID de la source de contenu (cmsid) et ID vidéo (vid) acceptent les valeurs de variable

Pour cibler du contenu vidéo avec des annonces, votre tag vidéo maître doit inclure ces paramètres simultanément.

  • Le paramètre cmsid est un numéro unique attribué à chaque source de contenu. Pour le repérer dans Google Ad Manager, cliquez sur Vidéo, puis sur Sources de contenu, puis sur le nom de la source.
  • Le paramètre vid est une chaîne ou un numéro qui identifie une vidéo spécifique. Cet identifiant est attribué par le système de gestion de contenu qui héberge votre contenu. Pour le repérer dans Google Ad Manager, cliquez sur Vidéo, puis sur Contenu, puis sur le contenu vidéo spécifique.

Exemples d'utilisation

cmsid=[valeur]&vid=[valeur]

Si vous créez un tag pour la vidéo à la demande avec insertion dynamique d'annonces, il est conseillé d'utiliser les macros qui insèrent dynamiquement la source de contenu et l'ID vidéo appropriés. 

Par exemple : cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Conditions requises et recommandations

Bien que ces paramètres ne soient pas obligatoires pour diffuser des annonces pour un type d'implémentation ou de transaction spécifiques, ils sont obligatoires pour utiliser le ciblage de contenu vidéo.

Revenir à la vue sous forme de liste

vpi (playlist vidéo intégrée)

Description

Le paramètre d'intégration de la playlist vidéo (vpi) accepte une valeur constante qui indique s'il faut diffuser un VMAP intégré (renvoyer VAST dans VMAP).

En plus de réduire la latence, ce paramètre permet de garantir les limites de la fréquence d'exposition et les exclusions réciproques dans un flux vidéo.

Exemples d'utilisation

Valeur pour renvoyer VAST :
vpi=1

Valeur pour renvoyer des redirections :
vpi=0

Revenir à la vue sous forme de liste

Ces informations vous-ont elles été utiles ?

Comment pouvons-nous l'améliorer ?
Recherche
Effacer la recherche
Fermer le champ de recherche
Menu principal
8411983955693351595
true
Rechercher dans le centre d'aide
true
true
true
true
true
148
false
false
false