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

Le lecteur utilise une URL de tag d'emplacement publicitaire VAST pour récupérer des annonces audio et vidéo. Vous pouvez assembler manuellement une URL de tag d'emplacement publicitaire VAST ou modifier une URL existante en utilisant les paramètres ci-dessous, puis les tester à l'aide de l'outil VAST Suite Inspector. Vous pouvez également procéder à un examen et à un test à l'aide des exemples de tags ci-dessous.

Exigences générales concernant les URL

• Protocole : les tags d'emplacement publicitaire VAST sont compatibles avec les protocoles http et https. Les URL de suivi des impressions respectent le paramètre SSL actuel et renvoient le protocole http ou https. Les URL de destination et de suivi des clics utilisent des URL en http, car la redirection est effectuée depuis une autre page.
• Domaine : l'utilisation de domaines dynamiques, créés via la macro de correspondance de structure ou toute autre méthode dynamique, n'est pas autorisée et génère une erreur.
• Circulation en temps réel : les URL de tag d'emplacement publicitaire pour la vidéo diffusée en direct doivent inclure le paramètre /live dans leur chemin. Cela leur permet de gérer des volumes importants de trafic lorsque l'ensemble des coupures publicitaires sont diffusées en même temps.

Exemple de tag d'emplacement publicitaire VAST

Un exemple d'URL de tag d'emplacement publicitaire VAST (avec des valeurs assignées et des paramètres) ressemblerait à ceci :

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

 Accéder à un paramètre spécifique dans la liste

aconp ad_rule ad_type addtl_consent afvsz allcues an ciu_szs correlator cmsid cust_params description_url dth env excl_cat gdfp_req gdpr gdpr_consent givn

hl iabexcl idtype ipd ipe is_lat iu lip ltd max_ad_duration min_ad_duration mridx msid nofb npa omid_p output paln plcmt

pmad pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp schain scor

sdk_apis sdmax sid ssss sz tfcd trt unviewed_position_start url vad_type vconp vid vid_d vpa vpi vpmute vpos wta

Paramètre	Détails
aconp (lecture continue de l'audio)	Recommandé conformément aux Directives de mesure audio du MRC Le paramètre de lecture continue de l'audio accepte une valeur constante qui indique si le lecteur va lire le contenu audio en continu. Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur. Exemple d'utilisation Lecture en continu ACTIVÉE : aconp=2 Lecture en continu DÉSACTIVÉE : aconp=1
ad_rule (règle relative aux annonces)	Le paramètre de règle relative aux annonces 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 Ad Manager. Vous pouvez remplacer le paramètre de tags d'emplacement publicitaire spécifiques à l'aide des exemples ci-dessous. Exemple d'utilisation Demande de création VAST : ad_rule=0 Demande de règles relatives aux annonces (VMAP) : ad_rule=1 Obligatoire/Facultatif Obligatoire pour les règles relatives aux annonces vidéo
ad_type (Type d'annonce)	Les paramètres de type d'annonce acceptent une valeur constante qui indique les types d'annonces à renvoyer pour la requête. Ce paramètre n'est obligatoire que pour les annonces audio. 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 permet aux deux formats d'entrer en concurrence, mais un seul est diffusé.) Le type d'annonce audio_video ne doit être utilisé 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 (retransmissions sportives, diffusions vidéo, actualités, etc.). En savoir plus sur le contenu audio dans les vidéos Autorise uniquement les annonces vidéo désactivables : ad_type=skippablevideo Autorise uniquement les annonces vidéo non désactivables : ad_type=standardvideo Obligatoire/Facultatif Obligatoire pour les annonces audio
addtl_consent (consentement supplémentaire)	Le paramètre de consentement supplémentaire 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. 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 la Spécification technique concernant le Mode Consentement supplémentaire de Google. Exemple d'utilisation addtl_consent=1~1.35.41.101
afvsz (tailles d'annonces non linéaires)	Le paramètre de tailles d'annonces non linéaires 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 vide lorsqu'aucune taille non linéaire n'est acceptée. Exemple 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   Obligatoire/Facultatif Obligatoire pour les annonces vidéo non linéaires si vous n'utilisez pas le SDK IMA
allcues (tous les points de repère)	Ce paramètre accepte des valeurs variables qui correspondent à une liste de points de repère séparés par une virgule, en millisecondes. Pour chaque valeur, 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 points de repère basés sur l'heure 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 points de repère transmis dans le paramètre allcues sont ignorés. Les annonces vidéo mid-roll requièrent malgré tout une durée. Vous devez donc transmettre le paramètre vid_d. Exemple d'utilisation Points de repère à 10 et 20 secondes : allcues=10000,20000
ciu_szs (tailles des annonces associées)	Le paramètre de tailles associées 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. Exemple d'utilisation ciu_szs=728x90,300x250 Tailles avec un emplacement multitaille : ciu_szs=728x90,300x200|300x250
cmsid (ID de la source de contenu) vid (ID de la vidéo)	Les paramètres d'ID vidéo et d'ID de source du contenu acceptent des valeurs variables.  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 Ad Manager, cliquez sur Vidéo  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 qui héberge votre contenu. Pour le repérer dans Ad Manager, cliquez sur Vidéo  Contenu, puis sur le contenu vidéo spécifique. Exemple d'utilisation cmsid=[valeur]&vid=[valeur] Si vous créez un tag pour l'insertion dynamique d'annonces avec vidéo à la demande, 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%% Obligatoire/Facultatif Obligatoire pour le ciblage de contenu vidéo
correlator (corrélateur)	Le paramètre de corrélation 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. 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. Exemple d'utilisation correlator=4345645667 Obligatoire/Facultatif Obligatoire pour le Web et les applications Recommandé pour la monétisation programmatique
cust_params (paramètres de clé-valeur personnalisés)	Le paramètre personnalisé accepte des valeurs variables qui sont des paires clé-valeurs 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. Exemple d'utilisation Découvrez des exemples d'ajout de paires clé-valeurs.
description_url (URL de description)	Le paramètre d'URL de description accepte une valeur variable qui doit décrire la vidéo lue sur la page. Rédigez un à trois paragraphes décrivant le contenu de la page. Par exemple, assemblez le contenu de la page description_url de manière dynamique à partir de blocs prédéfinis. Découvrez comment fournir une URL de description distincte. La valeur description_url doit être encodée sous forme d'URL pour les lecteurs vidéo de page Web et les appareils de TV connectée/service de distribution par contournement. Elle ne doit pas être encodée pour les lecteurs vidéo intégrés aux applications mobiles. Ce paramètre n'est pas défini automatiquement par le SDK IMA. Vous devez le configurer manuellement. Exemple d'utilisation 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 Obligatoire/Facultatif Obligatoire pour le Web, les applications et Ad Exchange Recommandé pour la monétisation programmatique
dth (Indice sur le type d'appareil)	Le paramètre d'indication de type d'appareil 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 être due à des 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 : Demandes provenant de : Feature phone : dth=1 Smartphone : dth=2 Ordinateur : dth=3 Tablette : dth=4 TV connectée : dth=5 Console de jeu : dth=6 Boîtier décodeur : dth=7 Obligatoire/Facultatif Recommandé pour la monétisation programmatique sur les TV connectées. 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.
env (environnement)	Le paramètre d'environnement 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. Exemple d'utilisation Vidéo et/ou audio : env=instream Vidéo uniquement : env=vp Obligatoire/Facultatif Obligatoire pour le Web et les applications
excl_cat (catégorie d'exclusion)	Le paramètre de catégorie d'exclusion accepte des valeurs variables et sert à empêcher que des éléments de campagne contenant le libellé d'exclusion en question soient éligibles pour une demande d'annonce donnée. Ce paramètre est compatible avec cust_params. Exemple d'utilisation &cust_params=excl_cat%3Dairline_excl_label%7C
gdfp_req (indicateur de schéma Ad Manager)	Le paramètre d'indicateur de schéma Ad Manager accepte une valeur constante qui indique que l'utilisateur fait partie du schéma Ad Manager. Exemple d'utilisation gdfp_req=1 Obligatoire/Facultatif Obligatoire pour le Web et les applications
gdpr (RGPD)	Le paramètre RGPD 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. Exemple d'utilisation Le RGPD s'applique : gdpr=1 Le RGPD ne s'applique pas : gdpr=0
gdpr_consent (consentement RGPD)	Le paramètre de consentement RGPD 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 (Transparency & Consent) de la version 2.0 du TCF de l'IAB. Exemple d'utilisation gdpr_consent=GDPR_CONSENT_123
givn paln (nonce vidéo)	For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it. Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters. Usage example You can read more about the value passed to this parameter in the getting started guides for PAL.
hl (Langue)	Le paramètre de langue 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. 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é. Exemple d'utilisation hl=it Obligatoire/Facultatif Recommandé pour la monétisation programmatique
iabexcl (URL d'exclusion de l'IAB)	Le paramètre d'URL iabexcl accepte une liste de catégories séparées par une virgule. Exemple d'utilisation iabexcl=3,14,527 exclut les catégories "Camions commerciaux", "Véhicules tout terrain" et "Rugby". En savoir plus sur la taxonomie de contenu de l'IAB
ipd (domaine du partenaire d'inventaire)	Le paramètre de domaine du partenaire d'inventaire accepte des valeurs variables qui doivent être définies sur les déclarations inventorypartnerdomain du fichier app-ads.txt (ou ads.txt) de l'éditeur.  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
ipe (entité qui pingue les impressions)	Le paramètre de l'entité qui pingue les impressions accepte une valeur constante qui permet d'indiquer les pings d'impression et les conversions provenant du serveur, pas du client. Exemple d'utilisation Balisage côté serveur : ipe=ssb
iu (bloc d'annonces)	Le paramètre de bloc d'annonces accepte une valeur variable qui doit être définie sur le bloc d'annonces actuel, au format suivant : /network_code/.../ad_unit Exemple d'utilisation iu=/6062/videodemo Obligatoire/Facultatif Obligatoire pour le Web et les applications
lip (dernière position dans une série d'annonces)	Le paramètre de dernière position dans une série d'annonces accepte une valeur constante pour indiquer une demande issue de la dernière position d'une série d'annonces. Ce paramètre ne s'applique qu'aux séries d'annonces standards. Exemple d'utilisation lip=true
ltd (Annonces limitées)	Le paramètre d'annonces limitées 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. 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. Exemple d'utilisation ltd=1
min_ad_duration (Durée minimale de l'annonce) max_ad_duration (Durée maximale de l'annonce)	Les paramètres de durée d'annonce acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une annonce. Utilisez ce paramètre pour limiter la durée d'une annonce individuelle pour les demandes d'annonces uniques et de séries d'annonces optimisées. Exemple d'utilisation min_ad_duration=15000&max_ad_duration=30000
mridx (numéro d'annonce vidéo mid-roll)	Le paramètre de numéro d'annonce vidéo mid-roll 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.). Exemple d'utilisation mridx=2
msid (ID de l'application) an (Nom de l'application)	Les paramètres d'ID et de nom d'application 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. 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). 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. Exemple 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 Obligatoire/Facultatif Les deux paramètres sont obligatoires pour les applications Recommandé pour la monétisation programmatique
nofb (création de remplacement désactivée)	Le paramètre de création de remplacement désactivée accepte une valeur constante pour indiquer que la demande d'annonce ne doit pas renvoyer une playlist d'annonces vidéo de remplacement. Exemple d'utilisation Création de remplacement désactivée : nofb=1
npa (annonce non personnalisée)	Le paramètre d'annonces non personnalisées 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. Exemple d'utilisation Annonces non personnalisées : npa=1
omid_p (nom du partenaire OMID)	Le paramètre de nom du partenaire OMID accepte une valeur variable qui indique le nom du partenaire intégrant la mesure OMID et la version du partenaire. 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). Il ne doit pas être utilisé lorsque vous utilisez le SDK IMA, car il est défini automatiquement. Pour indiquer qu'OMID est compatible avec la Programmatic Access Library (PAL), vous devez utiliser les API omidPartnerName et omidPartnerVersion afin de définir le nom et la version du partenaire. Lorsque vous n'utilisez ni PAL, ni IMA, vous devez définir les paramètres omid_p et sdk_apis (API compatibles, qui peuvent également inclure d'autres API séparées par une virgule). Exemple d'utilisation Si vous utilisez PAL : request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' Si vous n'utilisez pas PAL : omid_p=examplepartnername/1.0.0.0&sdk_apis=7
output (format de sortie de l'annonce)	Le paramètre de format de sortie de l'annonce accepte une valeur constante qui doit être définie sur le format de sortie de l'annonce. Utilisez output=vast pour la version VAST par défaut définie pour votre réseau. Pour des tags d'emplacement publicitaire particuliers ou des parties spécifiques de votre site, vous pouvez demander des versions VAST ou VMAP spécifiques. 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. Le paramètre output=vmap permet de renvoyer la version par défaut de VMAP (par exemple, VMAP 1) qui est activée sur votre réseau. Si vous renvoyez VAST dans VMAP, utilisez les paramètres xml_vmap1_vast3 ou xml_vmap1_vast4 pour spécifier la version VAST à renvoyer. Exemple d'utilisation Paramètre VAST par défaut de votre réseau : output=vast VAST 4 : output=xml_vast4 Paramètre VMAP par défaut de votre réseau : output=vmap VMAP 1 : output=xml_vmap1 VMAP 1, avec renvoi de VAST 4 : output=xml_vmap1_vast4 Obligatoire/Facultatif Obligatoire pour le Web et les applications
plcmt (emplacement)	Le paramètre d'emplacement accepte une valeur constante qui est utilisée pour indiquer si l'inventaire InStream est déclaré ou non comme InStream ou associé, selon les conseils dans les 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é et remplace toute déclaration de contenu InStream ou associé. Exemple d'utilisation Demande InStream : plcmt=1 Demande de contenu associé : plcmt=2 Obligatoire/Facultatif   Obligatoire pour la monétisation Web et programmatique
pmad (nombre maximal d'annonces dans une série d'annonces)	Le paramètre de nombre maximal d'annonces dans une série d'annonces accepte une valeur variable qui indique le nombre maximal d'annonces dans une série d'annonces. Ce paramètre est propre aux séries d'annonces optimisées, qui sont disponibles pour les éditeurs disposant d'un package vidéo avancé. Il ne doit pas être utilisé pour les annonces VMAP (avec le paramètre ad_rule=1). Exemple d'utilisation pmad=4
pmnd (durée minimale de la série d'annonces) pmxd (durée maximale de la série d'annonces)	Les paramètres de durée de série d'annonces acceptent des valeurs variables qui, ensemble, indiquent la période (en millisecondes) de diffusion d'une série d'annonces. Ils permettent de demander plusieurs annonces. Ils sont propres aux séries d'annonces optimisées, qui sont disponibles pour les éditeurs disposant d'un package vidéo avancé. Ils ne doivent pas être utilisés pour les annonces VMAP (avec le paramètre ad_rule=1). Exemple d'utilisation pmnd=0&pmxd=60000
série d'annonces (numéro de série d'annonces)	Le paramètre de numéro de série d'annonces 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.). Exemple d'utilisation pod=3 Obligatoire/Facultatif Obligatoire pour assurer le bon fonctionnement des exclusions réciproques, de la limitation de la fréquence d'exposition et des fonctionnalités connexes.
pp (profil de création)	Le paramètre de profil de création 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. Exemple d'utilisation pp=creative_profile Obligatoire/Facultatif Recommandé pour la monétisation programmatique
ppt (Traitement de la confidentialité pour les éditeurs)	Le paramètre "Traitement de la confidentialité pour les éditeurs") accepte une valeur constante qui est utilisée pour indiquer s'il faut désactiver la personnalisation des annonces pour la demande d'annonce. En savoir plus sur le Traitement de la confidentialité pour les éditeurs Exemple d'utilisation Désactivez la personnalisation des annonces: ppt=1
ppid (identifiant fourni par l'éditeur)	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 et le ciblage de l'audience, 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. Exemple d'utilisation ppid=12JD92JD8078S8J29SDOAKC0EF230337
ppos (position dans la série d'annonces)	Le paramètre de position dans une série d'annonces 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. Exemple d'utilisation ppos=2 Obligatoire/Facultatif Obligatoire pour assurer le bon fonctionnement des exclusions réciproques, de la limitation de la fréquence d'exposition et des fonctionnalités connexes.
ppsj (JSON des signaux fournis par l'éditeur)	Le paramètre JSON des signaux fournis par l'éditeur accepte 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. En savoir plus sur les signaux fournis par l'éditeur et les taxonomies compatibles Pour en savoir plus sur les paires clé-valeur JSON valides, consultez cet exemple de SDK IMA pour HTML5. Exemple d'utilisation Objet JSON : {   "PublisherProvidedTaxonomySignals": [{      "taxonomy": "IAB_AUDIENCE_1_1",      "values": ["6", "284"]   }] } Valeur encodée en base64 : eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ
ptpl (ID du modèle de coupure publicitaire) ptpln (nom du modèle de coupure publicitaire)	L'ID et le nom du modèle de coupure publicitaire acceptent les valeurs de variables et indiquent le modèle de coupure publicitaire à 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 des deux paramètres (nom ou ID) est obligatoire pour demander un modèle de coupure publicitaire. Exemple d'utilisation Pour en savoir plus sur la configuration et la demande de modèles de coupures publicitaires, cliquez ici.
pubf (prix planchers publics dans les tags Ad Exchange) pvtf (prix planchers privés dans les tags Ad Exchange)	pubf équivaut à google_ad_public_floor, et pvtf équivaut à google_ad_private_floor. Ces paramètres permettent d'ajouter des prix planchers à des tags Ad Exchange. Exemple d'utilisation pubf=123 pvtf=123
pvid (ID du groupe d'applications) pvid_s (Portée du groupe d'applications)	Les valeurs de l'ID du groupe d'applications sont nécessaires pour la monétisation lorsque les utilisateurs désactivent la personnalisation sur les appareils Android. Le paramètre pvid accepte une valeurvariable définie sur l'ID du groupe d'applications Android, tandis que le paramètre pvid_s accepte une valeur constante qui représente le champ d'application de l'ID du groupe d'applications (scope_app oucope_developer). 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. Consultez la documentation Android sur la manière de récupérer l'ID du groupe d'applications. Exemple d'utilisation pvid=[AppSetID_value] pvid_s=scope_app Obligatoire/Facultatif Obligatoire pour les applications Recommandé pour la monétisation programmatique
rdid idtype is_lat (identifiants d'appareil réinitialisables)	Les identifiants d'appareil réinitialisables acceptent les valeurs variables. Avec les applications intégrées (non distribuées sur le Web ni sur le Web mobile), le SDK transmet des identifiants d'appareil réinitialisables pour le ciblage des internautes dans vos demandes de flux à l'aide des paramètres rdid, idtype et is_lat. Pour les flux de balisage côté serveur, ils doivent être transmis en tant que paramètres explicites, comme pour une demande d'annonce côté client. En savoir plus sur les identifiants d'appareil La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs. 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. Exemple d'utilisation Exemples détaillés d'identifiants d'appareil réinitialisables Obligatoire/Facultatif Obligatoire pour les applications Recommandé pour la monétisation programmatique
rdp (limitation du traitement des données)	Le paramètre de limitation du traitement des données accepte une valeur constante pour indiquer que la demande d'annonce doit limiter le traitement des données. Vous devez soit définir spécifiquement le paramètre rdp=1, soit inclure simplement rdp (sans valeur définie) pour limiter le traitement des données. Les demandes d'annonces qui n'incluent pas ce paramètre ou pour lesquelles il est défini sur rdp=0 ne seront pas limitées, à moins que le paramètre réseau Limiter le traitement des données soit activé. Exemple d'utilisation rdp=1
schain (Chaîne d'approvisionnement)	Le paramètre de chaîne d'approvisionnement accepte une valeur variable qui doit être un objet SupplyChain sérialisé. Lorsque ce paramètre est inclus, 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 communiquer des informations sur l'objet SupplyChain via une balise (plutôt qu'OpenRTB). Consulter les conditions requises pour que schain soit analysé correctement D'après 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 délimitées par des virgules afin que les champs facultatifs puissent être omis et que ces virgules utilisées comme séparateurs puissent être exclues. Chaque élément SupplyChainNode est séparé par un !. Si la valeur d'une propriété contient des caractères nécessitant un encodage sous forme d'URL (par exemple, , ou !), 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 l'ordre suivant : ver,complete Les propriétés SupplyChainNode sont sérialisées dans l'ordre suivant : asi,sid,hp,rid,name,domain,ext Remarque : Le contenu de ext est spécifique à la place de marché. Google Ad Manager n'analyse pas cette propriété. Exemples de sérialisation de l'objet SupplyChain Vous trouverez ci-dessous deux exemples de sérialisation de l'objet SupplyChain ci-dessus : Sérialiser 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érialiser 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 valeur de asi était 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 Obligatoire/Facultatif Obligatoire pour les éditeurs qui utilisent des intermédiaires de paiement en amont de la demande envoyée à Google Ad Manager. Cela inclut les éditeurs qui utilisent une technologie d'ad server tiers.
scor (corrélateur de flux)	Le paramètre de corrélateur de flux accepte une valeur variable qui doit être un entier généré pour chaque flux vidéo. Le nombre doit être identique dans un flux et unique sur une page vue. Il est utilisé pour les exclusions réciproques, la limitation de la fréquence d'exposition et les fonctionnalités connexes lorsqu'un internaute regarde plusieurs vidéos sur la même page. Exemple d'utilisation scor=17 Obligatoire/Facultatif Obligatoire pour assurer le bon fonctionnement des exclusions réciproques, de la limitation de la fréquence d'exposition et des fonctionnalités connexes.
sdk_apis (cadre de l'API du SDK)	Le paramètre du framework de l'API du SDK accepte une liste de valeurs entières constantes séparées par des virgules, qui indiquent tous les frameworks de l'API compatibles avec le lecteur. Consultez la liste des valeurs possibles pour le framework de l'API. Ce paramètre est compatible avec les API de la Programmatic Access Library (PAL) pour les éditeurs qui n'utilisent pas le SDK IMA. Le SDK IMA remplace toutes les valeurs définies par celles acceptées par le SDK IMA. Exemple d'utilisation sdk_apis=2,7,9
sdmax (Durée max. des annonces désactivables)	Le paramètre de demande d'annonce sdmax (durée max des annonces désactivables) accepte une valeur variable qui permet aux éditeurs de spécifier la durée maximale souhaitée pour les annonces désactivables. La durée, en millisecondes, correspond à la limite supérieure autorisée pour la durée des créations vidéo/audio désactivables pour cette demande d'annonce spécifique. Utilisez sdmax indépendamment pour les annonces désactivables, ou en combinaison avec le paramètre max_ad_duration existant afin de définir des durées maximales différentes pour les annonces désactivables et non désactivables. Exemple d'utilisation À l'aide des paramètres suivants : max_ad_duration = 15 000 (15 secondes) sdmax = 45 000 (45 secondes) Pour les créations suivantes : Création A : non désactivable ; 30 s Création B : désactivable ; 30 s Résultats en : La création A sera filtrée, car elle n'est pas désactivable, et sa durée dépasse la durée maximale (non désactivable). La création B ne sera pas filtrée, car même si sa durée est supérieure à max_ad_duration, elle est désactivable, et sa durée ne dépasse pas la valeur maximale pour les annonces désactivables.
sid (ID de session)	Le paramètre d'ID de session accepte une valeur variable qui est un identifiant publicitaire sécurisé utilisable seulement pour limiter la fréquence d'exposition. L'ID de session est compatible avec 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. Il n'est actuellement pas compatible avec le Web. Conformément aux Consignes de l'IAB concernant les identifiants publicitaires, ce paramètre doit obligatoirement être renseigné au format UUID. En savoir plus sur les ID d'appareil réinitialisables pour le ciblage par type d'utilisateur Vous pouvez désactiver la transmission de l'ID de session en définissant sid=0. Exemple d'utilisation 123e4567-e89b-12d3-a456-426614174000 Obligatoire/Facultatif Recommandé pour la monétisation programmatique
ssss (source d'assemblage côté serveur)	Le paramètre de source d'assemblage côté serveur 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. Exemple d'utilisation ssss=mystitcher Obligatoire/Facultatif  Obligatoire pour les implémentations de serveur à serveur
sz (taille)	Le paramètre de taille accepte une valeur variable qui doit être définie sur la taille de l'espace publicitaire de la vidéo maître. Séparez différentes tailles au moyen d'une barre verticale (|). N'incluez pas v après la taille. Exemple d'utilisation sz=400x300 Obligatoire/Facultatif Obligatoire pour le Web et les applications Ce paramètre est facultatif si vous ne demandez que ad_type=audio.
tfcd (tag pour un traitement adapté aux contenus destinés aux enfants)	Le paramètre destiné aux enfants accepte une valeur constante qui ajoute des tags à la demande d'annonce pour le traitement adapté aux contenus destinés aux enfants. Exemple d'utilisation tfcd=1
trt (type de trafic)	Le paramètre de type de trafic accepte une valeur constante qui sert à demander du trafic acheté ou généré par les résultats naturels. Le SDK IMA ne renseigne pas une 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). Exemple d'utilisation Demande pour le trafic acheté : trt=1 Demande pour le trafic généré par les résultats naturels : trt=2
unviewed_position_start (impressions différées)	Le paramètre d'impressions différées accepte une valeur constante afin d'indiquer les impressions différées pour la vidéo. Exemple d'utilisation unviewed_position_start=1 Obligatoire/Facultatif Obligatoire pour le Web et les applications
url (URL)	Le paramètre d'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 est nécessaire pour permettre aux acheteurs d'identifier et de comprendre le contexte d'origine de cette demande. Dans la mesure du possible, cette valeur doit être renseignée dynamiquement dans la demande d'annonce.  Sur une page Web, il s'agit de l'URL de la page qui affiche le lecteur vidéo. 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. Dans une application (mobile ou pour TV connectée), 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 dans une application mobile et que cette vidéo est également disponible sur ordinateur via une URL*. La valeur de ce paramètre doit être encodée. Exemple d'utilisation url=https%3A%2F%2Fwww.videoad.com%2Fgolf.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>.adsenseformobileapps.com Obligatoire/Facultatif Obligatoire pour le Web et les applications Recommandé pour la monétisation programmatique
vad_type (type d'annonce vidéo)	Le paramètre de type d'annonce vidéo accepte une valeur constante qui indique si une annonce linéaire ou non linéaire doit être renvoyée. Exemple d'utilisation Renvoyer une annonce linéaire : vad_type=linear Renvoyer une annonce non linéaire : vad_type=nonlinear
vid_d (durée de la vidéo)	Ce paramètre 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. Les règles relatives aux annonces sont aussi requises pour renvoyer des annonces vidéo mid-roll. Exemple d'utilisation Contenu vidéo d'une durée de 90 000 secondes (25 heures) : vid_d=90000
vconp (lecture continue de la vidéo)	Recommandé par les Règles d'évaluation du MRC pour les annonces vidéo Le paramètre de vidéo en continu accepte une valeur constante qui indique si le lecteur va lire le contenu vidéo en continu, à la manière d'une émission télévisée. Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur. Exemple d'utilisation Lecture en continu ACTIVÉE : vconp=2 Lecture en continu DÉSACTIVÉE : vconp=1
vpa (lecture automatique de la vidéo)	Recommandé par le MRC (règles d'évaluation pour les annonces vidéo) Le paramètre de lecture automatique de la vidéo accepte une valeur constante qui indique si le contenu vidéo d'une annonce commence via la lecture automatique ou à la suite d'un clic. Les valeurs possibles sont click si une action de l'utilisateur est requise, et auto si la vidéo est lue automatiquement. Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur. Exemple d'utilisation Lecture automatique : vpa=auto Clic pour visionner : vpa=click Obligatoire/Facultatif Recommandé pour la monétisation programmatique
vpi (video playlist inred)	Le paramètre vpi (video playlist inred) accepte une valeur constante qui indique s'il faut diffuser un VMAP intégré (renvoyer VAST dans VMAP). Il permet de réduire la latence, et de garantir les limites de la fréquence d'exposition et les exclusions réciproques dans un flux vidéo. Exemple d'utilisation Valeur pour renvoyer VAST : vpi=1 Valeur pour renvoyer des redirections : vpi=0
vpmute (lecture de la vidéo sans le son)	Recommandé par le MRC (règles d'évaluation pour les annonces vidéo) Le paramètre de vidéo sans le son accepte une valeur constante qui indique si la lecture de l'annonce démarre lorsque le son du lecteur vidéo est coupé. Exemple d'utilisation Son coupé : vpmute=1 Son activé : vpmute=0 Obligatoire/Facultatif   Obligatoire pour la monétisation Web et programmatique
vpos (position de la vidéo)	Le paramètre de position vidéo accepte une valeur constante qui indique si la demande d'annonce est envoyée depuis une annonce vidéo pré-roll, mid-roll ou post-roll. Exemple d'utilisation Annonce vidéo pré-roll : vpos=preroll Annonce vidéo mid-roll : vpos=midroll Annonce vidéo post-roll : vpos=postroll Obligatoire/Facultatif Recommandé pour la monétisation programmatique
wta (pourquoi cette annonce ?)	Le paramètre "Pourquoi cette annonce" accepte une valeur constante qui indique si le lecteur vidéo prend en charge l'identification des publicités par des badges. Si aucun paramètre &wta n'est envoyé, la valeur par défaut est &wta=1. L'identification des publicités par des badges est automatiquement prise en charge lorsque vous utilisez le SDK IMA. Dans le cas contraire, les lecteurs vidéo doivent intégrer les paramètres VAST Icon et IconClickFallbackImage, conformément à la norme VAST de l'IAB. Les éditeurs doivent envoyer le paramètre &wta=0 s'ils n'affichent pas l'icône Choisir sa pub, comme indiqué dans la réponse VAST. Une demande d'annonce avec le paramètre &wta=1 ou sans paramètre &wta indique que l'éditeur affichera les informations "Choisir sa pub" fournies. Les demandes d'annonces audio peuvent envoyer le paramètre wta=1 si l'icône Choisir sa pub, telle qu'indiquée dans la réponse VAST, s'affiche sur des annonces associées ou est présentée à l'utilisateur. Pour le trafic provenant de l'EEE, les demandes avec &wta=0 ne seront pas éligibles aux créations de réservation pour lesquelles le badge Google est activé. 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 approprié. Exemple d'utilisation Compatibles : wta=1 ou absence de paramètre wta Non compatible : wta=0 Obligatoire/Facultatif Obligatoire pour Ad Exchange Obligatoire pour le trafic Web et dans les applications dans l'EEE Recommandé pour la monétisation programmatique