Cet article présente la liste des paramètres obligatoires et recommandés pour les tags d'emplacement publicitaire VAST utilisées pour diffuser des annonces dans les implémentations de TV connectée.
Sur cette page
- Paramètres requis pour la diffusion d'annonces
- Paramètres requis pour le programmatique
- Paramètres recommandés pour le programmatique
Paramètres obligatoires et recommandés pour la TV connectée
Paramètres requis pour la diffusion d'annonces
correlator
(corrélateur)
Description
Le paramètre de corrélation (correlator
) accepte une valeur variable qui est partagée par plusieurs demandes provenant de la même page vue. Il permet de définir des exclusions réciproques, y compris dans les environnements exempts de cookies.
Exemples d'utilisation
correlator=4345645667
Conditions requises et recommandations
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.
env
(environnement)
Description
Le paramètre d'environnement (env
) accepte une valeur constante qui indique qu'il s'agit d'une demande InStream ou que la demande provient spécifiquement d'un lecteur vidéo.
Les valeurs possibles sont instream
, qui peut être utilisée pour les annonces audio et vidéo, ou vp
, qui ne peut être utilisée que pour les annonces vidéo.
Exemples d'utilisation
Vidéo et/ou audio :
env=instream
Vidéo uniquement :
env=vp
Conditions requises et recommandations
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".
gdfp_req
(indicateur de schéma)
Description
Le paramètre d'indicateur de schéma Google Ad Manager (gdfp_req
) accepte une valeur constante qui indique que la demande d'annonce concerne l'inventaire Google Ad Manager.
Exemples d'utilisation
gdfp_req=1
Conditions requises et recommandations
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.
iu
(bloc d'annonces)
Description
Le paramètre de bloc d'annonces (iu
) accepte une valeur variable qui doit être définie au niveau du bloc d'annonces actuel, au format suivant : /network_code/.../ad_unit
.
Exemples d'utilisation
iu=/6062/videodemo
Conditions requises et recommandations
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.
output
(résultat)
Description
Le paramètre de format de sortie (output
) accepte une valeur constante qui doit être définie sur le format de sortie de l'annonce.
Exemples d'utilisation
Utilisez la version VAST par défaut de votre réseau:
output=vast
Utilisez VAST 4 (vous pouvez définir des versions spécifiques pour des tags spécifiques):
output=xml_vast4
Utilisez le paramètre VMAP par défaut de votre réseau:
output=vmap
Utilisez VMAP 1:
output=xml_vmap1
Utilisez VMAP 1, avec renvoi de VAST 4 (si vous renvoyez VAST dans VMAP):
output=xml_vmap1_vast4
Conditions requises et recommandations
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.
sz
(taille)
Description
Le paramètre de taille (sz
) accepte une valeur variable qui doit être définie sur la taille de l'espace publicitaire de l'annonce vidéo maître.
Si vous spécifiez plusieurs tailles, séparez-les par une barre verticale (|
).
N'ajoutez pas v
après la taille.
Exemples d'utilisation
Taille unique :sz=400x300
Tailles multiples :sz=300x250|400x300
Exigences et recommandations
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
).
url
(URL)
Description
Le paramètre d'URL (url
) accepte une valeur variable qui doit être définie sur l'URL complète à partir de laquelle la demande est envoyée. Cette valeur obligatoire permet aux acheteurs d'identifier et de comprendre le contexte d'origine de la demande. Dans la mesure du possible, cette valeur doit être renseignée dynamiquement dans la demande d'annonce.
- Sur le Web, il s'agit de l'URL de la page qui affiche le lecteur vidéo.
- Pour les environnements autres que le Web, cette valeur doit être définie sur une URL qui représente le plus précisément possible l'inventaire vidéo ou audio monétisé. C'est par exemple le cas lorsqu'un utilisateur regarde une vidéo sur une application mobile et que cette vidéo est également disponible sur ordinateur via une URL*.
Remarque : Le paramètre url
diffère du paramètre description_url
, car url
fait référence à l'emplacement depuis lequel une demande d'annonce a été envoyée, alors que description_url
est une page Web explorable qui décrit le contenu de la vidéo.
La valeur de ce paramètre doit être encodée.
Exemples d'utilisation
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Pour les applications, s'il n'est pas possible de définir une valeur d'URL variable pour ce paramètre, nous vous recommandons de définir une valeur au format suivant : url=https%3A%2F%2F<app/bundleid>.example.com
Exigences et recommandations
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.
Paramètres requis pour le programmatique
idtype
(type d'appareil)
Description
Les paramètres d'identifiants d'appareil réinitialisables (rdid
, idtype
et is_lat
) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).
Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid
, idtype
et is_lat
.
Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil
La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.
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.
is_lat
(suivi publicitaire limité)
Description
Les paramètres d'identifiants d'appareil réinitialisables (rdid
, idtype
et is_lat
) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).
Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid
, idtype
et is_lat
.
Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil
La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.
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.
ott_placement
(formats personnalisés)
Description
Le paramètre de formats personnalisés (ott_placement
) accepte une valeur constante qui indique une demande d'emplacement service de distribution par contournement (OTT, over-the-top) autre qu'InStream.
Définitions des emplacements pour les exemples ci-dessous:
- Pause: format OutStream qui s'affiche en superposition sur le contenu vidéo lorsqu'un utilisateur met la lecture en pause.
- Écran d'accueil: annonce qui s'affiche sur l'écran d'accueil d'un appareil pour la TV connectée ou d'une application OTT. Cela inclut les implémentations de masthead, de bannière et de bloc sur un écran d'accueil.
- Picture-in-picture (Mode Picture-in-picture) : annonce vidéo InStream lue dans un lecteur vidéo publicitaire distinct à côté du contenu vidéo. Cela nécessite généralement de réduire le contenu vidéo et de charger un deuxième lecteur vidéo.
- Bannière en L: annonce display InStream qui consiste à réduire le contenu vidéo et à créer une annonce autour de la vidéo. Il s'agit généralement d'une zone de contenu publicitaire en forme de L, mais pas nécessairement.
- Superposition: tout format d'annonce InStream qui s'affiche au-dessus du contenu vidéo, mais qui n'occupe pas tout l'écran. Il peut s'agir d'une annonce display ou vidéo.
Exemples d'utilisation
Formats compatibles et valeurs correspondantes:
Pause:
cust_fmt=1
Écran d'accueil:
cust_fmt=2
Picture-in-picture:
cust_fmt=3
Bannière en L:
cust_fmt=4
Superposition:
cust_fmt=5
Personnalisé/Autre:
cust_fmt=99
Conditions requises et recommandations
Ce paramètre n'est obligatoire que pour la monétisation programmatique sur le Web, les applications mobiles et la TV connectée pour les éditeurs qui monétisent des emplacements non standards dans des environnements de streaming OTT.
plcmt
(emplacement)
Description
Le paramètre d'emplacement (plcmt
) accepte une valeur constante qui est utilisée pour indiquer si l'inventaire InStream est déclaré ou non comme "InStream" ou "Associé", conformément aux conseils des spécifications de l'IAB.
Pour les demandes non InStream, ce champ est rempli automatiquement pour les acheteurs en fonction du format d'inventaire déclaré, qui remplace toute déclaration InStream ou associée.
Exemples d'utilisation
Demande InStream :
plcmt=1
Demande de contenu associé :
plcmt=2
Conditions requises et recommandations
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.
rdid
(identifiant d'appareil réinitialisable)
Description
Les paramètres d'identifiants d'appareil réinitialisables (rdid
, idtype
et is_lat
) acceptent des valeurs variables. Ces paramètres sont également appelés identifiants publicitaires (IFA).
Avec les applications mobiles qui utilisent le SDK IMA pour Android ou iOS, le SDK IMA transmet des identifiants d'appareil réinitialisables pour cibler les utilisateurs dans vos demandes de flux avec les paramètres rdid
, idtype
et is_lat
.
Lorsque le SDK IMA n'est pas utilisé ou que le balisage côté serveur est utilisé, vous devez les transmettre en tant que paramètres explicites. En savoir plus sur les identifiants d'appareil
La quasi-totalité des annonces vidéo programmatiques nécessitent la présence de ces valeurs.
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.
vpa
(lecture automatique de la vidéo)
Description
Le paramètre de lecture automatique de la vidéo (vpa
) accepte une valeur constante qui indique si le contenu vidéo d'une annonce commence à être lu automatiquement ou après un clic.
Les valeurs possibles sont click
si une action de l'utilisateur est requise, et auto
si la vidéo est lue automatiquement. Ce paramètre ne change pas l'état du lecteur vidéo. Le comportement de lecture doit être géré directement par le lecteur vidéo.
Exemples d'utilisation
Lecture automatique :
vpa=auto
Lecture après un clic :
vpa=click
Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur.
Exigences et recommandations
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).
vpmute
(lecture de la vidéo sans le son)
Description
Le paramètre de lecture de la vidéo sans le son (vpmute
) accepte une valeur constante qui indique si la lecture de l'annonce commence avec le son du lecteur vidéo coupé. Ce paramètre ne change pas l'état du lecteur vidéo. Le comportement de lecture doit être géré directement par le lecteur vidéo.
Exemples d'utilisation
La lecture commence avec le son coupé :
vpmute=1
La lecture commence avec le son activé :
vpmute=0
Exigences et recommandations
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 recommandés pour le programmatique
aconp
(lecture en continu de l'audio)
Description
Le paramètre de lecture en continu (aconp
) accepte une valeur constante qui indique si le lecteur va lire le contenu audio en continu. Cela permet à Google Ad Manager de sélectionner les annonces les plus adaptées à l'expérience utilisateur.
Exemples d'utilisation
Lecture en continu activée :
aconp=2
Lecture en continu désactivée :
aconp=1
Si vous ne savez pas si l'audio est lu en continu, ne définissez pas ce paramètre ou définissez-le sur aconp=0
.
Conditions requises et recommandations
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).
an
(nom de l'application)
Description
Les paramètres d'ID (msid
) et de nom d'application (an
) acceptent des valeurs variables qui doivent être appliquées aux demandes envoyées à partir d'appareils pour applications mobiles et pour la télévision connectée, car la plupart des annonces vidéo programmatiques les requièrent.
Bien que le nom de l'application doive être lisible, sur iOS et tvOS, le SDK ne peut pas accéder à l'ID de l'application. Dans ces cas de figure, le paramètre msid
n'est pas envoyé, et le SDK envoie l'app bundle par le biais du paramètre an
.
Exemples d'utilisation
msid=com.package.publisher&an=sample%20app
Les ID d'application sont nommés et formatés différemment selon les plates-formes de téléchargement d'applications. Consultez les Consignes de l'IAB pour l'identification des applications ou des exemples d'identifiants uniques courants.
Pour les plates-formes où il n'existe pas de plate-forme de téléchargement d'applications, l'IAB recommande aux éditeurs d'utiliser le format suivant pour les ID de plate-forme de téléchargement d'applications : com.publisher.deviceplatform
Conditions requises et recommandations
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.
dth
(indice sur le type d'appareil)
Description
Le paramètre d'indication de type d'appareil (dth
) accepte une valeur constante qui permet de réduire les classifications incorrectes d'appareils, en particulier sur les environnements de TV connectée et de boîtier décodeur.
Une mauvaise classification de l'appareil peut résulter d'erreurs involontaires de l'éditeur ou de l'OEM de TV connectée. Ce paramètre est utilisé conjointement avec d'autres signaux pour que Google signale automatiquement les cas où l'inventaire pour la TV connectée pourrait être reclassé.
Exemples d'utilisation
Requêtes provenant de :
- Feature phone :
dth=1
- Smartphone :
dth=2
- Ordinateur de bureau :
dth=3
- Tablette :
dth=4
- TV connectée :
dth=5
- Console de jeu :
dth=6
- Boîtier décodeur :
dth=7
Conditions requises et recommandations
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.
givn
(nonce vidéo)
Description
Pour les intégrations qui utilisent Programmatic Access Library (PAL), le paramètre nonce vidéo accepte une valeur de chaîne variable.
Le nonce est adapté aux URL. Vous n'avez pas besoin de l'encoder en URL.
Remarque : Si vous avez déjà fourni un nonce à l'aide de l'ancien paramètre paln
, nous vous recommandons vivement de passer au paramètre givn
et d'arrêter d'envoyer paln
. N'incluez pas les deux paramètres.
Exemples d'utilisation
Pour en savoir plus sur la valeur transmise à ce paramètre, consultez les guides de démarrage de PAL.
Conditions requises et recommandations
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.
hl
(langue)
Description
Le paramètre de langue (hl
) accepte une valeur constante qui sert à demander des annonces dans la langue en question, et à indiquer la langue de sélection d'une annonce et du rendu des annonces vidéo pour l'allocation dynamique dans les éléments vidéo Ad Exchange ou AdSense.
Exemples d'utilisation
Demander des annonces en italien :
hl=it
La valeur du paramètre peut être un code de langue ISO 639-1 (à deux lettres) ou ISO 639-2 (à trois lettres). Pour connaître la liste des codes valides, consultez cette page.
En cas d'omission, la valeur par défaut est une langue pour laquelle le ciblage linguistique des annonces dans Ad Exchange est activé.
Conditions requises et recommandations
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.
msid
(ID de l'application)
Description
Les paramètres d'ID (msid
) et de nom d'application (an
) acceptent des valeurs variables qui doivent être appliquées aux demandes envoyées à partir d'appareils pour applications mobiles et pour la télévision connectée, car la plupart des annonces vidéo programmatiques les requièrent.
Bien que le nom de l'application doive être lisible, sur iOS et tvOS, le SDK ne peut pas accéder à l'ID de l'application. Dans ces cas de figure, le paramètre msid
n'est pas envoyé, et le SDK envoie l'app bundle par le biais du paramètre an
.
Exemples d'utilisation
msid=com.package.publisher&an=sample%20app
Les ID d'application sont nommés et formatés différemment selon les plates-formes de téléchargement d'applications. Consultez les Consignes de l'IAB pour l'identification des applications ou des exemples d'identifiants uniques courants.
Pour les plates-formes où il n'existe pas de plate-forme de téléchargement d'applications, l'IAB recommande aux éditeurs d'utiliser le format suivant pour les ID de plate-forme de téléchargement d'applications : com.publisher.deviceplatform
Conditions requises et recommandations
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.
omid_p
(nom du partenaire OMID)
Description
Le paramètre de nom du partenaire OMID (omid_p
) accepte une valeur variable qui indique le nom du partenaire intégrant la mesure OMID et la version du partenaire.
Le paramètre des API SDK compatibles (sdk_apis
) accepte des valeurs variables qui peuvent être une liste unique ou séparée par des virgules d'API compatibles.
Ces paramètres font partie d'un ensemble de paramètres utilisés pour la visibilité et la validation des annonces.
Exemples d'utilisation
Si vous n'utilisez pas PAL :
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Consultez la liste des valeurs possibles pour le framework de l'API.
Si vous utilisez PAL :
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Conditions requises et recommandations
Bien que ce paramètre ne soit pas obligatoire pour diffuser des annonces dans une implémentation spécifique, il est recommandé pour la monétisation programmatique sur le Web, les applications mobiles, la TV connectée, l'audio et le publicité extérieure numérique.
Utilisation du SDK
- Ce paramètre ne s'applique qu'aux éditeurs qui souhaitent effectuer des mesures Active View lorsqu'ils utilisent le SDK Open Measurement (SDK OM).
- Pour indiquer qu'OMID est compatible avec Programmatic Access Library (PAL), vous devez utiliser
omidPartnerName
etomidPartnerVersion
afin de définir le nom et la version du partenaire. Lorsque vous n'utilisez pas le SDK PAL ou IMA, vous devez définir les paramètresomid_p
etsdk_apis
. - Il ne doit pas être utilisé lorsque vous utilisez le SDK IMA, car il est défini automatiquement.
sid
(ID de session)
Description
Le paramètre d'ID de session (sid
) accepte une valeur variable qui est un identifiant publicitaire respectueux de la confidentialité et utilisable seulement pour limiter la fréquence d'exposition.
L'ID de session peut être utilisé pour les demandes d'annonces vidéo InStream provenant de TV connectées et avec l'inventaire vidéo InStream à partir d'appareils équipés d'applications mobiles. Ce paramètre n'est actuellement pas accepté pour le Web.
Vous pouvez désactiver la transmission de l'ID de session en définissant sid=0
.
Exemples d'utilisation
sid=123e4567-e89b-12d3-a456-426614174000
Conformément aux Consignes de l'IAB concernant les identifiants publicitaires, ce paramètre doit être défini en respectant le format UUID. En savoir plus sur l'utilisation des identifiants d'appareil réinitialisables pour cibler les utilisateurs
Exigences et recommandations
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.
vconp
(lecture en continu de la vidéo)
Description
Le paramètre de lecture continue de la vidéo (vconp
) accepte une valeur constante qui indique si le lecteur doit lire le contenu vidéo en continu, à la manière d'une émission télévisée.
Exemples d'utilisation
Lecture continue ACTIVÉE :
vconp=2
Lecture continue DÉSACTIVÉE :
vconp=1
Ne définissez pas ce paramètre si vous n'en connaissez pas la valeur.
Exigences et recommandations
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).
vid_d
(durée de la vidéo)
Description
Le paramètre de durée de la vidéo (vid_d
) accepte une valeur variable qui spécifie la durée du contenu, en secondes.
- Les paramètres
vid_d
etallcues
servent à diffuser des annonces mid-roll sans ingestion de contenu. - L'utilisation des Règles relatives aux annonces est obligatoire pour renvoyer des annonces mid-roll. Si vous avez défini des repères temporels dans vos règles relatives aux annonces (par exemple, "Toutes les n seconde(s)" ou "À des moments précis"), ce sont eux qui sont utilisés. Les repères transmis dans le paramètre
allcues
sont ignorés. Pour les annonces mid-roll, le paramètre de duréevid_d
reste obligatoire et doit être transmis.
Exemples d'utilisation
Contenu vidéo d'une durée de 90 000 secondes (25 heures) :
vid_d=90000
Exigences et recommandations
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.
vpos
(positionnement de la vidéo)
Description
Le paramètre de position de la vidéo (vpos
) accepte une valeur constante qui indique si la demande d'annonce est envoyée depuis une position d'annonce pré-roll, mid-roll ou post-roll.
Exemples d'utilisation
Pré-roll :
vpos=preroll
Mid-roll :
vpos=midroll
Post-roll :
vpos=postroll
Exigences et recommandations
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.
wta
(pourquoi cette annonce ?)
Description
Le paramètre "Pourquoi cette annonce ?" (wta
) accepte une valeur constante qui indique si le lecteur vidéo accepte l'identification des publicités par des badges.
Exemples d'utilisation
Si le lecteur doit afficher l'icône Choisir sa pub fournie dans la réponse VAST, utilisez le paramètre suivant :
wta=1
(ou omettez le paramètrewta
, ou transmettezwta
sans valeur définie)Les demandes d'annonces audio doivent utiliser
wta=1
si l'icône Choisir sa pub fournie dans la réponse VAST doit s'afficher sur les annonces associées ou être présentée à l'utilisateur.
Si le lecteur ne doit pas afficher l'icône Choisir sa pub fournie dans la réponse VAST, utilisez le paramètre suivant :
wta=0
Exigences et recommandations
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.