Annonces vidéo OpenRTB

Ce guide décrit les exigences d'intégration pour les achats RTB à l'aide du protocole OpenRTB. Ce guide doit être utilisé conjointement avec le guide d'intégration d'OpenRTB pour lequel les champs décrits ici sont décrits en détail.

Si vous effectuez un achat sur des applications iOS avec des extraits de code HTML incluant des balises <video>, vous devez inclure l'attribut playsinline dans la balise vidéo. Sinon, les internautes bénéficient d'une très mauvaise expérience lorsque les annonces vidéo censées être diffusées dans la création semblent s'afficher en plein écran. Les annonces qui ne respectent pas cette règle seront bloquées.

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, consultez la page Données de référence. 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%%

Notez que le remplacement des macros est autorisé dans l'URL de la vidéo, mais pas dans le fichier XML VAST lui-même.

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'objet vidéo

Le protocole OpenRTB utilise un message Video, défini dans le fichier openrtb-proto.txt pour identifier les requêtes vidéo et fournir des informations supplémentaires sur ces requêtes.

Consultez la liste des champs des messages vidéo dans le guide d'intégration d'OpenRTB pour obtenir des descriptions détaillées et des exemples.

Autres champs de demande d'enchère pour une annonce vidéo

Les signaux ci-dessous ne sont pas tous propres aux créations vidéo, mais constituent des éléments clés de la demande d'enchère.

Champs de l'objet Imp.

Cet objet décrit une impression ou un emplacement d'annonce mis aux enchères.

banner	Un objet "Bannière" ; obligatoire si l'impression est proposée en tant qu'opportunité de bannière.
video	Indique le type d'impression proposé (ici, la vidéo). Notez que les vidéos InBanner sont autorisées si l'objet imp inclut à la fois des objets banner et video.
tagid	Identifiant de l'emplacement d'annonce ou du tag d'emplacement publicitaire spécifique utilisé pour lancer l'enchère. Cela peut être utile pour résoudre les éventuels problèmes ou pour optimiser le compte par l'acheteur.
bidfloor	Enchère minimale pour cette impression, exprimée en CPM.
bidfloorcur	Une seule devise, obtenue à partir des billing_id. inclus

Pour en savoir plus, consultez la section Objet Imp dans le guide OpenRTB.

Champs d'objets de l'appareil

Les champs de l'objet Device fournissent des informations sur l'appareil ciblé.

ua	Chaîne user-agent du navigateur.
ip	Adresse IPv4 la plus proche de l'appareil.
geo	Position de l'appareil supposée être la position actuelle de l'utilisateur, définie par un objet Geo.
devicetype	Type général d'appareil.
ifa	ID sanctionné pour une utilisation en clair par l'annonceur (non hachée, par exemple). ifa est compatible avec les appareils pour la télévision connectée comme Roku, Apple TV, Fire TV et Xbox.

Pour en savoir plus, consultez la section Objet appareil du guide OpenRTB.

Objet Site

Les champs de l'objet Site fournissent des informations sur le site dont le contenu est financé par la publicité.

page	URL de la page sur laquelle l'impression sera diffusée.
publisher	Informations sur l'objet Publisher du site.
content	Informations sur le Content dans le site.

Pour en savoir plus, consultez la section sur les objets Site du guide OpenRTB.

Objet utilisateur

Les champs de l'objet User fournissent des informations sur le site dont le contenu est financé par la publicité.

id	ID d'utilisateur spécifique à la place de marché. Nous vous recommandons d'utiliser au moins id ou buyerid.
data	Informations sur l'objet Publisher du site.

Pour en savoir plus, consultez la section Objet utilisateur du guide OpenRTB.

Champs d'inventaire de demande d'enchères

La demande d'enchère vidéo contient également des informations sur les types de contenus et, le cas échéant, les annonces associées spécifiées.

mimes

Liste d'autorisation des types MIME de contenu acceptés.

companionad

Tableau d'objets Banner si des annonces associées sont disponibles.

Champs de réponse aux enchères

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

id

ID de la demande d'enchère à laquelle cette réponse correspond.

seatbid

Tableau d'objets Seatbid. Au moins un élément est requis pour définir une enchère.

seat

Un objet Seatbid ; ID du siège de l'acheteur (par exemple, l'annonceur ou l'agence) au nom duquel cette enchère est effectuée.

bid

Tableau d'un ou plusieurs objets Bid, chacun associé à une impression.

Préciblage

Pour recevoir un inventaire vidéo, les acheteurs OpenRTB doivent disposer d'une configuration de préciblage incluant l'inventaire vidéo.

Exemple de demande d'enchère et de réponse

Demande d'enchère

Démonstration

{
  id: "XIsz9QAHfAYKj3oDMQ3QOg",
  imp: [{
    id: "1",
    banner: {
      w: 300,
      h: 250,
      format:     [{
        w: 300,
        h: 250
      },{
        w: 250,
        h: 250
      }],
      battr:     [5]
    },
    video: {
      mimes:     [video/mp4],
      linearity: 1,
      protocols:     [2,3,5,6],
      w: 300,
      h: 250,
      skip: 1,
      battr:     [5],
      playbackmethod:     [6],
      plcmt: 3
    },
    displaymanager: "GOOGLE",
    tagid: "2111189154",
    bidfloor: 0.01,
    bidfloorcur: "USD",
    secure: 1,
    native: {
      request_native: {
        ver: "1.2",
        assets:       [{
          id: 1,
          required: 1,
          title: {
            len: 25
          }
        },{
          id: 2,
          data: {
            type: 2,
            len: 90
          }
        },{
          id: 3,
          data: {
            type: 12,
            len: 15
          }
        },{
          id: 4,
          data: {
            type: 1,
            len: 25
          }
        },{
          id: 5,
          img: {
            type: 3,
            wmin: 1200,
            hmin: 627
          }
        },{
          id: 6,
          img: {
            type: 2,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 7,
          img: {
            type: 1,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 8,
          data: {
            type: 3,
            len: 5
          }
        },{
          id: 9,
          video: {
            mimes:           [video/mp4]
          }
        }],
        eventtrackers:       [{
          event: 1,
          methods:         [1]
        }],
        adx_ext: {
          style_id: 188961,
          style_height: 250,
          style_width: 300
        }
      },
      ver: "1.2",
      battr:     [5]
    },
    metric:   [{
      type: "click_through_rate",
      value: 0.0006341254338622093,
      vendor: "EXCHANGE"
    },{
      type: "video_completion_rate",
      value: 0.017279919236898422,
      vendor: "EXCHANGE"
    },{
      type: "viewability",
      value: 0.7,
      vendor: "EXCHANGE"
    },{
      type: "session_depth",
      value: 1,
      vendor: "EXCHANGE"
    }],
    adx_ext: {
      billing_id:     [12345567890],
      publisher_settings_list_id:     [5509324247698256194,14109776396365339331],
      allowed_vendor_type:     [3,42,79,4463,4513,4538,4625],
      ampad: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED"
    }
  }],
  site: {
    page: "https:/example.com/school",
    publisher: {
      id: "pub-783270600012345",
      adx_ext: {
        country: "IN"
      }
    },
    content: {
      contentrating: "DV-G",
      language: "en"
    },
    mobile: 1,
    adx_ext: {
      amp: "DIALECT_HTML"
    }
  },
  device: {
    ua: "Mozilla/5.0 (iPad; CPU OS 12_1_4 like Mac OS X) FBOP/5;FBRV/0]",
    ip: "121.222.242.0",
    geo: {
      lat: -26.487831115722656,
      lon: 153.0424346923828,
      country: "AUS",
      region: "AU-QLD",
      zip: "4562",
      utcoffset: 600
    },
    make: "apple",
    model: "ipad",
    os: "iOS",
    osv: "12.1.1",
    w: 768,
    h: 1024,
    pxratio: 2,
    devicetype: 5
  },
  user: {
    id: "CAESEK6jGeddIeo_opp-WrY",
    buyeruid: "anFTbmRJMVF3VXy0",
    customdata: "anFTbmRJMVVXy0",
    data:   [{
      id: "DetectedVerticals",
      name: "DoubleClick",
      segment:     [{
        id: "1263",
        value: "0.5"
      },{
        id: "625",
        value: "0.1"
      }]
    }]
  },
  at: 2,
  tmax: 122,
  cur: [USD],
  bcat: [IAB7-39],
  adx_ext: {
    google_query_id: "ANy-zJFcyG8sUO0_hYbujPqNXbB3bPA"
  }
}

Réponse à l'enchère

Démonstration

{
  "id": "AB1abcDEfghijklMno2pqr",
  "seatbid": [
    {
      "seat": "Example Seat",
      "bid": [
        {
          "id": "12345678901234567890",
          "impid": "1",
          "price": 15,
          "adid": "AB1234-1234",
          "adm": "https://example.com/AdX/win?tag=AbcdEfGhIJ0kLMN2OPQ2RST3UVXyZAB2Cde114eF
          "cid": "12345678901",
          "crid": "1234",
          "adomain": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "cur": "USD",
  "bidid": "1234567890123456789"
}

Glossaire

Consultez le glossaire vidéo Authorized Buyers.