Annonces vidéo

Ce guide décrit les exigences d'intégration, la configuration champs pertinents du protocole OpenRTB que vous pouvez utiliser lorsque vous définissez des enchères sur des annonces vidéo de l'inventaire. Le protocole Google RTB est obsolète et ne fait pas partie de nos priorités. dans ce guide. Pour en savoir plus sur les annonces vidéo dans le protocole Google RTB, consultez le Guide sur les annonces vidéo dans le système d'enchères en temps réel de Google.

Google accepte les annonces vidéo InStream, natives et interstitielles. Pour en savoir plus sur ces formats, consultez les guides sur les formats d'annonces natives et interstitielles.

Exigences concernant les acheteurs

Protocole du système d'enchères en temps réel

Ce guide se réfère généralement au format Protobuf, mais les noms de champs et les chemins d'accès sont équivalents entre celui-ci et le format JSON, sauf indication contraire.

Vous trouverez le protocole OpenRTB et les extensions OpenRTB spécifiques à Google sur la page Protos 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 d'enchérir de l'IA générative. Vous pouvez utiliser l'API Real-time Bidding Ressource "Creative" pour lancer le processus d'examen.

Configuration de préciblage

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

Macros

Vous pouvez spécifier des macros dans l'URL de la vidéo ou dans le code XML VAST spécifié dans BidResponse.seatbid.bid.adm. En outre, si vous spécifiez une vidéo URL, vous pouvez également insérer des macros dans le document XML VAST associé. Les macros suivantes sont acceptées pour 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 les outils de suivi des clics dans un wrapper VAST. Pour plus plus d'informations sur les macros compatibles, consultez Spécifier les macros

Détails de l'accroche

Le champ BidRequest.imp.video d'OpenRTB permet d'identifier si une demande d'enchère entrante concerne des vidéos InStream ou interstitielles et trouver des informations supplémentaires concernant la demande pour les vidéos. De plus, pour l'inventaire d'annonces natives, vous pouvez utiliser BidRequest.imp.native.{request/request_native}.assets.video pour des informations similaires spécifiques aux vidéos.

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

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

http://www.publisher.com/watchpagelink
banner.vcm
Si la valeur est true, l'annonce associée peut être sélectionnée pour être affichée en tant que fin de série (fiche d'informations) dans l'espace publicitaire vidéo une fois la vidéo terminée. Sinon, l'annonce associée ne s'affiche pas en tant qu'image de fin.
BidRequest.imp.rwdd
S'il est défini sur true, il indique que l'utilisateur reçoit une une récompense pour avoir visionné l'annonce vidéo. Généralement, la récompense consiste à lire un article en plus sans frais, bénéficier d'une vie supplémentaire dans un jeu ou obtenir une session musicale sponsorisée et sans publicité.
BidRequest.imp.video.maxduration

Durée maximale autorisée (en secondes) de l'annonce à renvoyer. Si cet attribut n'est pas défini, aucune durée maximale n'est appliquée. Quand ? BidRequest.imp.video.skip est true, cela peut se comportent différemment. Consultez Durée maximale des vidéos désactivables. pour en savoir plus.

BidRequest.imp.video.maxseq

Nombre maximal d'annonces dans la série d'annonces vidéo. Si cette valeur n'est pas définie, l'espace publicitaire ne fait pas partie d'un pod 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.

BidRequest.imp.video.minduration
Durée minimale de l'annonce à renvoyer, en secondes. Si cet attribut 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 impossible à déterminer.
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 le consommateur. Le son doit être activé pour la vidéo InStream. par défaut à ou que l'utilisateur ait clairement l'intention de regarder du contenu vidéo. Même si d'autres contenus le contenu vidéo doit être l'élément principal de la visite de l'utilisateur. Il doit rester le contenu principal de la page et la seule vidéo lecteur intégré capable d'activer le son lors de la lecture. Si le joueur est convertie en Flash transparent/persistant, les appels d'annonces ultérieurs doivent indiquer la nouvelle taille du lecteur.
PLCMT_ACCOMPANYING_CONTENT Les annonces pré-roll, mid-roll et post-roll qui sont lues avant pendant ou après la diffusion d'un contenu vidéo. Le lecteur vidéo se charge et se lit avant, entre ou après des paragraphes de texte ou de contenu graphique, et ne commence à lire que lorsqu'il entre dans le viewport. La lecture du contenu associé ne doit démarrer que lorsque vous accédez à l'élément fenêtre d'affichage. Il peut se transformer en lecteur flottant ou persistant lorsqu'il fait défiler l'écran. de la page.
PLCMT_INTERSTITIAL Annonces vidéo lues sans contenu vidéo. Pendant la lecture, elle doit constituer l'élément principal de la page et occuper la plus grande partie de la fenêtre d'affichage. Il est impossible de la faire disparaître en faisant défiler l'écran. Il peut se trouver dans comme les vidéos ou diaporamas intégrés à l'application.
PLCMT_NO_CONTENT_STANDALONE Annonces vidéo lues sans contenu vidéo en streaming. Cela peut être diffusées dans des diaporamas, des flux natifs, collantes/flottantes.
BidRequest.imp.video.playbackmethod
Indique comment lire l'annonce vidéo. La méthode de lecture choisie est "lecture automatique" ou "click-to-play". en fonction des meilleures mesures disponibles.
AUTO_PLAY_SOUND_ON Démarre au chargement de la page avec le son activé.
AUTO_PLAY_SOUND_OFF Démarre au chargement de la page, sans le son.
CLICK_TO_PLAY Démarre à l'aide d'un clic avec le son activé.
MOUSE_OVER Démarre lorsque vous pointez dessus avec le son activé.
ENTER_SOUND_ON Démarre lorsque l'utilisateur entre dans la fenêtre d'affichage avec le son activé.
ENTER_SOUND_OFF Démarre à l'ouverture de la fenêtre d'affichage, le son étant désactivé par défaut.
BidRequest.imp.video.skip
Si la valeur est true, cela signifie que le lecteur autorise la vidéo à être ignorée ou que les annonces désactivables sont autorisées. Sinon, cela indique que les annonces désactivables ne sont pas autorisées.
BidRequest.imp.video.startdelay

Une valeur de 0 indique 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.

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

BidRequest.device.ifa
Ce champ est un UUID de 36 caractères défini uniquement lors de l'utilisation de SSL. et non hachées. Il s'agit de la version non chiffrée 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 connectés, il contient leurs identifiants uniques (par exemple, le RIDA de Roku).
BidRequest.device.devicetype
Spécifie le type d'appareil.
MOBILE Alias obsolète de HIGHEND_PHONE ou TABLET.
PERSONAL_COMPUTER Inclut les ordinateurs de bureau et portables.
CONNECTED_TV comprend à la fois les TV connectées (c'est-à-dire les smart TV) et les appareils (comme Roku, Apple TV, etc.).
HIGHEND_PHONE Inclut les téléphones haut de gamme.
TABLET y compris 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 publicitaires extérieurs, par exemple les panneaux d'affichage numériques.
BidRequest.device.make
Spécifie la marque (Nokia ou Samsung, par exemple) de l'appareil.
BidRequest.device.model
Spécifie le modèle exact (par exemple, N70 ou Galaxy) de l'appareil, le cas échéant. 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 dans la plage [0,0, 1,0] représentant l'historique du taux de finalisation des annonces vidéo diffusées dans l'espace publicitaire. La valeur par défaut -1.0 indique que les données historiques les données sur le taux d'achèvement ne sont pas disponibles.
BidRequest.imp.video.poddur
La durée totale de la coupure publicitaire (en secondes), y compris tous les emplacements de la série d'annonces. Cette valeur est définie sur celle spécifié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. comme le secteur, 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 "width" et "height" 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 vidéo DFA.
BidRequest.imp.video.mimes
Liste d'autorisation décrivant les types MIME de contenu acceptés pour les annonces diffusées dans la réponse à la demande d'enchère ; Exemple : "video/mp4". La réponse à l'enchère doit indiquer que l'annonce est compatible avec au moins l'un de ces formats.
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 enum 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 comprend 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 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 vidéo, l'enchérisseur doit renvoyer une redirection VAST. une URL ou XML VAST dans le champ BidResponse.seatbid.bid.adm. La réponse aux enchères doit également contenir la déclaration appropriée pour l'annonce vidéo. Voici un extrait d'une réponse d'enchère vidéo appropriée : 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

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

BidResponse.seatbid.bid.ext.attribute
Attributs des annonces susceptibles d'être diffusées à partir de cet extrait. Consultez le buyer-declarable-creative-attributes.txt pour obtenir la liste des identifiants. Nous vérifions qu'aucun de ces attributs ne correspond à ceux interdits 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 prise en charge de 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

Formats vidéo

Comment les acheteurs peuvent-ils inclure une vidéo ?

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 (tout) In-Feed/Article Annonces natives dans le flux/article Interstitiel InBanner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JavaScript personnalisé

 

Format natif et VAST

 

Application mobile

Création vidéo InStream (tout) In-Feed/Article Annonces natives dans le flux/article Interstitiel InBanner

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

JavaScript personnalisé

Native + VAST

Clé : Format/technologie non disponible

Création vidéo acceptée dans cet emplacement, si l'éditeur est bloqué

La création vidéo n'est pas 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 les applications mobiles.

Web pour ordinateur et pour mobile

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

InStream (VPAID)

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

InStream (pas de VPAID)

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

Non InStream

Objet VIDEO présent

video.linearity: linear
L'emplacement dépend de l'emplacement réel
(valeurs ci-dessous)
Video.startdelay = 0

In-Feed

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

In-Article

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

Natif

Objet NATIVE présent et

InBanner

Objet vidéo inexistant &
banner.battr ≠ 6 Vidéo InBanner (lecture automatique) et
banner.battr ≠ 7 Vidéo InBanner (déclenchée par l'internaute)

Appli 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  &
video.placement = INSTREAM    &

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

Non InStream

Objet VIDEO présent

video.linearity: linear
L'emplacement dépend de l'emplacement réel
(valeurs ci-dessous)
Video.startdelay = 0

In-Feed

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

In-Article

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

Natif

Objet NATIVE présent et

Interstitiel (VAST)

Objet VIDEO présent et
video.placement = INTERSTITIAL

Interstitiel (sans VAST)

Objet VIDEO présent  &
video.placement = INTERSTITIAL

Filtrage

InBanner (MRAID)

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

InBanner

(MRAID non disponible)

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

Autoriser ou non les vidéos sur les sites des éditeurs

Le tableau suivant montre comment les éditeurs peuvent autoriser ou non les vidéos dans leurs emplacements.

Option "Pub" Formats applicables Décrit dans la demande d'enchère comme

Spécifier une unité pour les vidéos InStream

InStream (tout)

Objet vidéo présent &
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 l'IBV

InBanner

Interstitiel

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

Activer (instructions)

In-Feed

In-Article

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

Activer les annonces non InStream (instructions)

Natif

Objet natif présent

Bloquer la vidéo interstitielle

Interstitiel pour une application

Objet VIDEO inexistant

Cas extrêmes

# 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é la fermeture personnalisée.


Les acheteurs Authorized Buyers appliqués s'affichent toujours au-dessus fermeture personnalisée, même si la fermeture personnalisée apparaît en dessous au bout de 5 secondes

Glossaire

Consultez le glossaire vidéo Authorized Buyers.

Champs pertinents pour les formats InStream et non InStream

Voir 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 : interstitielle

Native

3 : In-Article
4 : In-Feed

Rewarded

is_rewarded_inventory : valeur booléenne de l'extension OpenRTB
linearity

Indique si l'impression doit être linéaire, non linéaire, etc. Si aucune valeur n'est spécifiée, considérez que toutes 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
/Place de marché
Enchère
Non InStream		 Exemples de valeurs Qui la détermine ?
/D'où vient cette valeur
Objet
Vidéo mimes oui ["application/javascript",
"video/mp4"]",		 Google
méconnaissance non Éditeur configuré
maxduration oui Éditeur configuré
lecture :
Hod		 oui [6] Généralement,
de 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
ignorer oui 1 Éditeur/Google
- pour les interstitiels => Google
- pour les InStream => Éditeur
décide d'autoriser les
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 Px oui 1 Google
impression
Sécurisé oui 1 Google
est défini par défaut sur "true"
, car l'attribut adtag est toujours sécurisé.