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.
Uso de variables de anuncios dinámicos en MediaTailor
La AWS Elemental MediaTailor solicitud al servidor de decisiones publicitarias (ADS) incluye información sobre la sesión de visualización actual, lo que le ayuda a ADS elegir los mejores anuncios para su respuesta. Cuando configuras la ADS plantilla en tu MediaTailor configuración, puedes incluir variables dinámicas, también conocidas como macros. Las variables dinámicas son cadenas reemplazables.
Las variables dinámicas pueden adoptar las siguientes formas:
-
Valores estáticos: valores que no cambian de una sesión a la siguiente. Por ejemplo, el tipo de respuesta que se MediaTailor espera deADS.
-
Variables de dominio: variables dinámicas que se pueden usar para URL dominios, como la parte my-ads-server.com del URL http://my-ads-server.com. Para obtener más información, consulte Uso de variables de dominio.
-
Datos de sesión: valores dinámicos que proporciona cada sesión, MediaTailor por ejemplo, el ID de sesión. Para obtener más información, consulte Uso de variables de sesión.
-
Datos del jugador: valores dinámicos que proporciona el jugador para cada sesión. Estos describen al espectador del contenido y le ayudan ADS a determinar qué anuncios MediaTailor deberían incluirse en la transmisión. Para obtener más información, consulte Uso de variables de reproductor.
Pasar los parámetros al ADS
En los siguientes pasos se describe cómo configurar variables dinámicas en MediaTailor las solicitudes alADS.
-
Para obtener información sobre el formato compatible con los parámetros de consulta, consulte Caracteres y limitaciones compatibles con el parámetro de consulta del manifiesto yADSlimitaciones de longitud de los parámetros de consulta.
-
Para ver personalizaciones adicionales de la ADS solicitud, consulteUso avanzado.
Para pasar la información de la sesión y del jugador al ADS
-
Trabaja con él ADS para determinar la información que necesita para que pueda responder a una consulta publicitaria desde AWS Elemental MediaTailor.
-
Crea una configuración MediaTailor que utilice una ADS solicitud de plantilla URL que cumpla los ADS requisitos. En elURL, incluya parámetros estáticos e incluya marcadores de posición para los parámetros dinámicos. Introduzca su plantilla URL en el campo del servidor de decisiones publicitarias de la configuración.
En el siguiente ejemploURL, la plantilla
correlation
proporciona los datos de la sesión ydeviceType
los datos del jugador:https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
-
En el reproductor, configure la solicitud de inicio de sesión para que AWS Elemental MediaTailor proporcione los parámetros para los datos del reproductor. Incluya los parámetros en la solicitud de inicio de sesión y omítalos en las solicitudes de sesión posteriores.
El tipo de llamada que realiza el jugador para inicializar la sesión determina si el jugador (cliente) o MediaTailor (servidor) proporciona informes de seguimiento de anuncios para la sesión. Para obtener información sobre estas dos opciones, consulte Datos de informes y seguimiento .
Realice uno de los siguientes tipos de llamadas, en función de si desea realizar informes de seguimiento de anuncios en el servidor o en el cliente. En los dos ejemplos,
userID
las llamadas están destinadas al origen ADS yauth_token
están destinadas al origen:-
(Opcional) Solicita informes de seguimiento de anuncios en el servidor: añade un prefijo a los parámetros que quieres enviar MediaTailor al servidor. ADS
ads
Suprima el prefijo para los parámetros que desee que MediaTailor envíe al servidor de origen:En los siguientes ejemplos se muestran las solicitudes entrantes para y para. HLS DASH AWS Elemental MediaTailor MediaTailor usa el
deviceType
en su solicitud al ADS y elauth_token
en su solicitud al servidor de origen.HLSejemplo:
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
DASHejemplo:
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
-
(Opcional) Solicita informes de seguimiento de anuncios por parte del cliente: proporciona parámetros para el ADS interior de un objeto.
adsParams
HLSejemplo:
POST master.m3u8 { "adsParams": { "deviceType": "ipad" } }
DASHejemplo:
POST manifest.mpd { "adsParams": { "deviceType": "ipad" } }
-
Cuando el jugador inicia una sesión, AWS Elemental MediaTailor reemplaza las variables de la ADS solicitud de plantilla por URL los datos de la sesión y los ads
parámetros del jugador. Pasa los parámetros restantes del reproductor al servidor de origen.
ejemplo MediaTailor solicitudes con variables publicitarias
En los siguientes ejemplos, se muestran las llamadas al servidor de origen ADS y desde el cual AWS Elemental MediaTailor se corresponden con los ejemplos de llamadas de inicialización de sesión del jugador anterior:
-
MediaTailor llama ADS con los datos de la sesión y el tipo de dispositivo del jugador:
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
-
MediaTailor llama al servidor de origen con el token de autorización del jugador.
-
HLSejemplo:
https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
-
DASHejemplo:
https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh
-
Caracteres y limitaciones compatibles con el parámetro de consulta del manifiesto
Puedes usar los siguientes caracteres en los parámetros de consulta que se usan en las solicitudes de manifiesto:
-
Alfanuméricos (A-Z, a-z, 0-9)
-
Períodos (.)
-
Guiones (-)
-
Guiones bajos (_)
-
Barras invertidas (\)
Limitaciones de longitud
La longitud total de todos los parámetros de consulta del manifiesto (la clave y el valor combinados) no debe superar los 2000 caracteres.
Caracteres no admitidos
No puedes usar los siguientes caracteres en los parámetros de consulta del manifiesto: :
?
&
=
%
/
(barra inclinada)
ADSlimitaciones de longitud de los parámetros de consulta
Las siguientes limitaciones de longitud se aplican a los parámetros de consulta que se utilizan en las solicitudes aADS:
-
ADSnombre del parámetro: 10000 caracteres
-
ADSvalor del parámetro: 25000 caracteres
-
ADSURL: 25000 caracteres
Uso avanzado
Puedes personalizar la ADS solicitud de muchas formas con los datos del jugador y de la sesión. El único requisito es incluir el nombre del ADS anfitrión.
En los siguientes ejemplos se muestran algunas de las maneras en que puede personalizar su solicitud:
-
Concatenar los parámetros del reproductor y los parámetros de la sesión para crear nuevos parámetros. Ejemplo:
https://my.ads.com?key1=[player_params.value1][session.id]
-
Usar un parámetro de reproductor como parte de un elemento de ruta. Ejemplo:
https://my.ads.com/[player_params.path]?key=value
-
Usar parámetros del reproductor para pasar los elementos de ruta y las propias clave, en lugar de solo valores. Ejemplo:
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
Para obtener más información sobre el uso de variables dinámicas de dominio, sesión y reproductor, seleccione el tema correspondiente.