Quais são as diretrizes para adicionar variáveis de sessão ADS com valores provenientes de tokens UPID de segmentação no MediaTailor?
Última atualização: 22/02/2022
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:
Sintaxe | Bits | Mnemônico |
MPU() { format_identifier private_data } |
32 N*8 |
uimsbf uimsbf |
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
Este artigo ajudou?
Precisa de ajuda com faturamento ou suporte técnico?