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.
La AWS Elemental MediaTailor solicitud al servidor de decisiones publicitarias (ADS) incluye información sobre la sesión de visualización actual, lo que ayuda al ADS a elegir los mejores anuncios para ofrecer en su respuesta. Al configurar la plantilla ADS en su MediaTailor configuración, puede 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 MediaTailor espera del ADS.
-
Variables de dominio: variables dinámicas que se pueden usar para los dominios URL, como la parte my-ads-server.com de la 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 proporcionados MediaTailor por cada sesión, 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 ayudan al ADS a determinar qué anuncios MediaTailor deben 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 las variables dinámicas en MediaTailor las solicitudes al ADS.
-
Para obtener información sobre los formatos admitidos para los parámetros de consulta, consulte El parámetro de consulta del manifiesto admite caracteres y limitaciones yLimitaciones de longitud de los parámetros de consulta ADS.
-
Para ver personalizaciones adicionales de la solicitud de ADS, consulteUso avanzado.
Para pasar información de la sesión y el reproductor a ADS
-
Trabaje con el ADS para determinar la información que necesita para poder responder a una consulta de anuncios desde AWS Elemental MediaTailor.
-
Crea una configuración MediaTailor que utilice una plantilla de URL de solicitud de ADS que cumpla los requisitos de ADS. En la URL, incluya parámetros estáticos y marcadores de posición para los parámetros dinámicos. Especifique la URL de la plantilla en el campo Ad decision server (Servidor de decisión de anuncios) de la configuración.
En el siguiente ejemplo, la URL de la plantilla,
correlation
, proporciona datos de la sesión ydeviceType
proporciona datos del reproductor: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 ambas llamadas de ejemplo,
userID
es para el ADS yauth_token
es para el origen:-
(Opcional) Solicita informes de seguimiento de anuncios en el servidor: añade un prefijo a los parámetros que quieres enviar MediaTailor al ADS.
ads
Suprima el prefijo para los parámetros que desee que MediaTailor envíe al servidor de origen:Los siguientes ejemplos muestran las solicitudes entrantes de HLS y DASH a. AWS Elemental MediaTailor MediaTailor usa el
deviceType
en su solicitud al ADS y elauth_token
en su solicitud al servidor de origen.Ejemplo de HLS:
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
Ejemplo de DASH:
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 dentro de un objeto.
adsParams
Ejemplo de HLS:
POST master.m3u8 { "adsParams": { "deviceType": "ipad" } }
Ejemplo de DASH:
POST manifest.mpd { "adsParams": { "deviceType": "ipad" } }
-
Cuando el reproductor inicia una sesión, AWS Elemental MediaTailor reemplaza las variables de la URL de solicitud de ADS de la plantilla por los datos de la sesión y los parámetros del reproductor. ads
Pasa los parámetros restantes del reproductor al servidor de origen.
ejemplo MediaTailor solicitudes con variables de anuncios
Los siguientes ejemplos muestran las llamadas al ADS y al servidor de origen desde AWS Elemental MediaTailor que se corresponden con los ejemplos de llamada de inicialización de sesión del reproductor anterior:
-
MediaTailor llama al 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.
-
Ejemplo de HLS:
https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
-
Ejemplo de DASH:
https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh
-
El parámetro de consulta del manifiesto admite caracteres y limitaciones
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)
Limitaciones de longitud de los parámetros de consulta ADS
Las siguientes limitaciones de longitud se aplican a los parámetros de consulta que se utilizan en las solicitudes al ADS:
-
Nombre del parámetro ADS: 10000 caracteres
-
Valor del parámetro ADS: 25000 caracteres
-
URL de ADS: 25000 caracteres
Uso avanzado
Puede personalizar la solicitud de ADS de muchas formas con datos del reproductor y de la sesión. El único requisito es incluir el nombre de host de ADS.
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.