Annunci video OpenRTB

Questa guida descrive i requisiti di integrazione per l'acquisto RTB mediante il protocollo OpenRTB. Questa guida deve essere utilizzata in combinazione con la guida all'integrazione OpenRTB in cui i campi qui illustrati sono descritti in dettaglio.

Se acquisti su app per iOS con snippet HTML che includono i tag <video>, devi includere l'attributo playsinline nel tag video. In caso contrario, gli utenti riscontreranno un'esperienza molto scadente, a causa della quale gli annunci video che dovrebbero essere riprodotti all'interno della creatività sembrano apparire a schermo intero. Gli annunci che non rispettano questa norma verranno bloccati.

Requisiti degli acquirenti

I nuovi acquirenti RTB dovrebbero sviluppare i propri offerenti utilizzando il buffer di protocollo più recente e le informazioni descritte nelle sezioni seguenti. Per scaricare il protocollo, consulta la pagina Dati di riferimento. Per informazioni sullo sviluppo di un offerente, consulta Elaborare la richiesta e Creare la risposta.

Macro supportate

Le macro riportate di seguito sono supportate nelle creatività video in-stream:

• %%CACHEBUSTER%%
• %%WINNING_PRICE%%

Tieni presente che la sostituzione della macro è consentita nell'URL del video, ma non nel codice XML VAST effettivo.

Le macro clic (come CLICK_URL_ESC) non sono necessarie perché Authorized Buyers include i tracker dei clic in un wrapper VAST. Pertanto, le macro clic non sono supportate per gli annunci video in-stream. Per ulteriori informazioni sulle macro supportate, consulta la sezione Specificare le macro in Crea la risposta.

Dettagli oggetto video

Il protocollo OpenRTB utilizza un messaggio Video, definito nel file openrtb-proto.txt, per identificare le richieste video e fornire ulteriori informazioni sulla richiesta specifiche per il video.

Consulta l'elenco dei campi dei messaggi video nella guida all'integrazione OpenRTB per descrizioni ed esempi dettagliati.

Altri campi per le richieste di offerta video

Gli indicatori riportati di seguito non sono tutti univoci per le creatività video, ma sono parti fondamentali della richiesta di offerta.

Campi oggetto impressioni

Questo oggetto descrive un posizionamento dell'annuncio o un'impressione messi all'asta.

banner	Oggetto banner; richiesto se l'impressione viene offerta come opportunità di annuncio banner.
video	Indica il tipo di impressione offerta, in questo caso video. Tieni presente che i video in-banner sono consentiti se l'oggetto imp include entrambi gli oggetti banner e video.
tagid	Identificatore di uno specifico posizionamento o tag annuncio utilizzato per avviare l'asta. Questo può essere utile per il debug di eventuali problemi o per l'ottimizzazione da parte dell'acquirente.
bidfloor	Offerta minima per questa impressione espressa in CPM.
bidfloorcur	Una singola valuta, ottenuta da billing_id. inclusi

Per ulteriori dettagli, consulta la sezione Oggetto Imp nella guida di OpenRTB.

Campi dell'oggetto dispositivo

I campi nell'oggetto Device forniscono informazioni sul dispositivo target.

ua	Stringa dello user agent del browser.
ip	L'indirizzo IPv4 più vicino al dispositivo.
geo	La località del dispositivo corrisponde alla posizione attuale dell'utente definita da un oggetto Geo.
devicetype	Il tipo generico di dispositivo.
ifa	ID sanzionato per l'uso da parte dell'inserzionista in modo chiaro (ad es. non sottoposto ad hashing). ifa è supportato per i dispositivi TV connessi a internet come Roku, Apple TV, Fire TV, Xbox.

Per ulteriori dettagli, consulta la sezione Oggetto nella guida di OpenRTB.

Oggetto sito

I campi nell'oggetto Site forniscono informazioni sul sito con contenuti con pubblicità.

page	URL della pagina in cui verrà mostrata l'impressione.
publisher	Dettagli sull'oggetto Publisher del sito.
content	Dettagli sul Content all'interno del sito.

Per ulteriori dettagli, consulta la sezione sull'oggetto Sito nella guida di OpenRTB.

Oggetto utente

I campi nell'oggetto User forniscono informazioni sul sito con contenuti con pubblicità.

id	ID specifico della piattaforma di scambio pubblicitario per l'utente. È consigliato almeno un valore tra id o buyerid.
data	Dettagli sull'oggetto Publisher del sito.

Per ulteriori dettagli, consulta la sezione Oggetto utente nella guida di OpenRTB.

Campi dell'inventario per le richieste di offerta

La richiesta di offerta video contiene anche informazioni sui tipi di contenuti ed eventuali annunci companion specificati.

mimes

Lista consentita dei tipi MIME dei contenuti supportati.

companionad

Array di oggetti Banner se sono disponibili annunci companion.

Campi di risposta all'offerta

I campi chiave di una risposta all'offerta video includono i seguenti:

id

ID della richiesta di offerta a cui si tratta di una risposta.

seatbid

Array di oggetti Seatbid; uno o più oggetti sono obbligatori se è necessario fare un'offerta.

seat

Un oggetto Seatbid; ID della sede dell'acquirente (ad esempio inserzionista, agenzia) per conto del quale viene fatta l'offerta.

bid

Array di uno o più oggetti Bid, ciascuno correlato a un'impressione.

Pretargeting

Per ricevere l'inventario video, gli acquirenti OpenRTB devono avere una configurazione di pretargeting che includa l'inventario video.

Esempio di richiesta e risposta all'offerta

Richiesta di offerta

Procedura

{
  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"
  }
}

Risposta all'offerta

Procedura

{
  "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"
}

Glossario

Consulta il video glossario di Authorized Buyers.