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

Para utilizar AWS Elemental MediaTailor, necesitas un Cuenta de AWS y permisos para acceder, ver y editar MediaTailor las configuraciones. 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:

• 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 su reproductor o 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 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 que hayas configurado la transmisión, anota el URL prefijo de origen del contenido del manifiesto maestro. Lo necesitas para crear la configuración en AWS Elemental MediaTailor, más adelante en este tutorial.

Prepara una DASH transmisión

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. La disponibilidad del anuncio comienza al inicio del evento y dura toda la duración del evento, si se especifica alguna, o hasta que comience 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 anuncios deben tener la misma Representation configuración de anuncios que AdaptationSet las transmisiones de contenido. AWS Elemental MediaTailor utiliza estos ajustes para transcodificar los anuncios para que coincidan con el flujo de contenido, de forma que se pueda cambiar fácilmente entre ambos.

Tras configurar la transmisión, anota el URL prefijo de origen del contenido del DASH manifiesto. Lo necesitas 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 (denotado por los session 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 Añadir 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 VAST solicitud de cada sesión.

• 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 la configuración de pares clave-valor en la solicitud, AWS Elemental MediaTailor, consulte Uso de variables de anuncios dinámicos en MediaTailor.

Introduzca 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 MP4 intermedia que AWS Elemental MediaTailor puede transcodificar. Si la respuesta de ADS contiene varias variantes de reproducción, MediaTailor selecciona la de mayor calidad y resolución MP4 y la envía al transcodificador.

Paso 4: Crear una configuración

La AWS Elemental MediaTailor la configuración contiene la información de mapeo del servidor de origen y. 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 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 se conecta al origen del contenido y no puede publicar los manifiestos en respuesta a las solicitudes de los jugadores.

5. Para el servidor de decisiones publicitarias, 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.

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

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

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 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-endpointes el único punto final de reproducción que AWS Elemental MediaTailor generado cuando se creó la configuración.

  Ejemplo

  https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com

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

  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. Cualquier variable dinámica definida por el jugador que hayas utilizado en la ADS solicitud URL Paso 3: Configurar los parámetros de ADS solicitud URL y consulta debe estar definida en la solicitud de manifiesto del jugador.

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 y 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 MediaTailor

Paso 7 (opcional): Supervisar AWS Elemental MediaTailor activity

Usa Amazon CloudWatch y Amazon CloudWatch Logs para rastrear AWS Elemental MediaTailor actividad, como el recuento de solicitudes, errores y anuncios disponibles, completados.

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

Permitir AWS Elemental MediaTailor acceso a CloudWatch (consola)

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

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

3. Elija Otro Cuenta de AWStipo de rol.

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 política, cambie el principal por el AWS Elemental MediaTailor servicio. 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 el AWS Elemental MediaTailor En la página de 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.