Quali sono le linee guida per l'aggiunta di variabili di sessione ADS con valori forniti dai token UPID di segmentazione in MediaTailor?

4 minuti di lettura
0

Desidero aggiungere variabili di sessione ADS con valori forniti dai token UPID di segmentazione in AWS Elemental MediaTailor. Quali sono le linee guida per farlo?

Breve descrizione

MediaTailor può inviare dati specifici all'interno dell'ID del programma univoco (UPID) di segmentazione SCTE-35. MediaTailor analizza l'UPID e invia i token al server delle decisioni pubblicitarie (ADS) come variabili di sessione. Se i payload vengono formattati correttamente, puoi inviare una serie di payload di dati privati.

Risoluzione

Di seguito sono riportate le linee guida sui requisiti di formattazione UPID di segmentazione e gli UPID di segmentazione di esempio. La funzionalità è compatibile con DASH e HLS. DASH richiede che il marker binario funzioni con XML EventStreams.

Linee guida

  • L'UPID di segmentazione deve avere quanto segue:
    Un segmentation_upid_type di 12.
    Un format_identifier composto da quattro byte qualsiasi.
  • La soluzione MediaTailor funziona con qualsiasi piattaforma ADS e il numero di token non è fisso.
  • L'UPID decodificato della segmentazione SCTE-35 può contenere uno o più delimitatori da due punti. Se non è presente un delimitatore da due punti, l'UPID viene considerato un valore singolo. I delimitatori da due punti consentono l'immissione di uno o più valori.
  • Il numero di variabili modello e di token UPID decodificati deve essere uguale, come illustrato negli esempi seguenti:
    https://domain/ads?sur0=[scte.segmentation_upid.private_data.0]&sur1=[scte.segmentation_upid.private_data.1]
    :46175218:46175218/5
  • Le variabili del modello URL ADS vengono sono vuote per impostazione predefinita se trovano una stringa non valida, ad esempio https://domain/ads?sur0=&sur1=&sur2=.
  • I limiti e la struttura del formato seguono le specifiche 10.3.3.3 della sezione ANSI/SCTE 35 2019. Questa specifica è la seguente:
SintassiBitMnemonico
MPU () {         format_identifier          private_data }32N*8uimsbfuimsbf

format_identifier è un identificatore univoco a 32 bit come definito in ISO/IEC 13818-1 e registrato presso l'autorità di registrazione SMPTE.

private_data è un insieme di dati di lunghezza variabile, allineati ai byte, come definito dal proprietario registrato del valore del campo format_identifier. La lunghezza è definita da segmentation_upid_length, che include la lunghezza del campo format_identifier.

Esempio di utilizzo dell'UPID di segmentazione

Fonte SCTE

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

SCTE decodificato

MediaTailor analizza l'UPID e presuppone che i primi quattro byte siano il format_identifier. Se il format_identifier manca, private_data tronca i primi quattro byte. Ciò potrebbe causare problemi con l'ADS che si aspetta un valore diverso. Ad esempio, se l'UPID è scritto come 123456 invece di ABCD123456 (dove ABCD è il format_identifier), MediaTailor interpreta 1234 come identificatore di formato e il resto dell'UPID come 56. In tal modo la chiamata ADS viene effettuata con 56 anziché con 123456.

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

UPID decodificato (dati privati)

ABCD:46175218:46175218/5:4053

I byte precedenti, se presenti, sono i campi HyLDA (FreeWheel) codificati in ASCII separati da due punti.

In questo esempio, i token vengono mappati alle variabili di sessione in cui l'ordine dei token è :Airing ID:Break ID:Channel ID. Il token viene quindi inviato al server pubblicitario (ADS). Questo esempio utilizza FreeWheel come server pubblicitario. MediaTailor funziona anche con altri server pubblicitari.

UPID di segmentazione di esempio

  • :DS 8291:33129DS:SAD123 è considerato valido.
  • :46175218:46175218/5:405 3 è considerato valido.
  • :46175218::4053 è considerato non valido a causa dell'uso dei due punti senza alcun valore intermedio.
  • :461752 @a:46175218/5:405 3 è considerato valido.
  • :: è considerato non valido a causa dell'uso dei doppi due punti senza valori precedenti, intermedi o alla fine.

Esempi id variabili di sessione

_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

Informazioni correlate

Uso delle variabili di sessione

AWS UFFICIALE
AWS UFFICIALEAggiornata 2 anni fa