Quais são as diretrizes para adicionar variáveis de sessão ADS com valores provenientes de tokens UPID de segmentação no MediaTailor?

4 minuto de leitura
0

Desejo adicionar variáveis de sessão ADS com valores provenientes de tokens UPID de segmentação no AWS Elemental MediaTailor. Quais são as diretrizes para fazer isso?

Breve descrição

O MediaTailor pode enviar dados específicos dentro do ID de programa exclusivo (UPID) de segmentação SCTE-35. O MediaTailor analisa o UPID e envia os tokens para o servidor de decisão de anúncios (ADS) como variáveis de sessão. Se as cargas estiverem formatadas corretamente, você poderá enviar uma variedade de cargas úteis de dados particulares.

Resolução

A seguir estão as diretrizes sobre os requisitos de formatação de UPID de segmentação e exemplo de UPIDs de segmentação. A funcionalidade funciona para DASH e HLS. O DASH requer que o marcador binário funcione com XML EventStreams.

Diretrizes

  • O UPID de segmentação deve ter o seguinte:
    Um segmentation_upid_type de 12.
    Um format_identifier, composto por quatro bytes.
  • A solução MediaTailor funciona com qualquer plataforma ADS e o número de tokens não é fixo.
  • O UPID de segmentação SCTE-35 decodificado pode conter um ou mais delimitadores de dois pontos. Se não houver delimitador de dois pontos (:), o UPID será considerado um valor único. Os delimitadores de dois pontos permitem um ou mais valores.
  • O número de variáveis de modelo e tokens UPID decodificados deve ser igual, conforme mostrado nos exemplos a seguir:
    https://domain/ads?sur0=[scte.segmentation_upid.private_data.0]&sur1=[scte.segmentation_upid.private_data.1]
    :46175218:46175218/5
  • As variáveis de modelo de URL do ADS ficam vazias por padrão se encontrarem uma string inválida, por exemplo, https://domain/ads?sur0=&sur1=&sur2=.
  • Os limites e a estrutura de formato seguem a especificação ANSI/SCTE 35 2019, seção 10.3.3.3. Essa especificação é a seguinte:
SintaxeBitsMnemônico
MPU() {         format_identifier          private_data }32N*8uimsbfuimsbf

format_identifier é um identificador exclusivo de 32 bits, conforme definido na ISO/IEC 13818-1 e registrado na Autoridade de Registro SMPTE.

private_data é um conjunto de dados alinhado a bytes de comprimento variável, conforme definido pelo proprietário registrado do valor do campo format_identifier. O comprimento é definido pelo segmentation_upid_length, que inclui o comprimento do campo format_identifier.

Exemplo de uso de UPID de segmentação

Fonte SCTE

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

SCTE decodificado

O MediaTailor analisa o UPID e assume que os primeiros quatro bytes são o format_identifier. Se o format_identifier estiver ausente, o private_data trunca os primeiros quatro bytes. Isso pode causar problemas com o ADS esperando um valor diferente. Por exemplo, se o UPID for escrito como 123456 em vez de ABCD123456 (onde ABCD é o format_identifier), o MediaTailor interpreta 1234 como o identificador de formato e o restante do UPID como 56. Isso faz com que a chamada ADS seja feita com 56 em vez de 123456.

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

UPID decodificado (dados privados)

ABCD:46175218:46175218/5:4053

Os bytes anteriores, se presentes, são os campos HyLDA (FreeWheel) codificados em ASCII separados por dois pontos (:).

Neste exemplo, os tokens são mapeados para variáveis de sessão em que a ordem do token é :Airing ID:Break ID:Channel ID. O token é enviado para o servidor de anúncios (ADS). Este exemplo usa o FreeWheel como o servidor de anúncios. O MediaTailor também funciona com outros servidores de anúncios.

Exemplo de UPIDs de segmentação

  • :DS8291:33129DS:SAD123 é considerado válido.
  • :46175218:46175218/5:4053 é considerado válido.
  • :46175218::4053 é considerado inválido devido ao uso do dois pontos duplos sem valor no meio.
  • :461752@a:46175218/5:4053 é considerado válido.
  • :: é considerado inválido devido ao uso do dois pontos duplos sem valores antes, entre ou no final.

Exemplo de variáveis de sessão

_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

Informações relacionadas

Usar variáveis de sessão

AWS OFICIAL
AWS OFICIALAtualizada há 2 anos