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.skipest défini surtrue, 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
poddurest défini, mais quemaxseqn'est pas défini ou est défini sur0, 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_UNKNOWNL'emplacement est inconnu ou indéterminable. PLCMT_INSTREAMAnnonces 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_CONTENTAnnonces 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_INTERSTITIALAnnonces 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_STANDALONEAnnonces 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_ONSe lance au chargement de la page avec le son activé. AUTO_PLAY_SOUND_OFFSe lance au chargement de page, sans le son. CLICK_TO_PLAYSe lance au clic avec le son activé. MOUSE_OVERLa lecture démarre lorsque l'utilisateur pointe la souris sur l'annonce, avec le son activé. ENTER_SOUND_ONSe lance lorsque l'annonce entre dans la fenêtre d'affichage, avec le son activé. ENTER_SOUND_OFFLa 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.durfloorsetBidRequest.imp.audio.durfloors-
Tableau d'objets
DurFloorsindiquant 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
durfloorsspécifié par Google :{"maxdur": 16, "bidfloor": 5}représentant(0, 16)secondes à$5.{"mindur": 16, "maxdur": 31, "bidfloor": 10}représentant[16, 31)secondes à$10.{"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.
MOBILEAlias obsolète pour HIGHEND_PHONE ou TABLET. PERSONAL_COMPUTERInclut les ordinateurs de bureau et portables. CONNECTED_TVinclut à la fois les TV connectées (c'est-à-dire les smart TV) et les appareils connectés (comme Roku, Apple TV, etc.). HIGHEND_PHONEInclut les téléphones haut de gamme. TABLETInclut les tablettes. CONNECTED_DEVICEInclut les appareils de jeu dédiés. SET_TOP_BOXInclut les boîtiers décodeurs. OOH_DEVICEInclut 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.typeest défini surcompletion_rate,Metric.valueest 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.0indique 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
Bannerrepré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/xmlIl 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.isVpaidde 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.skipdéfini sur0pour le format JSON oufalsepour 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.skipdéfini sur1pour le format JSON outruepour 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 ?
- Signaux OpenRTB recommandés pour tous les formats vidéo
- Signaux recommandés pour le proto Authorized Buyers pour tous les formats vidéo
- Comment les éditeurs peuvent-ils autoriser/interdire les vidéos ?
- Cas particuliers
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 & |
|
InStream (sans VPAID) |
Objet VIDEO présent & |
|
Non InStream |
Objet VIDEO présent
|
|
In-Feed |
Objet VIDEO présent & |
|
In-Article |
Objet VIDEO présent & |
|
Natif |
Objet NATIVE présent et |
|
InBanner |
Objet vidéo non présent & |
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 & |
|
Non InStream |
Objet VIDEO présent
|
|
In-Feed |
Objet VIDEO présent & |
|
In-Article |
Objet VIDEO présent & |
|
Natif |
Objet NATIVE présent et |
|
Interstitiel (VAST) |
Objet VIDEO présent & |
|
Interstitiel (sans VAST) |
Objet VIDEO présent & |
Filtré |
InBanner (MRAID) |
Objet vidéo non présent & |
|
InBanner (sans MRAID) |
Objet vidéo non présent & |
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 |
Activer VPAID |
InStream Web |
Objet vidéo présent et |
Activer la validation de l'identité de l'entreprise |
InBanner Interstitiel |
|
Activer (instructions) |
In-Feed In-Article |
Objet vidéo présent et |
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
|
|
||||
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.
|
||||
videoad_start_delay
|
|
||||
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"]", |
|
| 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] | ||
| protocols | oui | [2,3,5,6,7,8] | ||
| linéarité | oui | [1] | ||
| placement | oui | [1] | ||
| largeur du lecteur | oui | 400,400,300 | ||
| hauteur du lecteur | oui | 225 300 153 | ||
| 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 | |||
| débit maximal | non | |||
| pos | oui | 1 | ||
| Appareil | ||||
| Ratio des pixels | oui | 1 | ||
| impression | ||||
| Sécurisé | oui | 1 | Google valeur par défaut : true car le tag d'emplacement publicitaire est toujours sécurisé |