Cet article présente la liste complète des paramètres qui peuvent ê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.
Sur cette page
- Paramètres requis pour la diffusion des annonces
- Paramètres requis pour le programmatique
- Paramètres recommandés pour le programmatique
- Autres paramètres
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és qui décrivent l'utilisation et les exigences pour 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
Paramètres requis pour la diffusion des 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.
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
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.
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
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.
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
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".
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
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.
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
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.
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
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.
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
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).
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
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.
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
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.
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
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).
Paramètres requis pour le programmatique
Description
Le paramètre d'emplacement du service de distribution par contournement (ott_placement) accepte une valeur constante qui indique une demande d'emplacement du service de distribution par contournement (OTT, over-the-top) non 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 acceptés et valeurs correspondantes :
Pause :
ott_placement=1
Écran d'accueil :
ott_placement=2
Picture-in-picture :
ott_placement=3
Bannière en L :
ott_placement=4
Superposition :
ott_placement=5
Personnalisé/autre :
ott_placement=99
Exigences et recommandations
Ce paramètre n'est requis que pour la monétisation programmatique sur le Web, dans les applications mobiles et sur TV connectée pour les éditeurs qui monétisent des emplacements non standard dans des environnements de streaming du service de distribution par contournement (OTT, over-the-top).
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
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.
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
Ce paramètre est obligatoire pour la monétisation programmatique dans la publicité extérieure numérique.
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
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).
Paramètres recommandés pour le programmatique
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
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).
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
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.
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
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.
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
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.
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
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.
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
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.
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
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
omidPartnerNameetomidPartnerVersionafin 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ètresomid_petsdk_apis. - Il ne doit pas être utilisé lorsque vous utilisez le SDK IMA, car il est défini automatiquement.
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.
|
Depuis iOS 14.5, Apple a abandonné le signal |
Exemples d'utilisation
Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.
Exigences et recommandations
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.
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
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.
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
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).
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_detallcuesservent à 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
allcuessont ignorés. Pour les annonces mid-roll, le paramètre de duréevid_dreste 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
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.
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
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.
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ètrewta, ou transmettezwtasans valeur définie)Les demandes d'annonces audio doivent utiliser
wta=1si 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
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 VASTIcon et IconClickFallbackImage, conformément à la norme VAST de l'IAB.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.
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=0ou 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=1ou 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.
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
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
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_videopermet 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
- Si votre application contient du contenu vidéo, définissez ce paramètre sur
video,audio_videoou 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.
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 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 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.
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_detallcuesservent à 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
allcuessont ignorés. Pour les annonces mid-roll, le paramètre de duréevid_dreste obligatoire et doit être transmis.
Exemples d'utilisation
Points de repère à 10 et 20 secondes :
allcues=10000,20000
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
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
cmsidest 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
videst 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.
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.
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
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
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
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.
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.
|
Depuis iOS 14.5, Apple a abandonné le signal |
Exemples d'utilisation
Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.
Exigences et recommandations
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.
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
Leinventorypartnerdomain 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.
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
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.
|
Depuis iOS 14.5, Apple a abandonné le signal |
Exemples d'utilisation
Consultez des exemples détaillés d'identifiants d'appareil réinitialisables.
Exigences et recommandations
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.
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
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.
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
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
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
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.
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.
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.
Description
Le paramètre d'emplacement du service de distribution par contournement (ott_placement) accepte une valeur constante qui indique une demande d'emplacement du service de distribution par contournement (OTT, over-the-top) non 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 acceptés et valeurs correspondantes :
Pause :
ott_placement=1
Écran d'accueil :
ott_placement=2
Picture-in-picture :
ott_placement=3
Bannière en L :
ott_placement=4
Superposition :
ott_placement=5
Personnalisé/autre :
ott_placement=99
Exigences et recommandations
Ce paramètre n'est requis que pour la monétisation programmatique sur le Web, dans les applications mobiles et sur TV connectée pour les éditeurs qui monétisent des emplacements non standard dans des environnements de streaming du service de distribution par contournement (OTT, over-the-top).
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
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.
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
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
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
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
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.
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.
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
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.
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.
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.
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.
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.
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.
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
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.
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
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.
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.
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
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).
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}. SupplyChainObjectetSupplyChainNodesont 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
SupplyChainNodeest 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
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 :
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
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.
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
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.
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.
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.
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.
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
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).
Description
La chaîneus_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.
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
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
cmsidest 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
videst 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.
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