Grâce à la prise en charge des annonces vidéo, peuvent acheter un inventaire vidéo via Authorized Buyers. Ce document décrit les exigences d'intégration pour les achats via le système d'enchères en temps réel. à l'aide du protocole Authorized Buyers. Pour en savoir plus sur les protocoles disponibles, consultez la Sélectionner un protocole du guide de démarrage.
Les acheteurs peuvent acheter un inventaire vidéo sur différents emplacements, sont actuellement InStream et interstitielles. Voir <ph type="x-smartling-placeholder"></ph> sur les annonces interstitielles.
Exigences concernant les acheteurs
Les nouveaux acheteurs RTB doivent développer leurs enchérisseurs à l'aide du dernier tampon de protocole et les informations fournies dans les sections suivantes. Pour télécharger le protocole, accédez à la page sur les données de référence pour le système d'enchères en temps réel. Pour en savoir plus sur le développement d'un enchérisseur, consultez la section Traiter la demande et Créer la réponse.
Macros prises en charge
Les macros suivantes sont compatibles 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 les 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,
Voir la section Spécifier les macros
sous Build the Response (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 <ph type="x-smartling-placeholder"></ph> Real-time-bidding-proto.txt pour identifier les demandes d'annonces vidéo et de fournir des informations supplémentaires concernant la demande.
Liste des champs suivante dans le message vidéo imbriqué : fournit également des descriptions détaillées et des exemples:
description_url
-
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
EndCapSupport
-
Lorsque cette option est activée, l'annonce associée peut être sélectionnée
s'affiche sous la forme d'une image de fin (fiche info) dans l'emplacement de la vidéo.
après la lecture de l'annonce vidéo.
END_CAP_NOT_ENABLED
L'annonce associée ne s'affiche pas en tant qu'image de fin. END_CAP_OPTIONAL
L'image de fin est affichée si la réponse contient un élément une bannière associée, mais celle-ci n'est pas obligatoire. END_CAP_FORBIDDEN
Une réponse avec une annonce associée est filtrée. END_CAP_REQUIRED
Une réponse sans annonce associée est filtrée. is_embedded_offsite
-
Si elle est définie sur
true
, la vidéo est intégrée sur des pages n'appartenant pas au domaine de l'éditeur ; is_rewarded
-
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é. max_ad_duration
-
Durée maximale autorisée pour l'annonce renvoyée, en millisecondes. Si elle est définie sur
0
, aucune durée maximale n'est définie. 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. qui permet de diffuser plusieurs annonces vidéo. Le nombre réel d'annonces vidéo diffusées peut être de 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 elle n'est pas définie ou si elle est inférieure ou égale à zéro, il n'y a pas de durée minimale.
Placement
-
Décrit où la vidéo sera diffusée.
UNKNOWN_PLACEMENT
L'emplacement est inconnu ou impossible à déterminer. INSTREAM
"InStream" signifie que l'annonce est diffusée avant, pendant ou après d'autres du contenu vidéo. Ce format est semblable à celui d'une publicité télévisée traditionnelle. Le contenu vidéo que l'utilisateur regarde ne peut pas être lu lorsque l'annonce est diffusée. INTERSTITIAL
"Interstitiel" signifie que l'annonce vidéo est diffusée un contenu autre que vidéo (un article d'actualité ou un jeu vidéo, par exemple) ; L'annonce couvre la totalité ou la quasi-totalité de l'espace à l'écran. occupée par le contenu et que l'utilisateur ne peut pas continuer jusqu'à ce que l'annonce soit terminée ou 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, (article de presse, etc.). La vidéo s'affiche dans le flux principal et dans le flux la vision et le flux de lecture. La vidéo ne s'affiche pas sur le côté comme les vidéos InBanner. skippable_max_ad_duration
- Durée maximale de l'annonce, en millisecondes que vous devriez renvoyer si cette annonce est désactivable. Elle diffère généralement de la durée maximale pour les annonces non désactivables. Si ce champ n'est pas défini ou a une valeur inférieure ou égale à zéro, n'importe quelle durée.
VideoPlaybackMethod
-
Décrit comment lire l'annonce vidéo.
La méthode de lecture choisie est la lecture automatique ou le click-to-play.
en fonction des meilleures mesures disponibles.
AUTO_PLAY_SOUND_ON
signifie que l'annonce est lue automatiquement avec le son activé. AUTO_PLAY_SOUND_OFF
signifie que l'annonce est lue automatiquement avec le son coupé. CLICK_TO_PLAY
signifie que l'annonce n'est pas lue tant que l'utilisateur ne clique pas dessus. video_ad_skippable
- Valeur de
SkippableBidRequestType
contenant 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 les annonces désactivables peuvent s'afficher. BLOCK_SKIPPABLE
signifie que seules des annonces non désactivables peuvent s'afficher. Si ce champ n'est pas défini, les annonces désactivables sont autorisées par défaut.
videoad_start_delay
-
Temps écoulé en millisecondes depuis le début de la vidéo jusqu'à ce que l'annonce s'affiche. La valeur 0 correspond à une annonce vidéo pré-roll, et la valeur -1 à une annonce vidéo post-roll. Toutes les autres valeurs positives indiquent s'affiche 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 sont particulièrement utiles pour les enchérisseurs:
advertising_id
- Ce champ est 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 pour les annonceurs (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 de ce champ. HIGHEND_PHONE
inclut les téléphones mobiles dotés de fonctionnalités vidéo. TABLET
y compris les tablettes. PERSONAL_COMPUTER
comprend les ordinateurs de bureau et les ordinateurs portables. CONNECTED_TV
inclut les deux TV connectées (c'est-à-dire les smart TV) et des appareils connectés (tels que Roku, Apple TV, etc.). GAME_CONSOLE
y compris les appareils de jeu dédiés. brand
- Indique la marque de l'appareil (Nokia ou Samsung, par exemple). Ce champ est facultatif. par défaut, elle n'est pas spécifiée.
model
- Spécifie le modèle exact de l'appareil (N70 ou Galaxy, par exemple). Ce champ est facultatif. par défaut, elle n'est pas spécifiée.
screen_orientation
-
Spécifie l'orientation de l'appareil lorsque la demande d'annonce est envoyée.
Les valeurs valides sont
LANDSCAPE
,PORTRAIT
, etUNKNOWN_ORIENTATION
. viewability
-
Fournit une estimation de la probabilité que cet emplacement
sera visible par l'utilisateur final en fonction de la fréquence
étaient visibles par le passé. Exprimé en pourcentage dans
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
-
Durée de lecture de la vidéo (200 secondes, par exemple).
Cela est déclaré dans le message
ContentAttributes
. Valeur définie 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. Tout les autres champs existants dans la demande d'enchère s'appliquent également à la vidéo.
Les champs de largeur et de hauteur du message AdSlot correspondent à la taille du lecteur d'annonce vidéo.
allowed_vendor_type
- Fournisseur autorisé. Consultez le vendors.txt dans la documentation technique pour obtenir la liste des identifiants. Par exemple, 309 = bloc vidéo DFA.
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 vidéo Flash (FLV). VIDEO_HTML5
Autorise les vidéos au format HTML5. VPAID_FLASH
Autorise les vidéos à l'aide du composant Video Player Ad-Serving Format vidéo Flash de définition d'interface (VPAID). VPAID_JS
Autorise les vidéos à l'aide des format vidéo JavaScript VPAID. companion_slot
-
Ce champ représente un message CompanionSlot
comprenant les champs suivants:
height
Hauteurs disponibles pour cet espace publicitaire. width
Largeurs disponibles pour cet emplacement. CreativeFormat
Le format de la création représente les formats possibles pour la création dans cet espace associé. url
-
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
Lorsque vous répondez à une requête 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 appropriée pour l'annonce vidéo.
Voici 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" }
Les champs importants d'une réponse à une enchère vidéo sont les suivants:
attribute
-
Tous les attributs des annonces susceptibles d'être diffusées à partir de cet extrait. Consultez le
<ph type="x-smartling-placeholder"></ph>
purchase-declarable-creative-attributes.txt pour obtenir la liste des ID.
Nous vérifions qu'aucun de ces attributs ne figure dans
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 est renvoyé. Par exemple, si ce champ est défini sur30
, l'annonce doit être compatible avec VPAID pour s'afficher. protocol
-
Décrit les versions VAST acceptées par un éditeur pour les demandes d'annonces vidéo.
autorisant les annonces VAST
jusqu'à la version donnée (incluse).
Contient un tableau des protocoles d'annonces vidéo compatibles.
Cela correspond au comportement d'OpenRTB 2.4.
Les valeurs possibles sont les suivantes:
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. Par 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 recommandés OpenRTB pour tous les formats vidéo
- Signaux recommandés du protocole Authorized Buyers pour tous les formats vidéo
- Comment les éditeurs peuvent-ils autoriser ou interdire les vidéos ?
- Cas limites
Préciblage
Afin de recevoir un inventaire vidéo, les acheteurs utilisant le système d'enchères en temps réel doivent disposer d'un configuration de préciblage pour les enchères en temps réel qui incluent l'inventaire vidéo.
Exemples de demandes d'enchères et de réponses
Formats vidéo AdX
Comment les acheteurs peuvent-ils inclure des vidéos ?
Les tableaux suivants indiquent comment les acheteurs peuvent inclure des vidéos dans leurs créations et les emplacements sur lesquels elles peuvent être diffusées respectivement sur le Web et dans les applications mobiles.
Web
Création vidéo | InStream (tout) | In-Feed/Article | Annonce native In-Feed/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 | Annonce native In-Feed/Article | Interstitiel | InBanner |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
JavaScript personnalisé |
|||||
Format natif et 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 sur ordinateur et Web mobile et application mobile.
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 et |
|
InStream (pas de VPAID) |
Objet VIDEO présent et |
|
Annonces OutStream |
Objet VIDEO présent
|
|
In-Feed |
Objet VIDEO présent et |
|
In-Article |
Objet VIDEO présent et |
|
Natif |
Objet NATIVE présent et |
|
InBanner |
Objet vidéo inexistant & |
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 et |
|
Annonces OutStream |
Objet VIDEO présent
|
|
In-Feed |
Objet VIDEO présent et |
|
In-Article |
Objet VIDEO présent et |
|
Natif |
Objet NATIVE présent et |
|
Interstitiel (VAST) |
Objet VIDEO présent et |
|
Interstitiel (sans VAST) |
Objet VIDEO présent et |
Filtrage |
InBanner (MRAID) |
Objet vidéo inexistant & |
|
InBanner (MRAID non disponible) |
Objet vidéo inexistant & |
Signaux recommandés pour le protocole AdX
Les tableaux suivants illustrent les signaux proto recommandés Authorized Buyers pour tous les formats vidéo pour Web pour ordinateur et pour mobile, et application mobile.
Web pour ordinateur et Web mobile
Format vidéo | Signaux pertinents pour les vidéos recommandés | Signaux associés liés aux vidéos |
---|---|---|
InStream (VPAID) |
Message VIDEO présent et |
|
InStream (pas de VPAID) |
Message VIDEO présent et |
Allowed_video_formats = VIDEO_HTML5 et |
In-Feed |
Message VIDEO présent et |
Allowed_video_formats = VIDEO_HTML5 et |
In-Article |
Message VIDEO présent et |
|
Natif |
Message NATIVE présent et |
|
InBanner |
|
|
Appli mobile
Les tableaux suivants présentent les signaux recommandés du protocole AdX pour tous les formats vidéo pour Web pour ordinateur et pour mobile, et application mobile.
Format vidéo | Détails de la demande d'enchère pertinente pour les vidéos | Signaux associés aux vidéos |
---|---|---|
InStream |
Message VIDÉO présent |
|
In-Feed |
Message VIDEO présent et |
|
In-Article |
Message VIDEO présent et |
|
Natif |
Message NATIVE présent et |
|
Interstitiel |
Message VIDEO présent et |
|
InBanner (MRAID) |
|
|
InBanner (MRAID non disponible) |
|
|
Comment les éditeurs peuvent-ils autoriser/interdire la vidéo ?
Les tableaux suivants indiquent comment les éditeurs peuvent autoriser ou interdire des vidéos dans leurs et de la manière dont ils se manifestent dans la demande d'enchère OpenRTB et AdX Proto.
OpenRTB
Option "Pub" | Formats applicables | Décrit dans la demande d'enchère comme |
---|---|---|
Définir une vidéo InStream dans un bloc |
InStream (tout) |
Objet vidéo présent & |
Activer VPAID |
InStream pour le Web |
Objet vidéo présent & |
Activer l'IBV |
InBanner Interstitiel |
|
Activer le format OutStream (instructions) |
In-Feed In-Article |
Objet vidéo présent & |
Activer le format OutStream (instructions) |
Natif |
Objet natif présent |
Bloquer les interstitiels vidéo |
Interstitiel pour une application |
Objet VIDEO inexistant |
Proto AdX
Option "Pub" | Formats applicables | Décrit dans la demande d'enchère de la manière suivante : (REMARQUE : il s'agit de TOUS les indicateurs de l'option éditeur dans demande d'enchère ; pour les signaux recommandés, consultez le tableau ci-dessous) | Paramètre par défaut |
---|---|---|---|
Définir une vidéo InStream dans un bloc |
InStream (tout) |
Message vidéo présenté & |
n/a |
Activer VPAID |
InStream pour le Web |
Message vidéo présenté &
|
Désactivé |
Activer l'IBV |
InBanner Interstitiel |
|
Désactivé |
Activer le format OutStream (instructions) |
In-Feed In-Article |
Message vidéo présenté & |
Désactivé |
Activer le format OutStream (instructions) |
Natif |
Message NATIVE présent et
|
Désactivé |
Bloquer les interstitiels vidéo |
Interstitiel pour une application |
Message VIDÉO inexistant & |
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 la norme MRAID. même s'ils n'utilisaient pas de fermeture personnalisée. La croix (X) appliquée à AdX apparaîtra toujours au-dessus de toute fermeture personnalisée, même si la fermeture personnalisée apparaît en dessous au bout de 5 secondes |
Glossaire
Voir <ph type="x-smartling-placeholder"></ph> Glossaire vidéo Authorized Buyers
Champs AdX et OpenRTB dans les formats InStream et OutStream
Proto AdX
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Proto OpenRTB
Voir <ph type="x-smartling-placeholder"></ph> 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, nous supposons que toutes sont autorisées.
|
||||
videoad_start_delay
|
|
Source de la valeur de la demande d'enchère
OpenRTB Objet | Champs | AdX /Place de marché Enchère Annonces OutStream |
Exemples de valeurs | Qui la détermine ? /Où cette valeur correspond à à partir de ? |
---|---|---|---|---|
Objet | ||||
Vidéo | mimes | oui | ["application/javascript", "video/mp4"]", |
|
méconnaissance | non | Configuré par l'éditeur | ||
durée maximale | oui | Configuré par l'éditeur | ||
lecture : Hod |
oui | [6] | Éditeur habituel 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 | ||
la hauteur du joueur ; | 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 les annonces InStream => Éditeur décide d'autoriser ou non 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écurité | oui | 1 | Google valeur par défaut "true" : car le tag d'emplacement publicitaire est toujours sécurisé |