Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Construcción y creación de plantillas de ofertas

En esta página, se explica cómo crear MediaTailor una solicitud de oferta de OpenRTB a partir de tu plantilla, cómo funciona la interpolación de variables y qué valores se establecen automáticamente. MediaTailor

Campos de configuración

Al activar la optimización del rendimiento en una configuración de reproducción, se proporcionan cuatro campos:

Cómo se construye la solicitud de oferta

Cuando a una pausa publicitaria le queda tiempo sin cubrir, elabora MediaTailor la solicitud de oferta siguiendo estos pasos:

Plantilla predeterminada de la consola

Al activar la optimización del rendimiento en la MediaTailor consola, se proporciona la siguiente plantilla precumplimentada como punto de partida. Debe personalizar los valores de su aplicación:

{
  "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 explicación:

Interpolación de plantillas (creación de plantillas en forma de bigote)

La plantilla ORTB utiliza la sintaxis de plantillas de Mustache para la sustitución dinámica de valores. Los marcadores de posición utilizan corchetes dobles. {{ }}

Variables de plantilla disponibles

La plantilla de ORTB puede usar las mismas variables dinámicas disponibles en las plantillas de URL de ADS. Entre ellas se incluyen las variables de sesión (por ejemplo,{{session.user_agent}},{{session.client_ip}}), los parámetros del reproductor ({{player_params.*}}), los metadatos de los activos ({{asset.*}}), el contexto de avail ({{avail.*}}) y los datos de señal SCTE (). {{scte.*}}

Para obtener la lista completa de las variables disponibles y sus descripciones, consulte. MediaTailor variables de anuncios dinámicos para solicitudes de ADS Para saber cómo MediaTailor URL-decodes valoran los parámetros del jugador antes de sustituirlos en la plantilla, consulte Comportamiento de codificación y decodificación más adelante en esta página.

Las variables que se utilizan con más frecuencia en las plantillas de ORTB son:

¿Cómo pasar los parámetros del jugador

Hay dos maneras de transferir los parámetros del jugador durante la inicialización de la sesión.

Método 1: solicitud POST con cuerpo JSON (recomendado)

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

Se prefiere este método porque evita URL-encoding problemas con valores complejos, como las cadenas de agentes de usuario.

Método 2: parámetros de consulta de URL

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

Con este método, los valores deben ser URL-encoded. MediaTailor URL-decodes ellos antes de la interpolación.

Comportamiento de codificación y decodificación

MediaTailor realiza un nivel de decodificación de URL en los valores de los parámetros del reproductor antes de interpolarlos en la plantilla. Esto se aplica independientemente de cómo se transfieran los parámetros (parámetros de consulta URL o del cuerpo del POST).

Ejemplos de valores decodificados:

Puntos clave:

¿Qué ocurre cuando falta una variable

Si el reproductor no envía un parámetro al que se hace referencia en tu plantilla (por ejemplo, {{player_params.app_name}} pero no app_name en los parámetros del reproductor), el marcador de posición se convierte en una cadena vacía. ""

Impacto: si la cadena vacía está en un campo obligatorio (por ejemploapp.bundle), la solicitud de oferta no se realiza correctamente. BidRequestConfigurationError Si está en un campo opcional, APS recibe un valor vacío que puede provocar una respuesta sin oferta (HTTP 204).

¿Qué se MediaTailor establece automáticamente

Los siguientes campos siempre se configuran MediaTailor con valores de la configuración de la consola y del contexto disponible actual. Si los incluye en la plantilla, sus valores se anulan:

Siguientes pasos