¿Cuáles son las pautas para agregar variables de sesión ADS con valores proporcionados por tokens UPID de segmentación en MediaTailor?

Última actualización: 22-02-2022

Quiero agregar variables de sesión ADS con valores proporcionados por tokens UPID de segmentación en AWS Elemental MediaTailor. ¿Cuáles son las pautas para hacerlo?

Descripción corta

MediaTailor puede enviar datos específicos dentro del ID de programa único (UPID) de segmentación SCTE-35. MediaTailor analiza el UPID y envía los tokens al servidor de decisión de anuncios (ADS) como variables de sesión. Si las cargas están formateadas correctamente, puede enviar una variedad de cargas útiles de datos privados.

Resolución

A continuación se ofrecen pautas sobre los requisitos de formato de UPID de segmentación y ejemplos de UPID de segmentación. Esta funcionalidad es apta para DASH y HLS. DASH requiere que el marcador binario funcione con XML EventStreams.

Pautas

  • El UPID de segmentación debe tener lo siguiente:
    Un segmentation_upid_type de 12.
    Un format_identifier, que consta de cuatro bytes cualesquiera.
  • La solución MediaTailor funciona con cualquier plataforma ADS y la cantidad de tokens no es fija.
  • El UPID de segmentación de SCTE-35 decodificado puede contener uno o más delimitadores de dos puntos. Si no hay delimitador en forma de dos puntos (“:”), el UPID se considera un valor único. Los delimitadores de dos puntos permiten uno o más valores.
  • El número de variables de plantilla y tokens UPID decodificados debe ser igual, como se muestra en los siguientes ejemplos:
    https://domain/ads?sur0=[scte.segmentation_upid.private_data.0]&sur1=[scte.segmentation_upid.private_data.1]
    :46175218:46175218/5
  • Las variables de plantilla de URL de ADS están vacías de forma predeterminada si encuentran una cadena no válida, por ejemplo, https://domain/ads?sur0=&sur1=&sur2=.
  • Los límites y la estructura de formato siguen la especificación ANSI/SCTE 35 2019 sección 10.3.3.3. Dicha especificación es la siguiente:

Syntax Bits Mnemonic
MPU() {
         format_identifier
         private_data
}

32
N*8


uimsbf
uimsbf
format_identifier es un identificador único de 32 bits tal como se define en ISO/IEC 13818-1 y registrado en la Autoridad de Registro de SMPTE.
private_data es un conjunto de datos de longitud variable y alineado en bytes según lo definido por el propietario registrado del valor del campo format_identifier. La longitud se define mediante segmentation_upid_length, que incluye la longitud del campo format_identifier.

Ejemplo de uso de UPID de segmentación

Origen de SCTE

/DBlAAAAAAAAAP/wFAUAFlNif+//5KMqQ/4AUmXAAAAAAAA9AAhDVUVJAAAAAAIxQ1VFSQAWU2J/wAAAUmXADB15aml0OjQ2MTc1MjE4OjQ2MTc1MjE4LzU6NDA1MwAAAAAAAIu9c38=

SCTE descodificado

MediaTailor analiza el UPID y asume que los primeros cuatro bytes pertenecen al campo format_identifier. Si falta el campo format_identifier, private_data trunca los primeros cuatro bytes. Esto puede causar problemas con el ADS, ya que espera un valor diferente. Por ejemplo, si el UPID se escribe como 123456 en lugar de ABCD123456 (donde ABCD es el campo format_identifier), entonces MediaTailor interpreta 1234 como el identificador de formato y el resto del UPID como 56. Esto hace que la llamada a ADS se realice con 56 en lugar de 123456.

"segmentation_upid_type": 12,
                  "segmentation_upid_type_name": "MPU",
                  "segmentation_upid_length": 29,
                  "segmentation_upid": {
                        "format_identifier": "0x796a6974",
                        "private_data": "0x3a34363137353231383a34363137353231382f353a34303533"
                  },

UPID descodificado (datos privados)

ABCD:46175218:46175218/5:4053

Los bytes anteriores, si están presentes, son los campos HyLDA (FreeWheel) codificados en ASCII y separados por dos puntos.

En este ejemplo, los tokens se asignan a variables de sesión en las que el orden de los tokens es :ID de emisión:ID de pausa:ID de canal. A continuación, el token se envía al servidor de anuncios (ADS). En este ejemplo, se utiliza FreeWheel como servidor de anuncios. MediaTailor también funciona con otros servidores de anuncios.

Ejemplo de UPID de segmentación

  • :DS8291:33129DS:SAD123 se considera válido.
  • :46175218:46175218/5:4053 se considera válido.
  • :46175218::4053 se considera inválido debido al uso de dos puntos sin ningún valor intermedio.
  • :461752@a:46175218/5:4053 se considera válido.
  • :: se considera inválido debido al uso de dos puntos sin valores antes, entre o al final de dicho signo.

Variables de sesión de ejemplo

_fw_hylda=aiid=[scte.segmentation_upid.private_data.0]&abid=[scte.segmentation_upid.private_data.1]&acid=[scte.segmentation_upid.private_data.2]

_fw_hylda=aiid=46175218&abid=46175218/5&acid=4053

_fw_hylda=aiid%3D46175190%26abid%3D46175190%2F2%26acid%3D4053

¿Le resultó útil este artículo?


¿Necesita asistencia técnica o con la facturación?