Avec le lancement de la compatibilité des annonces vidéo, les acheteurs peuvent acheter de l'inventaire vidéo via Authorized Buyers. Ce document décrit les conditions requises pour l'intégration des achats via RTB à l'aide du protocole Authorized Buyers. Pour en savoir plus sur les protocoles disponibles, consultez la section Sélectionner un protocole du guide de démarrage.
Les acheteurs peuvent acheter un inventaire vidéo sur plusieurs emplacements, pour le moment, au format InStream et interstitiel. Pour en savoir plus, consultez Annonces interstitielles.
Conditions requises pour les acheteurs
Les nouveaux acheteurs RTB doivent développer leurs enchérisseurs à l'aide du dernier tampon de protocole et des informations décrites dans les sections suivantes. Pour télécharger le protocole, accédez à la page Données de référence sur les enchères en temps réel. Pour en savoir plus sur le développement d'un enchérisseur, consultez Traiter la demande et Créer la réponse.
Macros prises en charge
Les macros suivantes sont acceptées avec les créations vidéo InStream:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Les macros de clic (telles que CLICK_URL_ESC
) ne sont pas nécessaires, car Authorized Buyers inclut ses outils de suivi des clics dans un wrapper VAST.
Par conséquent, les macros de clic ne sont pas compatibles avec les annonces vidéo InStream.
Pour en savoir plus sur les macros compatibles, consultez la section Spécifier les macros sous Créer la réponse.
Détails de l'accroche
Le protocole d'enchères en temps réel utilise un message vidéo, défini dans le fichier real-time-bidding-proto.txt, pour identifier les demandes d'enchères vidéo et fournir des informations supplémentaires sur celles-ci.
La liste des champs suivante dans le message vidéo imbriqué fournit également des descriptions détaillées et des exemples:
description_url
-
URL, sans paramètres, de la page décrivant le contenu vidéo. L'éditeur envoie cette URL à Google. Exemple :
http://www.publisher.com/watchpagelink
EndCapSupport
-
Lorsque cette option est activée, l'annonce associée peut s'afficher en tant qu'image de fin (fiche info) dans l'emplacement vidéo une fois la lecture de l'annonce vidéo terminée.
END_CAP_NOT_ENABLED
L'annonce associée n'est pas affichée sous forme d'image de fin. END_CAP_OPTIONAL
Une image de fin s'affiche si la réponse contient une bannière associée éligible, mais celle-ci n'est pas obligatoire. END_CAP_FORBIDDEN
Une réponse contenant une annonce associée est filtrée. END_CAP_REQUIRED
Une réponse sans annonce associée est filtrée. is_embedded_offsite
- Si la valeur est
true
, la vidéo est intégrée à des pages n'appartenant pas au domaine de l'éditeur. is_rewarded
-
S'il est défini sur
true
, cela signifie que l'utilisateur reçoit une récompense pour avoir visionné l'annonce vidéo. Il peut s'agir, par exemple, de la lecture d'un article supplémentaire sans frais, d'une vie supplémentaire dans un jeu ou d'une session musicale sponsorisée sans publicité. max_ad_duration
-
Durée maximale autorisée de l'annonce renvoyée en millisecondes. Lorsque ce paramètre est défini sur
0
, il n'y a pas de durée maximale. max_ads_in_pod
- Nombre maximal d'annonces dans une série d'annonces vidéo Authorized Buyers. Une valeur non nulle indique que l'espace publicitaire actuel est une série d'annonces vidéo pouvant diffuser plusieurs annonces vidéo. 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.
min_ad_duration
- Durée minimale de l'annonce à renvoyer, en millisecondes. Si cette valeur n'est pas définie ou si elle est inférieure ou égale à zéro, aucune durée minimale n'est imposée.
Placement
- Décrit l'endroit où la vidéo sera lue.
UNKNOWN_PLACEMENT
L'emplacement est inconnu ou indéterminé. INSTREAM
Une annonce InStream est diffusée avant, pendant ou après d'autres contenus vidéo. Ce type de publicité est semblable à celui d'une publicité télévisée traditionnelle. Le contenu vidéo visionné par l'utilisateur n'est pas lu pendant la lecture de l'annonce. INTERSTITIAL
Interstitiel signifie que l'annonce vidéo est diffusée devant un contenu autre que vidéo (par exemple, un article d'actualités ou un jeu vidéo). L'annonce couvre la totalité ou la quasi-totalité de l'espace à l'écran occupé par le contenu, et l'utilisateur ne peut pas accéder au contenu tant que l'annonce n'est pas terminée ou n'a pas été ignorée. IN_FEED
Le format vidéo In-Feed est une création vidéo qui s'affiche lorsque l'utilisateur fait défiler un flux de contenu (généralement un flux d'application de réseau social, un article d'actualité, etc.). La vidéo s'affiche dans le flux principal, et dans le flux de vision et de lecture de l'utilisateur. La vidéo ne s'affiche pas sur le côté comme pour les vidéos InBanner. skippable_max_ad_duration
- Durée maximale en millisecondes de l'annonce que vous devez renvoyer si cette annonce est désactivable. Elle diffère généralement de la durée maximale autorisée pour les annonces non désactivables. Si ce champ n'est pas défini ou si sa valeur est inférieure ou égale à zéro, n'importe quelle durée est autorisée.
VideoPlaybackMethod
-
Décrit comment lire l'annonce vidéo.
Selon la meilleure mesure disponible, la méthode de lecture est de type "lecture automatique" ou "click-to-play".
AUTO_PLAY_SOUND_ON
signifie que l'annonce est lue automatiquement avec le son. AUTO_PLAY_SOUND_OFF
signifie que l'annonce est lue automatiquement sans le son. CLICK_TO_PLAY
signifie que l'annonce n'est pas lue tant que l'utilisateur ne clique pas dessus. video_ad_skippable
- Il s'agit d'une valeur de
SkippableBidRequestType
qui contient l'une des valeurs suivantes:ALLOW_SKIPPABLE
signifie que les annonces désactivables et non désactivables sont autorisées. REQUIRE_SKIPPABLE
signifie que seules des annonces désactivables peuvent être renvoyées. BLOCK_SKIPPABLE
signifie que seules les annonces non désactivables peuvent être renvoyées. Si ce champ n'est pas défini, les annonces désactivables sont autorisées par défaut.
videoad_start_delay
-
Durée en millisecondes entre le début de la vidéo et le moment où l'annonce est diffusée. La valeur 0 correspond à une annonce vidéo pré-roll, et la valeur -1 à une annonce vidéo post-roll. Toute autre valeur positive indique que l'espace publicitaire se trouve au milieu de la vidéo.
La valeur n'est valide que si ce paramètre est défini. Si cette règle n'est pas configurée, la position d'affichage est inconnue.
Ces signaux ne sont pas propres aux créations vidéo, mais ils sont particulièrement utiles aux enchérisseurs:
advertising_id
- Ce champ correspond à un UUID de 16 octets défini uniquement lors de l'utilisation de SSL.
Il s'agit de la version non chiffrée de
encrypted_advertising_id
. Pour les appareils iOS, il contient l'identifiant publicitaire (IDFA, Identifier for Advertisers). Pour les appareils Android, il contient l'identifiant Android (ADID). Pour les appareils pour la télévision connectée, il contient leurs identifiants uniques (par exemple, le RIDA de Roku). device_type
- Spécifie le type d'appareil.
UNKNOWN_DEVICE
est la valeur par défaut pour ce champ. HIGHEND_PHONE
inclut les téléphones portables dotés de capacités vidéo. TABLET
inclut les tablettes. PERSONAL_COMPUTER
comprend 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.). GAME_CONSOLE
inclut des appareils de jeu dédiés. brand
- Marque de l'appareil (Nokia ou Samsung, par exemple). Ce champ est facultatif ; par défaut, il n'est pas spécifié.
model
- Spécifie le modèle exact (par exemple, N70 ou Galaxy) de l'appareil. Ce champ est facultatif ; par défaut, il n'est pas spécifié.
screen_orientation
-
Spécifie l'orientation de l'appareil lors de l'envoi de la demande d'annonce.
Les valeurs valides sont
LANDSCAPE
,PORTRAIT
etUNKNOWN_ORIENTATION
. viewability
- Fournit une estimation de la probabilité que cet emplacement soit visible par l'utilisateur final en fonction de la fréquence à laquelle il a été visible par le passé. Exprimé en pourcentage compris dans la plage [0, 100]. La valeur par défaut
-1
indique que les données de l'historique de visibilité ne sont pas disponibles. content_attributes.duration_seconds
-
Combien de secondes (par exemple, 200) la vidéo est lue.
Cette opération est déclarée dans le message
ContentAttributes
. Ce paramètre est défini sur la valeur indiquée dans les métadonnées de la vidéo fournies par l'éditeur de la vidéo.
La demande d'enchère vidéo contient également des informations sur l'inventaire, telles que le secteur concerné, les fournisseurs autorisés et la chaîne. Tous les autres champs existants de la demande d'enchère s'appliquent également à la vidéo.
Les champs de largeur et de hauteur du message AdSlot d'une requête vidéo correspondent à la taille du lecteur d'annonces vidéo.
allowed_vendor_type
- Le fournisseur autorisé. Consultez le fichier vendors.txt dans la documentation technique pour obtenir la liste des ID. Par exemple, 309 = Bloc vidéo Campaign Manager.
allowed_video_formats
- Décrit les technologies vidéo autorisées pour les annonces diffusées en réponse à cette demande.
La réponse doit indiquer la compatibilité avec au moins l'un d'entre eux.
Les valeurs de ce champ répété proviennent de l'énumération VideoFormat:
VIDEO_FLASH
Autorise les vidéos au format Flash Video (FLV). VIDEO_HTML5
Autorise les vidéos au format vidéo HTML5. VPAID_FLASH
Autorise les vidéos utilisant le format vidéo Flash VPAID (Video Player Ad-Serving Interface Definition). VPAID_JS
Autorise les vidéos au format vidéo JavaScript JavaScript. companion_slot
- Ce champ représente un message CompanionSlot comprenant les champs suivants:
height
Hauteurs disponibles pour cet emplacement. width
Largeurs disponibles pour cet emplacement. CreativeFormat
Le format de la création représente les formats possibles de la création dans cet espace associé. url
-
URL de la page de lecture de la vidéo ou de la page sur 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 dans le champ video_url
.
La réponse à l'enchère doit également contenir la déclaration adéquate pour l'annonce vidéo.
Vous trouverez ci-dessous un extrait d'une réponse à l'enchère vidéo appropriée:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
Dans une réponse à une enchère vidéo, les principaux champs sont les suivants:
attribute
-
Il s'agit de tous les attributs des annonces susceptibles d'être diffusées à partir de cet extrait. Consultez le fichier
buyer-declarable-creative-attributes.txt pour obtenir la liste des ID.
Nous vérifions qu'aucun de ces attributs ne figure dans la liste
excluded_attribute
de la demande d'enchère. Ne définissez ce champ que si un extrait de code HTML ou une annonce vidéo sont renvoyés. Par exemple, si ce champ est défini sur30
, cela signifie que l'annonce nécessite la compatibilité avec VPAID pour être affichée. protocol
-
Décrit les versions VAST compatibles avec les demandes d'annonces vidéo par un éditeur, permettant ainsi les annonces VAST jusqu'à la version donnée (incluse).
Inclut un ensemble de protocoles d'annonces vidéo compatibles.
Cela correspond au comportement dans OpenRTB 2.4.
Les valeurs suivantes sont possibles :
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
etVAST_4_0_WRAPPER
. video_url
-
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
- Comment les acheteurs peuvent-ils inclure des annonces vidéo ?
- Signaux OpenRTB recommandés pour tous les formats vidéo
- Signaux proto recommandés Authorized Buyers pour tous les formats vidéo
- Comment les éditeurs peuvent-ils autoriser ou interdire les annonces vidéo ?
- Cas limites
Préciblage
Afin de pouvoir recevoir de l'inventaire vidéo, les acheteurs RTB doivent disposer d'une configuration de préciblage pour RTB incluant l'inventaire vidéo.
Exemples de demandes et de réponses aux enchères
Formats vidéo AdX
Comment les acheteurs peuvent-ils inclure des annonces vidéo ?
Les tableaux suivants illustrent les manières dont les acheteurs peuvent inclure des vidéos dans leurs créations et les emplacements dans lesquels elles peuvent être diffusées respectivement sur le Web et dans des applications mobiles.
Web
Création vidéo | InStream (tous) | In-Feed/Article | Annonce In-Feed/Article native | Interstitiel | InBanner |
---|---|---|---|---|---|
VPAID et VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
JS personnalisé |
|
||||
Format natif et VAST |
|
Application mobile
Création vidéo | InStream (tous) | In-Feed/Article | Annonce In-Feed/Article native | Interstitiel | InBanner |
---|---|---|---|---|---|
VPAID et VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
JS personnalisé |
|||||
Format natif et VAST |
Clé : | Format/Technologie non disponible | Création vidéo acceptée dans cet emplacement, sous réserve de blocage par l'éditeur |
Création vidéo non disponible pour cet emplacement |
---|
Signaux recommandés OpenRTB
Les tableaux suivants illustrent les signaux OpenRTB recommandés pour tous les formats vidéo pour le Web pour ordinateur et mobile et pour les applications mobiles.
Web pour ordinateur et pour mobile
Format vidéo | Signaux recommandés (signaux de vidéo pertinents uniquement) | Signaux associés (signaux pertinents pour les vidéos uniquement) |
---|---|---|
InStream (VPAID) |
Objet VIDEO présent & |
|
InStream (pas de VPAID) |
Objet VIDEO présent & |
|
Annonces OutStream |
Objet VIDEO présent
|
|
Annonces In-Feed |
Objet VIDEO présent & |
|
In-Article |
Objet VIDEO présent & |
|
Natif |
Objet NATIVE présent et |
|
InBanner |
Objet vidéo absent et |
Application mobile
Format vidéo | Détails de la demande d'enchère (uniquement les détails pertinents de la vidéo) | |
---|---|---|
InStream |
Objet VIDEO présent & |
|
Annonces OutStream |
Objet VIDEO présent
|
|
Annonces 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 (pas de VAST) |
Objet VIDEO présent & |
Filtrage |
InBanner (MRAID) |
Objet vidéo absent et |
|
InBanner (pas de MRAID) |
Objet vidéo absent et |
Signaux recommandés pour le protocole AdX
Les tableaux suivants illustrent les signaux recommandés pour les prototypes Authorized Buyers pour tous les formats vidéo pour le Web pour ordinateur et mobile, et pour les applications mobiles.
Web pour ordinateur et pour mobile
Format vidéo | Signaux recommandés pour les vidéos | Signaux associés concernant la vidéo |
---|---|---|
InStream (VPAID) |
Message VIDÉO présent & |
|
InStream (pas de VPAID) |
Message VIDÉO présent & |
Allowed_video_formats = VIDEO_HTML5 & |
Annonces In-Feed |
Message VIDÉO présent & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Article |
Message VIDÉO présent & |
|
Natif |
Message NATIVE présent & |
|
InBanner |
|
|
Application mobile
Les tableaux suivants illustrent les signaux recommandés pour les prototypes AdX pour tous les formats vidéo pour le Web pour ordinateur et mobile, et pour les applications mobiles.
Format vidéo | Détails des demandes d'enchères pertinentes pour les vidéos | Signaux associés aux vidéos |
---|---|---|
InStream |
Message VIDEO présent |
|
Annonces In-Feed |
Message VIDÉO présent & |
|
In-Article |
Message VIDÉO présent & |
|
Natif |
Message NATIVE présent & |
|
Interstitiel |
Message VIDÉO présent & |
|
InBanner (MRAID) |
|
|
InBanner (pas de MRAID) |
|
|
Comment les éditeurs peuvent-ils autoriser ou interdire la vidéo ?
Les tableaux suivants montrent comment les éditeurs peuvent autoriser ou interdire la vidéo sur leurs emplacements, et comment cela se manifeste dans la demande d'enchère pour OpenRTB et AdX Proto.
OpenRTB
Option de pub | Formats applicables | Décrit dans la demande d'enchère comme |
---|---|---|
Spécifier une vidéo InStream dans un bloc |
InStream (tous) |
Objet vidéo présent et |
Activer VPAID |
InStream pour le Web |
Objet vidéo présent et |
Activer la fonctionnalité IBV |
InBanner Interstitiel |
|
Activer le format OutStream (instructions) |
Annonces In-Feed In-Article |
Objet vidéo présent et |
Activer le format OutStream (instructions) |
Natif |
Objet natif présent |
Bloquer l'interstitiel vidéo |
Application interstitielle |
Objet VIDEO inexistant |
Proto AdX
Option de pub | Formats applicables | Décrit dans la demande d'enchère comme suit (REMARQUE: TOUS les indicateurs de l'option "Pub" sont disponibles dans la demande d'enchère. Pour les signaux recommandés, consultez le tableau ci-dessous) | Paramètre par défaut |
---|---|---|---|
Spécifier une vidéo InStream dans un bloc |
InStream (tous) |
Message vidéo présent et |
N/A |
Activer VPAID |
InStream pour le Web |
Message vidéo présent et
|
Désactivé |
Activer la fonctionnalité IBV |
InBanner Interstitiel |
|
Désactivé |
Activer le format OutStream (instructions) |
Annonces In-Feed In-Article |
Message vidéo présent et |
Désactivé |
Activer le format OutStream (instructions) |
Natif |
Message NATIVE présent et
|
Désactivé |
Bloquer l'interstitiel vidéo |
Application interstitielle |
Message VIDEO manquant et |
Activé |
Cas extrêmes
# | Description du cas | Commentaires | Demande d'enchère |
---|---|---|---|
1 |
Fermeture personnalisée différée avec MRAID |
Pour les interstitiels, la fermeture de l'annonce permet d'envoyer une notification à l'acheteur via MRAID, même s'il n'a pas utilisé de fermeture personnalisée. La croix (X) appliquée à AdX apparaît toujours au-dessus de toute fermeture personnalisée, même si celle-ci apparaît en dessous au bout de cinq secondes. |
Glossaire
Consultez le glossaire vidéo Authorized Buyers.
Champs AdX et OpenRTB aux formats InStream et OutStream
Proto AdX
"BidRequest.Video". | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Proto OpenRTB
Voir 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 vous n'en spécifiez aucune, partez du principe que toutes sont autorisées.
|
||||
videoad_start_delay
|
|
Source de la valeur de la demande d'enchère
Objet OpenRTB | Champs | AdX /Place de marché Enchères OutStream |
Exemples de valeur | Qui la détermine ? /D'où cette valeur provient de ? |
---|---|---|---|---|
Objet | ||||
Vidéo | Mimes | oui | ["application/javascript", "video/mp4"]", |
|
minduration | non | Configurée par l'éditeur | ||
maxduration | oui | Configurée par l'éditeur | ||
durée de visionnage hod |
oui | [6] | Généralement configuré par l'éditeur |
|
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 | ||
retard de début | oui | 0 | Google, 5 s par défaut | |
ignorer | oui | 1 | Éditeur/Google - pour Interstitiel => Google - Pour InStream => L'éditeur décide d'autoriser comme désactivable, non désactivable ou les deux. Annonces avec récompense, toujours non désactivables |
|
débit min. | Non | |||
débit maximal | non | |||
pos | oui | 1 | ||
Appareil | ||||
Ratio Px | oui | 1 | ||
impression | ||||
Sécuriser | oui | 1 | Google est défini par défaut sur "true ", car le tag d'emplacement publicitaire est toujours sécurisé. |