En utilisant AWS re:Post, vous acceptez les AWS re:Post Conditions d’utilisation

Quelles sont les directives pour ajouter des variables de session ADS avec des valeurs fournies par des jetons UPID de segmentation dans MediaTailor ?

Lecture de 4 minute(s)
0

Je veux ajouter des variables de session ADS avec des valeurs fournies par des jetons UPID de segmentation dans AWS Elemental MediaTailor. Quelles sont les directives pour ce faire ?

Brève description

MediaTailor peut envoyer des données spécifiques dans l'identifiant unique de programme (UPID, unique program ID) de segmentation SCTE-35. MediaTailor analyse l'UPID et envoie les jetons au serveur de décision publicitaire (ADS, ad decision server) en tant que variables de session. Si les charges utiles sont correctement formatées, vous pouvez alors envoyer une variété de charges utiles de données privées.

Solution

Vous trouverez ci-dessous des directives sur les exigences de formatage des UPID de segmentation et des exemples d'UPID de segmentation. La fonctionnalité fonctionne pour DASH et HLS. DASH nécessite le marqueur binaire pour fonctionner avec XML EventStreams.

Directives

  • L'UPID de segmentation doit comporter les éléments suivants :
    Un segmentation_upid_type de 12.
    Un format_identifier, composé de quatre octets quelconques.
  • La solution MediaTailor fonctionne avec n'importe quelle plateforme ADS et le nombre de jetons n'est pas fixe.
  • L'UPID de segmentation SCTE-35 décodé peut contenir un ou plusieurs délimiteurs de type deux-points. S'il n'y a pas de délimiteur de type deux-points, l'UPID est considéré comme une valeur unique. Les délimiteurs de type deux-points permettent d'obtenir une ou plusieurs valeurs.
  • Le nombre de variables de modèle et de jetons UPID décodés doit être égal, comme le montrent les exemples suivants :
    https://domain/ads?sur0=[scte.segmentation_upid.private_data.0]&sur1=[scte.segmentation_upid.private_data.1]
    :46175218:46175218/5
  • Les variables de modèle d'URL ADS sont vides par défaut si elles détectent une chaîne non valide, par exemple, https://domain/ads?sur0=&sur1=&sur2=.
  • Les limites et la structure du format suivent la spécification ANSI/SCTE 35 2019 section 10.3.3.3. Cette spécification est la suivante :
SyntaxBitsMnémonique
MPU() {         formate_identifier          private_data }32N*8uimsbfuimsbf

format_identifier est un identifiant unique de 32 bits tel que défini dans ISO/IEC 13818-1 et enregistré auprès de l'autorité d'enregistrement SMPTE.

private_data est un ensemble de données de longueur variable, aligné sur les octets, tel que défini par le propriétaire enregistré de la valeur du champ format_identifier. La longueur est définie par la segmentation_upid_length, qui inclut la longueur du champ format_identifier.

Exemple d'utilisation de l'UPID de segmentation

Source SCTE

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

SCTE décodé

MediaTailor analyse l'UPID et suppose que les quatre premiers octets sont le format_identifier. Si le format_identifier est manquant, private_data tronque les quatre premiers octets. Cela peut causer des problèmes avec l'ADS qui attend une valeur différente. Par exemple, si l'UPID est écrit sous la forme 123456 au lieu de ABCD123456 (où ABCD est le format_identifier), MediaTailor interprète 1234 comme l'identifiant de format et le reste de l'UPID comme 56. L'appel ADS est donc effectué avec 56 au lieu de 123456.

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

UPID décodé (données privées)

ABCD:46175218:46175218/5:4053

Les octets précédents, s'ils sont présents, sont les champs HyLDA (FreeWheel) codés en ASCII et séparés par des deux points.

Dans cet exemple, les jetons correspondent à des variables de session où l'ordre des jetons est :Airing ID:Break ID:Channel ID. Le jeton est ensuite envoyé au serveur publicitaire (ADS). Cet exemple utilise FreeWheel en tant que serveur publicitaire. MediaTailor fonctionne également avec d'autres serveurs publicitaires.

Exemples d'UPID de segmentation

  • :DS8291:33129DS:SAD123 est considéré comme valide.
  • :46175218:46175218/5:4053 est considéré comme valide.
  • :46175218::4053 est considéré comme non valide en raison de l'utilisation du double deux-points sans valeur entre les deux.
  • :461752@a:46175218/5:4053 est considéré comme valide.
  • :: est considéré comme non valide en raison de l'utilisation du double deux-points sans valeur avant, entre ou à la fin.

Exemples de variables de session

_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

Informations connexes

Utilisation des variables de session

AWS OFFICIEL
AWS OFFICIELA mis à jour il y a 3 ans