Requisitos previos Paso 1: Acceso MediaTailor Paso 2: Prepara una transmisión Paso 3: Configurar los parámetros de ADS solicitud URL y consulta Paso 4: Crear una configuración Paso 5: Probar la configuración Paso 6: Envía la solicitud de reproducción a MediaTailor (Opcional) paso 7: Supervisar la actividad Paso 8: Eliminación

Cómo empezar con la inserción MediaTailor de anuncios

Para usarlo AWS Elemental MediaTailor, necesitas un Cuenta de AWS y permisos para acceder a las MediaTailor configuraciones, verlas y editarlas. Para obtener información sobre cómo hacerlo, consulte Con AWS Elemental MediaTailor figuración.

En este tutorial de introducción se muestra cómo realizar las siguientes tareas:

Prepare sus HLS transmisiones DASH de contenido
Configura una plantilla de servidor de decisiones publicitarias (ADS) URL
Cree una MediaTailor configuración que contenga un punto final de reproducción
Utilice el reproductor o la red de entrega de contenido (CDN) para realizar una solicitud de reproducción a MediaTailor

Cuando termines, podrás enviar una solicitud de reproducción MediaTailor para incluir contenido publicitario personalizado en tu transmisión.

Temas

Requisitos previos
Paso 1: Accede AWS Elemental MediaTailor
Paso 2: Prepara una transmisión
Paso 3: Configurar los parámetros de ADS solicitud URL y consulta
Paso 4: Crear una configuración
Paso 5: Probar la configuración
Paso 6: envíe la solicitud de reproducción a AWS Elemental MediaTailor
Paso 7 (opcional): Supervise la actividad AWS Elemental MediaTailor
Paso 8: Eliminación

Requisitos previos

Antes de comenzar, asegúrese de que ha realizado los pasos que se detallan en Con AWS Elemental MediaTailor figuración.

Paso 1: Accede AWS Elemental MediaTailor

Con sus IAM credenciales, inicie sesión en la MediaTailor consola enhttps://console.aws.amazon.com/mediatailor/home.

Paso 2: Prepara una transmisión

Configure su servidor de origen para que produzca manifiestos para HLS o DASH que sean compatibles con AWS Elemental MediaTailor.

Prepara una HLS transmisión

HLSlos manifiestos deben cumplir los siguientes requisitos:

Los manifiestos deben estar disponibles en la Internet pública.
Los manifiestos deben ser en directo o en vídeo a la carta (VOD).
Los manifiestos deben tener un valor de EXT-X-VERSION de 3 o superior.
Para el contenido en directo, los manifiestos deben contener marcadores para designar los espacios publicitarios. Esto es opcional para el VOD contenido, que puede utilizar VMAP compensaciones de tiempo en su lugar.

El archivo de manifiesto debe tener los espacios publicitarios definidos con uno de los siguientes marcadores:
- # EXT -X- CUE -OUT/# EXT -X- CUE -IN (más común) con duraciones como las que se muestran en el siguiente ejemplo.
```
#EXT-X-CUE-OUT:60.00
#EXT-X-CUE-IN
```
- # EXT -X- DATERANGE (menos común) con duraciones como las que se muestran en el siguiente ejemplo.
```
#EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF
#EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF
```
  Todos los campos que se muestran para #EXT-X-DATERANGE son obligatorios.
La forma en que se configuran los marcadores de anuncios en el manifiesto influye en si los anuncios se insertan en una secuencia o reemplazan otros fragmentos de la secuencia. Para obtener más información, consulte Entender MediaTailor el comportamiento de inserción de anuncios.
HLSLos manifiestos maestros deben seguir la HLS especificación documentada en la transmisión en HTTP directo: etiquetas maestras de las listas de reproducción. En concreto, #EXT-X-STREAM-INF deben incluir los campos RESOLUTION, BANDWIDTH y CODEC.

Una vez configurada la transmisión, anote el URL prefijo de origen del contenido del manifiesto maestro. Lo necesitará para crear la configuración en AWS Elemental MediaTailor, más adelante en este tutorial.

Prepara una transmisión DASH

DASHlos manifiestos deben cumplir los siguientes requisitos:

Los manifiestos deben estar disponibles en la Internet pública.
Los manifiestos deben ser en directo o en vídeo a la carta (VOD).
Los manifiestos deben marcar los eventos como espacios publicitarios que utilizan marcadores de inserción de división o marcadores de señal de tiempo. Puede proporcionar los marcadores de anuncios en formato transparente XML o en formato binario codificado en base64. Para insertar empalmes, el out-of-network indicador debe estar activado. En el caso de los marcadores de señal horaria, el identificador del tipo de segmentación, ubicado dentro de la segmentaciónUPID, debe ser un valor de corte reconocido por. AWS Elemental MediaTailor El espacio publicitario comienza cuando empieza el evento y dura mientras dura el evento, si se especifica una duración, o hasta que se inicie el siguiente evento.

El siguiente ejemplo muestra un evento designado como un espacio publicitario con marcadores de inserción de división. La duración de este espacio publicitario es igual a la duración del evento.
```
  <Period start="PT444806.040S" id="123586" duration="PT15.000S">
    <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml">
      <Event duration="1350000">
        <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095">
          <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1">
            <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program>
            <scte35:BreakDuration autoReturn="true" duration="1350000"/>
          </scte35:SpliceInsert>
        </scte35:SpliceInfoSection>
      </Event>
    </EventStream>
    <AdaptationSet mimeType="video/mp4"
        ...
    </AdaptationSet>
  </Period>
```

Los espacios publicitarios deben tener la misma configuración de AdaptationSet y Representation que las secuencias de contenido. AWS Elemental MediaTailor utiliza esta configuración para transcodificar los anuncios para que coincidan con la secuencia de contenido, para un intercambio fluido entre los dos.

Después de configurar la transmisión, anota el URL prefijo de origen del contenido del manifiesto. DASH Lo necesitarás para crear la configuración en AWS Elemental MediaTailor, más adelante en este tutorial.

Paso 3: Configurar los parámetros de ADS solicitud URL y consulta

Para determinar los parámetros de consulta que ADS requieren, genera una etiqueta URL de anuncio a partir delADS. URLActúa como plantilla para las solicitudes al ADS y consta de lo siguiente:

Valores estáticos
Valores generados por AWS Elemental MediaTailor (indicados por session los parámetros de la avail consulta)
Valores generados por los reproductores, obtenidos de la aplicación cliente (identificados por los parámetros de la consulta player_params.)

ejemplo Agregue una etiqueta URL desde un ADS


https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Donde:

output y content_id son valores estáticos
playerSession= [session.id] es un valor dinámico proporcionado por. AWS Elemental MediaTailor El valor de [session.id] cambia para cada sesión de jugador y se traduce en un valor diferente URL para la solicitud de cada sesión. VAST
cust_params son valores dinámicos proporcionados por el reproductor

La solicitud de manifiesto maestro del jugador debe proporcionar pares clave-valor que se correspondan con los parámetros de player_params. consulta de la solicitud. ADS URL Para obtener más información sobre cómo configurar pares de clave-valor en la solicitud dirigida a AWS Elemental MediaTailor, consulte Uso de variables de anuncios dinámicos en AWS Elemental MediaTailor.

Introduce la «plantilla» configurada URL al crear el ADS servidor/mapeo de origen en, in MediaTailor. Paso 4: Crear una configuración

Pruebas

Puede utilizar una VAST respuesta estática suya ADS para realizar pruebas. Lo ideal es que la VAST respuesta devuelva una copia con calidad intermedia que AWS Elemental MediaTailor se MP4 pueda transcodificar. Si la respuesta de ADS contiene varias variantes de reproducción, MediaTailor selecciona la de mayor calidad y resolución y la envía al MP4 transcodificador.

Paso 4: Crear una configuración

La AWS Elemental MediaTailor configuración contiene la información de mapeo del servidor de origen y. ADS

Para crear una configuración (consola)

Abra la MediaTailor consola en https://console.aws.amazon.com/mediatailor/.
En la página Configurations (Configuraciones), seleccione Create configuration (Crear configuración).
En la sección Configuration (Configuración) situada en la parte inferior de la página, en Configuration name (Nombre de la configuración), escriba un nombre único que describa la configuración. El nombre es el identificador principal de la configuración. La longitud máxima permitida es de 512 caracteres.
En el caso de la fuente de contenido de vídeo, introduzca el URL prefijo del manifiesto HLS maestro o del DASH manifiesto de esta transmisión, menos el ID del activo. Por ejemplo, si el manifiesto maestro URL eshttp://origin-server.com/a/master.m3u8, debe introducirhttp://origin-server.com/a/. También puede escribir un prefijo más corto como http://origin-server.com, pero debe incluir la /a/ en el ID de recurso en la solicitud de contenido del reproductor. La longitud máxima es de 512 caracteres.

nota
Si su origen de contenido HTTPS lo utiliza, su certificado debe ser de una entidad emisora de certificados conocida. (No puede ser un certificado autofirmado). De lo contrario AWS Elemental MediaTailor , no podrá conectarse al origen del contenido y no podrá publicar los manifiestos en respuesta a las solicitudes de los jugadores.
En Ad Decision Server, introduce el URL para tuADS. Se trata de la variable URL con variables, tal como se describe enPaso 3: Configurar los parámetros de ADS solicitud URL y consulta, o de la estática VAST URL que está utilizando con fines de prueba. La longitud máxima es de 25 000 caracteres.

nota
Si lo ADS usaHTTPS, su certificado debe provenir de una autoridad de certificación conocida. (No puede ser un certificado autofirmado). Lo mismo ocurre con el anuncio intermedio URLs devuelto por el. ADS De lo contrario MediaTailor , no podrá recuperar ni unir los anuncios del origen del contenido a los manifiestos.
(Opcional si es necesarioDASH) En cuanto a la ubicación, elige DISABLEDsi has establecido reglas de CDN enrutamiento para acceder a los MediaTailor manifiestos y si utilizas los informes del lado del cliente o si tus jugadores admiten los redireccionamientos permanentes. HTTP

Para obtener más información sobre la característica Location (Ubicación), consulte DASHcaracterística de ubicación.
(Opcional) Si tu servidor de origen produce DASH manifiestos de un solo período, elige el tipo de origen del manifiesto DASH mpd y, a continuación, selecciona _. SINGLE PERIOD De forma predeterminada, MediaTailor gestiona los DASH manifiestos como manifiestos de varios períodos. Para obtener más información, consulte Integrar una MPEG DASH fuente.
Seleccione Crear configuración.

AWS Elemental MediaTailor muestra la nueva configuración en la página de configuraciones.

Paso 5: Probar la configuración

Después de guardar la configuración, pruebe la transmisión con URL el formato adecuado para su protocolo de transmisión:

Ejemplo: HLS


playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8

Ejemplo: DASH


playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd

Donde:

playback-endpoint es el punto de enlace de reproducción único que generó AWS Elemental MediaTailor cuando creó la configuración.

Ejemplo
```
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
```
hashed-account-ides tu Cuenta de AWS carné de identidad.

Ejemplo
```
AKIAIOSFODNN7EXAMPLE
```
origin-id es el nombre que asignó al crear la configuración.

Ejemplo
```
myOrigin
```
master.m3u8 o manifest.mpd es el nombre del manifiesto de la secuencia de prueba y su extensión de archivo. Defina esto de tal forma que pueda obtener un manifiesto totalmente identificado cuando lo añada al origen de contenido de vídeo que configuró en Paso 4: Crear una configuración.

Utilizando los valores de los ejemplos anteriores, los valores completos URLs son los siguientes.

Ejemplo: HLS


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8

Ejemplo: DASH


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd

Puede probar la secuencia con uno de los siguientes métodos.

Como se muestra en el ejemplo anterior, introduzca el URL en un reproductor independiente.

Pruebe la secuencia en su propio entorno de reproductor.

Paso 6: envíe la solicitud de reproducción a AWS Elemental MediaTailor

Configure el reproductor descendente o CDN envíe las solicitudes de reproducción al punto final de reproducción de la configuración proporcionado desde AWS Elemental MediaTailorél. Todas las variables dinámicas definidas por el reproductor que hayas utilizado en la ADS solicitud URL Paso 3: Configurar los parámetros de ADS solicitud URL y consulta deben estar definidas en la solicitud de manifiesto del reproductor.

ejemplo

Suponga que su plantilla ADS URL es la siguiente.


https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Luego, defina [player_params.cust_params] en la solicitud del jugador anteponiendo el par clave-valor con. ads. AWS Elemental MediaTailor pasa los parámetros que no estén precedidos por él ads. al servidor de origen en lugar de al. ADS

La solicitud del jugador URL es una variación de lo siguiente HLS y de algunos DASH ejemplos.


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo

Cuando AWS Elemental MediaTailor recibe la solicitud del jugador, define las variables del jugador en función de la información de la solicitud. La ADS solicitud resultante URL es una variante de esta.


https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=<filled_in_session_id>&cust_params=viewerinfo

Para obtener más información sobre la configuración de pares clave-valor para pasarlos aADS, consulte. Uso de variables de anuncios dinámicos en AWS Elemental MediaTailor

Paso 7 (opcional): Supervise la actividad AWS Elemental MediaTailor

Usa Amazon CloudWatch y Amazon CloudWatch Logs para realizar un seguimiento de la AWS Elemental MediaTailor actividad, como el recuento de solicitudes, errores y ofertas de anuncios llenadas.

Si es la primera vez que utilizas CloudWatch with AWS Elemental MediaTailor, crea un rol AWS Identity and Access Management (IAM) para permitir la comunicación entre los servicios.

Para permitir el AWS Elemental MediaTailor acceso a CloudWatch (consola)

Abra la IAM consola en https://console.aws.amazon.com/iam/.
En el panel de navegación de la IAM consola, elija Roles y, a continuación, elija Crear rol.
Seleccione Otro tipo de Cuenta de AWS rol.
En el campo ID de cuenta, introduce tu Cuenta de AWS ID.
Seleccione Require external ID (Requerir ID externo) y escriba midas. Esta opción agrega automáticamente una condición a la política de confianza que permite al servicio asumir el rol únicamente si la solicitud incluye el sts:ExternalID correcto.
Elija Siguiente: permisos.
Añada una política de permisos que especifique qué acciones puede realizar este rol. Seleccione una de las siguientes opciones y después elija Next: Review (Siguiente: Revisar):
- CloudWatchLogsFullAccesspara proporcionar acceso completo a Amazon CloudWatch Logs
- CloudWatchFullAccesspara proporcionar acceso completo a Amazon CloudWatch
En Role name (Nombre de rol), escriba MediaTailorLogger y luego elija Create role (Crear rol).
En la página Roles, seleccione el rol que acaba de crear.

Edite la relación de confianza para actualizar la entidad principal:

En la página Summary (Resumen) del rol, elija la pestaña Trust relationship (Relación de confianza).
Elija Editar relación de confianza.

En el documento de la política, cambie la entidad principal por el servicio AWS Elemental MediaTailor . Debería tener un aspecto similar al siguiente.


"Principal": {
   "Service": "mediatailor.amazonaws.com"
},

La política completa debe ser similar a la siguiente.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "mediatailor.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "Midas"
        }
      }
    }
  ]
}

Elija Actualizar política de confianza.

Paso 8: Eliminación

Para evitar cargos no deseados, elimine todas las configuraciones innecesarias.

Para eliminar una configuración (consola)

En la página de AWS Elemental MediaTailor configuraciones, realice una de las siguientes acciones:
- Elija el nombre (Configuration name) de la configuración que desea eliminar.
- En la columna Configuration name (Nombre de la configuración), elija el botón de opción y después elija Delete (Eliminar).
En el cuadro de confirmación Delete configuration (Eliminar configuración), escriba Delete y, a continuación, elija de nuevo Delete (Eliminar).

AWS Elemental MediaTailor elimina la configuración.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Empezando con MediaTailor

Cómo empezar con el ensamblaje MediaTailor de canales