Annonces vidéo

Ce guide décrit les exigences d'intégration, la configuration et les champs pertinents que vous pouvez utiliser lorsque vous définissez des enchères sur l'inventaire vidéo.

Google accepte les annonces vidéo InStream, natives et interstitielles représentées sous forme d'opportunités publicitaires individuelles ou de séries d'annonces vidéo dynamiques. Les séries d'annonces dynamiques décrivent un groupe d'annonces vidéo diffusées de façon séquentielle, où la durée maximale de la série d'annonces est divisée en une ou plusieurs vidéos de durées différentes. Pour en savoir plus sur les formats d'annonces natives et interstitielles, consultez les guides correspondants.

Exigences pour les acheteurs

Protocole RTB

Ce guide fait généralement référence au format Protobuf, mais les noms et les chemins d'accès des champs sont équivalents entre ce format et le format JSON, sauf indication contraire.

Vous trouverez le fichier proto OpenRTB et les extensions OpenRTB spécifiques à Google sur la page Fichiers proto et données de référence. Pour en savoir plus sur le développement d'un enchérisseur, consultez Traiter la requête et Créer la réponse.

Vérification des créations

Google vous recommande d'envoyer vos créations pour approbation avant de les utiliser pour enchérir. Vous pouvez utiliser la ressource Creatives de l'API Enchères en temps réel pour lancer le processus d'examen.

Configuration de préciblage

Pour recevoir un inventaire vidéo, votre compte Authorized Buyers doit créer une configuration de préciblage qui inclut un inventaire vidéo.

Macros

Vous pouvez spécifier des macros dans le lien de l'URL de la vidéo ou dans le fichier XML VAST spécifié dans BidResponse.seatbid.bid.adm. De plus, si vous spécifiez une URL de vidéo, vous pouvez également placer des macros dans le document XML VAST associé. Les macros suivantes sont compatibles avec les créations vidéo :

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Les macros de clic telles que CLICK_URL_ESC ne sont pas acceptées, car Authorized Buyers inclut ses trackers de clics dans un wrapper VAST. Pour en savoir plus sur les macros compatibles, consultez Spécifier des macros.

Détails de l'accroche

Vous pouvez utiliser le champ BidRequest.imp.video d'OpenRTB pour déterminer si une demande d'enchère entrante concerne un inventaire vidéo InStream ou interstitiel, et obtenir des informations supplémentaires spécifiques à la vidéo concernant la demande. De plus, pour l'inventaire d'annonces natives, vous pouvez utiliser BidRequest.imp.native.{request/request_native}.assets.video pour obtenir des informations similaires spécifiques aux vidéos.

BidRequest.{app/site}.content.producer.domain

URL, sans les paramètres, de la page qui décrit le contenu vidéo. L'éditeur envoie cette URL à Google. Exemple :

http://www.publisher.com/watchpagelink
banner.vcm
Si la valeur est définie sur true, l'annonce associée peut être sélectionnée pour être affichée en tant qu'écran de fin (fiche info) dans l'emplacement vidéo une fois la lecture de l'annonce vidéo terminée. Sinon, l'annonce associée n'est pas affichée en tant qu'écran de fin.
BidRequest.imp.rwdd
Si la valeur est définie sur true, cela indique que l'utilisateur reçoit une récompense pour avoir visionné l'annonce vidéo. Les récompenses types peuvent être la lecture d'un article supplémentaire sans frais, l'obtention d'une vie supplémentaire dans un jeu ou une session de musique sponsorisée sans publicité.
BidRequest.imp.video.maxduration

Durée maximale autorisée (en secondes) pour chaque annonce individuelle incluse dans la réponse à l'enchère. Si cette option n'est pas définie, il n'y a pas de durée maximale. Lorsque BidRequest.imp.video.skip est défini sur true, le comportement peut être différent. Pour en savoir plus, consultez Durée maximale d'une vidéo désactivable.

BidRequest.imp.video.maxseq

Nombre maximal d'annonces pouvant être diffusées dans une série d'annonces vidéo dynamique. Si poddur est défini, mais que maxseq n'est pas défini ou est défini sur 0, vous n'avez pas de restriction sur le nombre d'annonces pouvant être diffusées dans une série d'annonces vidéo. Google n'est compatible qu'avec les pods dynamiques.

Le nombre réel d'annonces vidéo diffusées peut être inférieur ou égal à cette valeur, mais ne peut pas la dépasser.

BidRequest.imp.video.minduration
Durée minimale en secondes de chaque annonce individuelle incluse dans la réponse à l'enchère. Si ce champ n'est pas défini, aucune durée minimale n'est appliquée.
BidRequest.imp.video.plcmt
Indique l'emplacement de diffusion de la vidéo.
PLCMT_UNKNOWN L'emplacement est inconnu ou indéterminable.
PLCMT_INSTREAM Annonces pré-roll, mid-roll et post-roll diffusées avant, pendant ou après le contenu vidéo en streaming demandé par l'utilisateur. Le son des vidéos InStream doit être activé par défaut au démarrage du lecteur, ou l'intention utilisateur de regarder le contenu vidéo doit être clairement exprimée. Même si d'autres contenus peuvent entourer le lecteur, le contenu vidéo doit être l'objectif principal de la visite de l'utilisateur. Il doit rester le contenu principal de la page et le seul lecteur vidéo visible capable de diffuser du son pendant la lecture. Si le lecteur passe en mode flottant/fixe, les appels d'annonces suivants doivent refléter précisément la nouvelle taille du lecteur.
PLCMT_ACCOMPANYING_CONTENT Annonces pré-roll, mid-roll et post-roll diffusées avant, pendant ou après un contenu vidéo en streaming. Le lecteur vidéo se charge et diffuse l'annonce avant, entre ou après des paragraphes de texte ou de contenu graphique, et ne commence à la lire que lorsqu'elle entre dans la fenêtre d'affichage. La lecture du contenu associé ne doit commencer que lorsqu'il entre dans la fenêtre d'affichage. Il peut se transformer en lecteur flottant/fixe lorsqu'il défile hors de la page.
PLCMT_INTERSTITIAL Annonces vidéo diffusées sans contenu vidéo. Pendant la lecture, elle doit être l'élément principal de la page, occuper la majeure partie de la fenêtre d'affichage et ne pas pouvoir être masquée par défilement. Il peut s'agir d'emplacements tels que des vidéos ou des diaporamas intégrés à l'application.
PLCMT_NO_CONTENT_STANDALONE Annonces vidéo diffusées sans contenu vidéo en streaming. Il peut s'agir d'emplacements tels que des diaporamas, des flux natifs, des annonces intégrées au contenu ou des annonces fixes/flottantes.
BidRequest.imp.video.playbackmethod
Indique comment lire l'annonce vidéo. La méthode de lecture est déterminée comme étant une lecture automatique ou une annonce click-to-play en fonction de la meilleure mesure disponible.
AUTO_PLAY_SOUND_ON Se lance au chargement de la page avec le son activé.
AUTO_PLAY_SOUND_OFF Se lance au chargement de page, sans le son.
CLICK_TO_PLAY Se lance au clic avec le son activé.
MOUSE_OVER La lecture démarre lorsque l'utilisateur pointe la souris sur l'annonce, avec le son activé.
ENTER_SOUND_ON Se lance lorsque l'annonce entre dans la fenêtre d'affichage, avec le son activé.
ENTER_SOUND_OFF La lecture se lance lorsque l'annonce entre dans la fenêtre d'affichage, sans le son par défaut.
BidRequest.imp.video.skip
Si la valeur est true, cela indique que le lecteur permettra d'ignorer la vidéo ou que les annonces désactivables sont autorisées. Sinon, il indique que les annonces désactivables ne sont pas autorisées.
BidRequest.imp.video.startdelay

La valeur 0 correspond à une annonce pré-roll, -1 à une annonce mid-roll et -2 à une annonce post-roll.

Toute autre valeur positive correspond au temps en secondes entre le début de la vidéo et le moment où l'annonce est diffusée.

BidRequest.imp.video.durfloors et BidRequest.imp.audio.durfloors

Tableau d'objets DurFloors indiquant les prix planchers respectifs des créations vidéo ou audio de différentes durées pour lesquelles l'acheteur peut enchérir.

Voici un exemple de ce à quoi ressemblerait un durfloors spécifié par Google :

  1. {"maxdur": 16, "bidfloor": 5} représentant (0, 16) secondes à $5.
  2. {"mindur": 16, "maxdur": 31, "bidfloor": 10} représentant [16, 31) secondes à $10.
  3. {"mindur": 31, "bidfloor": 20} représentant [31, inf) secondes à $20.

Ces signaux ne sont pas propres aux créations vidéo, mais ils sont particulièrement utiles pour les enchérisseurs :

BidRequest.device.ifa
Ce champ est un UUID de 36 caractères qui n'est défini que lorsque vous utilisez SSL et qui n'est pas haché. Il s'agit de la version non chiffrée de BidRequest.device.dpidm5. Pour les appareils iOS, il contient l'identifiant pour les annonceurs (IDFA) en majuscules. Pour les appareils Android, il contient l'identifiant Android (ADID) en minuscules. Pour les appareils pour la télévision connectée, il contient leurs identifiants uniques (par exemple, le RIDA de Roku).
BidRequest.device.devicetype
Spécifie le type d'appareil.
MOBILE Alias obsolète pour HIGHEND_PHONE ou TABLET.
PERSONAL_COMPUTER Inclut les ordinateurs de bureau et portables.
CONNECTED_TV inclut à la fois les TV connectées (c'est-à-dire les smart TV) et les appareils connectés (comme Roku, Apple TV, etc.).
HIGHEND_PHONE Inclut les téléphones haut de gamme.
TABLET Inclut les tablettes.
CONNECTED_DEVICE Inclut les appareils de jeu dédiés.
SET_TOP_BOX Inclut les boîtiers décodeurs.
OOH_DEVICE Inclut les appareils de publicité extérieure, par exemple les panneaux d'affichage numériques.
BidRequest.device.make
Spécifie la marque de l'appareil (par exemple, Nokia ou Samsung).
BidRequest.device.model
Spécifie le modèle exact (par exemple, N70 ou Galaxy) de l'appareil, s'il est disponible. Sinon, contient un modèle générique tel que "iphone" ou "ipad".
BidRequest.imp.metric
Lorsque Metric.type est défini sur completion_rate, Metric.value est une fraction comprise entre [0,0, 1,0] représentant l'historique du taux de lecture complète des annonces vidéo diffusées dans l'espace publicitaire. La valeur par défaut -1.0 indique que les données de l'historique du taux de lecture complète ne sont pas disponibles.
BidRequest.imp.video.poddur
Durée (en secondes) que vous pouvez remplir pour une série d'annonces vidéo dynamique. Ce champ fait référence à la durée de l'intégralité de la coupure publicitaire. Si ce paramètre n'est pas défini, l'espace publicitaire ne fait pas partie d'une série d'annonces.

La demande d'enchère vidéo contient également des informations sur l'inventaire, telles que le secteur d'activité, les fournisseurs autorisés et les informations sur le canal. Tous les autres champs existants de la demande d'enchère s'appliquent également aux vidéos.

Les champs de largeur et de hauteur du message AdSlot d'une demande vidéo correspondent à la taille du lecteur d'annonces vidéo.

BidRequest.imp.ext.allowed_vendor_type
Fournisseurs autorisés. Pour obtenir la liste des ID, consultez le fichier vendors.txt dans la documentation technique. Par exemple, 309 = bloc d'annonces vidéo DFA.
BidRequest.imp.video.mimes
Liste d'autorisation décrivant les types MIME de contenu acceptés pour les annonces diffusées en réponse à la demande d'enchère (par exemple, "video/mp4"). La réponse à l'enchère doit indiquer la compatibilité avec au moins l'un d'entre eux.
BidRequest.imp.video.protocols
Décrit les versions VAST compatibles d'un éditeur pour les demandes d'annonces vidéo. Contient un tableau de valeurs d'énumération Protocol, y compris : VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER, etc.
BidRequest.imp.video.companionad
Ce champ inclut un tableau d'objets Banner représentant les annonces associées, si elles sont disponibles.
BidRequest.site.page

URL de la page de lecture de la vidéo ou URL de la page dans laquelle la vidéo a été intégrée. Exemple :

http://www.publisher.com/watchpagelink

Lorsqu'il répond à une demande d'annonce vidéo, l'enchérisseur doit renvoyer une URL de redirection VAST ou un fichier XML VAST dans le champ BidResponse.seatbid.bid.adm. La réponse à l'enchère doit également contenir la déclaration appropriée pour l'annonce vidéo. Voici un extrait d'une réponse à l'enchère vidéo appropriée :

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

Les champs importants d'une réponse à une enchère vidéo sont les suivants :

BidResponse.seatbid.bid.ext.attribute
Attributs des annonces pouvant être diffusées à partir de cet extrait. Pour obtenir la liste des ID, consultez le fichier buyer-declarable-creative-attributes.txt. Nous vérifions qu'aucun de ces attributs ne correspond à ceux refusés par l'éditeur dans la demande d'enchère. Par exemple, si l'un des champs inclut 30, cela indique que l'annonce nécessite la compatibilité avec VPAID pour s'afficher.
BidResponse.seatbid.bid.adm

Pour les annonces vidéo, il s'agit de l'URL de redirection VAST de l'annonce vidéo. Exemple :

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Il peut également s'agir d'un code XML VAST brut.

Exemples de demandes d'enchères et de réponses

Correction du caractère désactivable

Google applique automatiquement la correction du caractère désactivable aux enchères en temps réel pour l'inventaire vidéo. Cela peut empêcher le filtrage de vos enchères lors de la mise aux enchères en raison de différences entre le caractère désactivable demandé dans la demande d'enchère et celui des créations que vous renvoyez dans la réponse à l'enchère. La correction du caractère désactivable n'est pas appliquée dans les cas suivants :

  • La création que vous spécifiez dans la réponse à l'enchère est implémentée à l'aide de VPAID. Vous pouvez déterminer lesquelles de vos créations vidéo sont implémentées à l'aide de VPAID grâce au champ Creative.video.videoMetadata.isVpaid de l'API Enchères en temps réel.
  • L'éditeur va afficher la création. Vous pouvez le déterminer en fonction du champ BidRequest.imp.displaymanager, qui est 'PUBLISHER' si l'éditeur va afficher la création.

Voici des exemples d'application de la correction du caractère désactivable :

  • Scénario 1 :
    • Vous recevez une demande d'enchère avec le champ BidRequest.imp.video.skip défini sur 0 pour le format JSON ou false pour le format Protobuf.
    • Vous définissez une enchère avec une création désactivable.
    • Résultat : votre enchère participe à la mise aux enchères. Si votre enchère l'emporte et que la création vidéo s'affiche, elle s'affiche en tant que création non désactivable.
  • Scénario 2 :
    • Vous recevez une demande d'enchère avec le champ BidRequest.imp.video.skip défini sur 1 pour le format JSON ou true pour le format Protobuf.
    • Vous définissez une enchère avec une création non désactivable dont la durée est supérieure à celle spécifiée dans le champ BidRequest.imp.video.skipmin.
    • Résultat : votre enchère participe à la mise aux enchères. Si votre enchère l'emporte et que la création vidéo s'affiche, elle s'affiche comme désactivable.

Formats vidéo

Comment les acheteurs peuvent-ils inclure des vidéos ?

Les tableaux suivants illustrent les façons dont les acheteurs peuvent inclure des vidéos dans leurs créations et les emplacements dans lesquels elles peuvent être diffusées pour le Web et les applications mobiles, respectivement.

Web

Création vidéo InStream (tous) In-Feed/In-Article In-feed/In-article natif Interstitiel InBanner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JS personnalisé

 

Native + VAST

 

Application mobile

Création vidéo InStream (tous) In-Feed/In-Article In-feed/In-article natif Interstitiel InBanner

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

JS personnalisé

Native + VAST

Clé : Format/technologie non disponible

Création vidéo acceptée dans cet emplacement, sous réserve des blocages de l'éditeur

Création vidéo non disponible sur cet emplacement

Signaux OpenRTB recommandés

Les tableaux suivants illustrent les signaux recommandés par OpenRTB pour tous les formats vidéo sur le Web pour ordinateur et mobile, et dans les applications mobiles.

Ordinateur et Web mobile

Format vidéo Signaux recommandés (signaux pertinents pour les vidéos uniquement) Signaux associés (signaux pertinents pour la vidéo uniquement)

InStream (VPAID)

Objet VIDEO présent  &
video.placement = INSTREAM   &


InStream (sans VPAID)

Objet VIDEO présent  &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0


Non InStream

Objet VIDEO présent

video.linearity: linear
placement depends on actual
placement, values as below
Video.startdelay = 0


In-Feed

Objet VIDEO présent  &
video.placement = IN-FEED


In-Article

Objet VIDEO présent  &
video.placement = IN-ARTICLE


Natif

Objet NATIVE présent et


InBanner

Objet vidéo non présent &
banner.battr ≠ 6 Vidéo InBanner (lecture automatique) &
banner.battr ≠ 7 Vidéo InBanner (initiée par l'utilisateur)


Application mobile

Format vidéo Détails de la demande d'enchère (uniquement les détails pertinents pour la vidéo)

InStream

Objet VIDEO présent  &
video.placement = INSTREAM    &

video.api = 1 : VPAID 1.0 ou 2 : VPAID 2.0

Non InStream

Objet VIDEO présent

video.linearity: linear
placement depends on actual
placement, values as below
Video.startdelay = 0


In-Feed

Objet VIDEO présent  &
video.placement = IN-FEED


In-Article

Objet VIDEO présent  &
video.placement = IN-ARTICLE


Natif

Objet NATIVE présent et


Interstitiel (VAST)

Objet VIDEO présent  &
video.placement = INTERSTITIAL


Interstitiel (sans VAST)

Objet VIDEO présent  &
video.placement = INTERSTITIAL

Filtré

InBanner (MRAID)

Objet vidéo non présent &
banner.battr ≠ 6 Vidéo InBanner (lecture automatique) &
banner.battr ≠ 7 Vidéo InBanner (initiée par l'utilisateur)


InBanner

(sans MRAID)

Objet vidéo non présent &
banner.battr ≠ 6 Vidéo InBanner (lecture automatique) &
banner.battr ≠ 7 Vidéo InBanner (initiée par l'utilisateur)


Comment les éditeurs peuvent-ils autoriser ou interdire les vidéos ?

Le tableau suivant illustre les différentes manières dont les éditeurs peuvent autoriser ou non les vidéos dans leurs emplacements.

Option de pub Formats applicables Décrit dans la demande d'enchère comme

Spécifier un bloc d'annonces vidéo InStream

InStream (tous)

Objet vidéo présent et
video.placement = INSTREAM

Activer VPAID

InStream Web

Objet vidéo présent et
video.api = 1 (VPAID 1.0) ou 2 (VPAID 2.0)

Activer la validation de l'identité de l'entreprise

InBanner

Interstitiel

banner.battr ≠ 6 Vidéo InBanner (lecture automatique) et/ou 7 Vidéo InBanner (initiée par l'utilisateur)

Activer (instructions)

In-Feed

In-Article

Objet vidéo présent et
video.placement = IN-FEED ou IN-ARTICLE

Activez les annonces non InStream (instructions).

Natif

Objet natif présent

Bloquer l'interstitiel vidéo

Interstitiel pour une application

Objet VIDEO non présent

Cas particuliers

# Description du cas Commentaires Demande d'enchère

1

Fermeture personnalisée différée à l'aide de MRAID

Pour les interstitiels, la fermeture de l'annonce peut envoyer une notification à l'acheteur à l'aide de MRAID, même s'il n'a pas utilisé de fermeture personnalisée.


Le bouton de fermeture Authorized Buyers s'affiche toujours au-dessus de tout bouton de fermeture personnalisé, même si ce dernier apparaît en dessous après cinq secondes.


Glossaire

Consultez le glossaire des vidéos Authorized Buyers.

Champs pertinents pour les formats InStream et non InStream

Consultez OpenRTB 2.5 (à partir de la page 47).

BidRequest.Video.
Placement
InStream mWeb

1 : InStream
2 : InBanner

mApp

1 : InStream
2 : InBanner

Non InStream mApp Interstitial

5 : interstitiel

Native

3 : In-Article
4 : In-Feed

Rewarded

rwdd : bool

linearity

Indique si l'impression doit être linéaire, non linéaire, etc. Si aucune valeur n'est spécifiée, toutes les valeurs sont autorisées.

InStream mWeb

1 : LINEAR (InStream)

mApp

1 : LINEAR (InStream)

Non InStream mApp Interstitial

2 : INTERSTITIAL

Native

3 : IN_FEED
5 : IN_ARTICLE

videoad_start_delay
InStream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Non InStream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Source de la valeur de la demande d'enchère

Objet
OpenRTB
Champs Authorized Buyers
/Exchange
Bidding
Non-InStream
Exemples de valeurs Qui le détermine ?
/D'où provient cette valeur ?
Objet
Vidéo mimes oui "["application/javascript",
"video/mp4"]",
Google
minduration non Configuré par l'éditeur
maxduration oui Configuré par l'éditeur
playbackmet
hod
oui [6] Généralement, l'éditeur
Configuré
api (MRAID) oui [1,2] Google
protocols oui [2,3,5,6,7,8] Google
linéarité oui [1] Google
placement oui [1] Google
largeur du lecteur oui 400,400,300 Google
hauteur du lecteur oui 225 300 153 Google
délai de démarrage oui 0 Google, 5 s par défaut
passer oui 1 Éditeur/Google
- pour les interstitiels => Google
- pour les annonces InStream => l'éditeur
décide d'autoriser les annonces
désactivables, non désactivables ou les deux.
Annonces avec récompense, toujours non désactivables ;
débit min. Non Google
débit maximal non Google
pos oui 1 Google
Appareil
Ratio des pixels oui 1 Google
impression
Sécurisé oui 1 Google
valeur par défaut : true
car le tag d'emplacement publicitaire est toujours
sécurisé