Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Costruzione e modellazione delle offerte

Questa pagina spiega come MediaTailor creare una richiesta di offerta OpenRTB dal tuo modello, come funziona l'interpolazione delle variabili e quali valori vengono impostati automaticamente. MediaTailor

Campi di configurazione

Quando abiliti l'ottimizzazione del rendimento su una configurazione di riproduzione, fornisci quattro campi:

Come viene costruita la richiesta di offerta

Quando un'interruzione pubblicitaria ha una durata residua non completata, MediaTailor costruisce la richiesta di offerta in questi passaggi:

Modello predefinito della console

Quando abiliti l'ottimizzazione del rendimento nella MediaTailor console, viene fornito il seguente modello precompilato come punto di partenza. Dovresti personalizzare i valori per la tua applicazione:

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field spiegazione:

Interpolazione dei modelli (Moustache templating)

Il modello ORTB utilizza la sintassi dei modelli Mustache per la sostituzione dinamica dei valori. I segnaposto {{ }} utilizzano doppie parentesi graffe.

Variabili di modello disponibili

Il modello ORTB può utilizzare le stesse variabili dinamiche disponibili nei modelli di URL ADS. Queste includono variabili di sessione (ad esempio,{{session.client_ip}}){{session.user_agent}}, parametri del giocatore ({{player_params.*}}), metadati delle risorse ({{asset.*}}), avail context () e dati del segnale SCTE ({{avail.*}}). {{scte.*}}

Per l'elenco completo delle variabili disponibili e le relative descrizioni, consulta. MediaTailor variabili pubblicitarie dinamiche per richieste ADS Per informazioni sui valori dei parametri del MediaTailor URL-decodes giocatore prima di sostituirli nel modello, consulta Comportamento di codifica e decodifica più avanti questa pagina.

Le variabili più comunemente usate nei template ORTB sono:

Come passare i parametri del giocatore

Ci sono due modi per passare i parametri del giocatore durante l'inizializzazione della sessione.

Metodo 1: richiesta POST con corpo JSON (consigliato)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

Questo metodo è preferito perché evita URL-encoding problemi con valori complessi come le stringhe dell'agente utente.

Metodo 2: parametri di interrogazione degli URL

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

Con questo metodo, i valori devono essere URL-encoded. MediaTailor URL-decodes prima dell'interpolazione.

Comportamento di codifica e decodifica

MediaTailor esegue un livello di decodifica degli URL sui valori dei parametri del giocatore prima di interpolarli nel modello. Ciò si applica indipendentemente da come vengono passati i parametri (parametri del corpo POST o dei parametri di interrogazione dell'URL).

Esempi di valori decodificati:

Punti chiave:

Cosa succede quando manca una variabile

Se il giocatore non invia un parametro a cui si fa riferimento nel modello (ad esempio, {{player_params.app_name}} ma non app_name nei parametri del player), il segnaposto si trasforma in una stringa vuota. ""

Impatto: se la stringa vuota si trova in un campo obbligatorio (ad esempioapp.bundle), la richiesta di offerta non va a buon fine. BidRequestConfigurationError Se si trova in un campo opzionale, APS riceve un valore vuoto che può causare una risposta di mancata offerta (HTTP 204).

Cosa viene MediaTailor impostato automaticamente

I seguenti campi vengono sempre impostati MediaTailor utilizzando i valori della configurazione della console e del contesto di disponibilità corrente. Se li includi nel modello, i tuoi valori vengono sovrascritti:

Fasi successive