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

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 relatives aux 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

 ajouter aux favorisAccé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
env
excl_cat
gdfp_req
gdpr
gdpr_consent
hl

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

pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
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 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 Obligatoire pour les annonces audio

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 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 puis 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 puis 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 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 Obligatoire pour le Web et les applications

recommandé 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. Généralement, il s'agit de la page qui héberge le lecteur vidéo. Toutefois, il peut s'agir d'une page contenant une description de la vidéo sous forme de texte.

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 Obligatoire pour le Web, les applications et Ad Exchange

recommandé Recommandé pour la monétisation programmatique

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 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 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

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é 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_id/.../ad_unit

Exemple d'utilisation

iu=/6062/videodemo

Obligatoire/Facultatif

Obligatoire 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.

Avertissement

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

Obligatoire Les deux paramètres sont obligatoires pour les applications

recommandé 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 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 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

pod

(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 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é 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 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 Obligatoire pour les applications

recommandé 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.

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.

Exemple d'utilisation

Exemples détaillés d'identifiants d'appareil réinitialisables

Obligatoire/Facultatif

Obligatoire Obligatoire pour les applications

recommandé 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

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 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é 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 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 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 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 Obligatoire pour le Web et les applications

recommandé 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é 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 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é Recommandé pour la monétisation programmatique

wta

(pourquoi cette annonce ?)

Le paramètre "Pourquoi cette annonce ?" accepte une valeur constante qui indique la compatibilité du lecteur vidéo pour l'affichage de la mention Pourquoi cette annonce ?.

La fonctionnalité "Pourquoi cette annonce ?" est automatiquement prise en charge si vous utilisez le SDK IMA. Si le SDK IMA n'est pas utilisé, les lecteurs vidéo doivent intégrer les paramètres VAST Icon et IconClickFallbackImage, conformément à la norme VAST de l'IAB.

Les demandes d'annonces audio doivent 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 être éligibles au trafic de la demande Google et des réservations hébergées par Google dans l'EEE, les demandes d'annonces doivent envoyer le code wta=1. Cela doit indiquer que l'icône AdChoices fournie dans la réponse VAST est affichée sur la vidéo. associées ou fournies à l'utilisateur pour toutes les créations.

Exemple d'utilisation

Compatible :
wta=1

Non compatible :
wta=0

Obligatoire/Facultatif

Obligatoire Obligatoire pour Ad Exchange

Obligatoire Obligatoire pour le trafic Web et dans les applications dans l'EEE

recommandé Recommandé pour la monétisation programmatique

Ces informations vous-ont elles été utiles ?

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