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 Configuración AWS Elemental MediaTailor.

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

• Prepara tus transmisiones de contenido HLS o DASH

• Configura la URL de una plantilla de servidor de decisiones publicitarias (ADS)

• 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.

Requisitos previos

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

Paso 1: Accede AWS Elemental MediaTailor

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

Paso 2: Prepare una transmisión

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

Prepare una transmisión HLS

Los manifiestos de HLS deben cumplir los siguientes requisitos:

• Los manifiestos deben estar disponibles en la Internet pública.

• Los manifiestos debe ser vídeo en directo o 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 contenido VOD, que puede utilizar desfases horarios de VMAP 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 las duraciones 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 AWS Elemental MediaTailor el comportamiento de inserción de anuncios.

• Los manifiestos maestros del HLS deben seguir la especificación HLS documentada en la transmisión en directo HTTP: etiquetas maestras de las listas de reproducción. En concreto, #EXT-X-STREAM-INF deben incluir los campos RESOLUTION, BANDWIDTH y CODEC.

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

Prepara una transmisión DASH

Los manifiestos de DASH deben cumplir los siguientes requisitos:

• Los manifiestos deben estar disponibles en la Internet pública.

• Los manifiestos debe ser vídeo en directo o 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 XML vacío o datos binarios codificados en Base64. Para insertar un empalme, 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 del UPID de segmentación, 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.

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

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

Para determinar los parámetros de consulta que requiere el ADS, genere una URL de etiqueta de anuncio desde el ADS. Esta URL actúa como una plantilla para las solicitudes al ADS y se compone de lo siguiente:

• Valores estáticos

• Valores generados por AWS Elemental MediaTailor (indicados por session nuestros parámetros de avail consulta)

• Valores generados por los reproductores, obtenidos de la aplicación cliente (identificados por los parámetros de la consulta player_params.)

ejemplo URL de la etiqueta del anuncio 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 del reproductor y produce una URL diferente para la solicitud VAST de cada sesión.

• cust_params son valores dinámicos proporcionados por el reproductor

La solicitud del manifiesto maestro del reproductor debe proporcionar pares de clave-valor que se correspondan con los parámetros de consulta player_params. de la URL de solicitud de ADS. 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 MediaTailor.

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

Testeo

Puede utilizar una respuesta VAST estática desde su ADS para realizar pruebas. Lo ideal es que la respuesta VAST devuelva una copia con calidad intermedia que pueda transcodificarse MP4 . AWS Elemental MediaTailor Si la respuesta del 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 del ADS.

Para crear una configuración (consola)

1. Abra la MediaTailor consola en https://console.aws.amazon.com/mediatailor/.

2. En la página Configurations (Configuraciones), seleccione Create configuration (Crear configuración).

3. 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.

4. En Video content source (Origen de contenido de vídeo), escriba el prefijo de la URL del manifiesto maestro de HLS o del manifiesto de DASH para esta secuencia, sin incluir el ID de recurso. Por ejemplo, si la URL del manifiesto maestro fuera http://origin-server.com/a/master.m3u8, escribiría http://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 el origen de contenido usa HTTPS, su certificado debe proceder de una entidad de certificación 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.

5. En el caso del servidor de decisiones publicitarias, introduce la URL de tu ADS. Esta es la URL con las variables que se describen en Paso 3: Configurar la URL de la solicitud de ADS y los parámetros de consulta o la URL de VAST estática que se utiliza para la realización de pruebas. La longitud máxima es de 25 000 caracteres.

   nota

   Si su ADS usa HTTPS, su certificado debe proceder de una entidad 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 acomodar anuncios en los manifiestos desde el origen del contenido.

6. (Opcional si es necesario en el caso de DASH) En cuanto a la ubicación, selecciona DISABLED si tienes reglas de enrutamiento de CDN configuradas para acceder a los MediaTailor manifiestos y si utilizas los informes del lado del cliente o si tus reproductores admiten redireccionamientos HTTP fijos.

   Para obtener más información sobre la característica Location (Ubicación), consulte DASHcaracterística de ubicación.

7. (Opcional) Si el servidor de origen produce manifiestos de DASH de un solo período, elija DASH mpd manifest origin type (Tipo de manifiesto de origen de DASH) y, luego, SINGLE_PERIOD. De forma predeterminada, MediaTailor maneja los manifiestos de DASH como manifiestos de varios períodos. Para obtener más información, consulte Integrar una DASH fuente MPEG -.

8. 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 secuencia con una URL en el formato adecuado para su protocolo de streaming:

• 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://777788889999.mediatailor.us-east-1.amazonaws.com

• hashed-account-ides tu Cuenta de AWS ID.

  Ejemplo

  777788889999

• 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://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8

• Ejemplo: DASH

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

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

• Tal como se muestra en el ejemplo anterior, escriba la URL en un reproductor independiente.

• Pruebe la secuencia en su propio entorno de reproductor.

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

Configure el reproductor terminal o la CDN para enviar las solicitudes de reproducción al punto de enlace de reproducción de la configuración proporcionado desde AWS Elemental MediaTailor. Todas las variables dinámicas definidas por el reproductor que ha usado en la URL de la solicitud del ADS en Paso 3: Configurar la URL de la solicitud de ADS y los parámetros de consulta deben estar definidas en la solicitud del manifiesto del reproductor.

ejemplo

Considere que la URL del ADS de la plantilla es la siguiente.

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

A continuación, defina [player_params.cust_params] en la solicitud del reproductor anteponiendo el par clave-valor con. ads. AWS Elemental MediaTailor pasa los parámetros que no van precedidos ads. al servidor de origen en lugar de al ADS.

La URL de la solicitud del reproductor es alguna variante de los siguientes ejemplos de HLS y DASH.

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

https://777788889999.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 URL de la solicitud del ADS resultante es alguna variante de la siguiente.

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 cómo configurar pares de clave-valor para pasarlos al ADS, consulte Uso de variables de anuncios dinámicos en MediaTailor.

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

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 lo utilizas CloudWatch con AWS Elemental MediaTailor, crea un rol AWS Identity and Access Management (de IAM) para permitir la comunicación entre los servicios.

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

1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación de la consola de IAM, seleccione Roles y, a continuación, elija Crear rol.

3. Elija el tipo de Cuenta de AWS rol Otro.

4. En el campo ID de cuenta, introduce tu Cuenta de AWS ID.

5. 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.

6. Elija Siguiente: permisos.

7. 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

8. En Role name (Nombre de rol), escriba MediaTailorLogger y luego elija Create role (Crear rol).

9. En la página Roles, seleccione el rol que acaba de crear.

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

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

    2. Elija Editar relación de confianza.

    3. 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"
               }
             }
           }
         ]
       }

    4. 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)

1. 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).

2. 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.