View a markdown version of this page

Server-side suivi avec insertion publicitaire guidée par le serveur (SGAI) - AWS Elemental MediaTailor

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Server-side suivi avec insertion publicitaire guidée par le serveur (SGAI)

Lorsque vous utilisez l'insertion publicitaire guidée par le serveur (SGAI), le suivi côté serveur utilise un mécanisme de balisage sans session qui diffère de l'approche en mode assemblé décrite ci-dessus. Au lieu d' MediaTailor intégrer des segments publicitaires dans le manifeste de contenu (où il suit les /v1/segment demandes), SGAI renvoie les références publicitaires sous forme de playlists distinctes dans une réponse contenant une liste de ressources avec des métadonnées de balises intégrées dans les URI des annonces.

Comment fonctionne le beaconing sans session côté serveur

Les étapes suivantes décrivent le fonctionnement du balisage côté serveur pour les sessions SGAI :

  1. Initialisation de session : le joueur demande la playlist multivariante HLS avec. aws.insertionMode=GUIDED Server-side le reporting est la valeur par défaut (aucun aws.reportingMode paramètre n'est nécessaire). Contrairement au mode assemblé, la réponse d'initialisation de session n'inclut pas de. trackingUrl

  2. Manifeste pouvant être mis en cache : MediaTailor renvoie un manifeste pouvant être mis en cache contenant des EXT-X-DATERANGE balises CLASS="com.apple.hls.interstitial" et des X-ASSET-LIST attributs pointant vers le point de terminaison de la liste d' MediaTailoractifs interstitiels.

  3. Liste des actifs avec métadonnées relatives aux balises : lorsque le joueur rencontre une interruption publicitaire, il récupère la liste des actifs. MediaTailorrenvoie une réponse JSON dans laquelle chaque URI d'annonce inclut des métadonnées de balise cryptées :

    { "ASSETS": [ { "DURATION": 30.0, "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>" } ] }

    Lorsque le reporting côté serveur est actif, la réponse n'inclut aucune section. TRACKING Les URI des annonces contiennent toutes les données des balises.

  4. Substitution de variables HLS : le lecteur récupère la liste de lecture multivariée de l'annonce. Le manifeste publicitaire utilise des #EXT-X-DEFINE:QUERYPARAM directives pour transmettre les paramètres de balise de la chaîne de requête d'URI aux URL des segments via la substitution de variables HLS :

    #EXTM3U #EXT-X-DEFINE:QUERYPARAM="awsBeaconData" #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain" #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName" #EXTINF:5.0, {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts

    Le joueur résout les {$awsConfigurationName} variables {$awsBeaconData}{$awsBeaconDomain}, et en utilisant les valeurs de la chaîne de requête URI du manifeste publicitaire, puis demande le passage de chaque segment publicitaire MediaTailor.

  5. Balise déclenchée à la demande d'un segment : au fur et à mesure que le joueur demande chaque segment publicitaire, la demande est transmise MediaTailor. Le service déchiffre les données de balise, détermine la position du segment dans l'annonce (impression, premier quartile, point médian, troisième quartile ou complet) et envoie la balise de suivi VAST appropriée au serveur publicitaire. MediaTailor redirige ensuite le lecteur vers le segment de contenu publicitaire proprement dit.

Exigences relatives aux joueurs pour le balisage SGAI côté serveur

Pour utiliser le balisage côté serveur avec SGAI, votre joueur doit répondre aux exigences suivantes :

  • HLS version 11 ou ultérieure

  • Support EXT-X-DATERANGE avec CLASS attribut pour HLS Interstitials

  • Support pour la substitution de #EXT-X-DEFINE:QUERYPARAM variables (RFC 8216bis). Le joueur doit décoder en pourcentage les valeurs des paramètres de requête avant de les remplacer par des URL de segment.

Note

Le balisage SGAI côté serveur n'est actuellement pris en charge que pour le HLS. DASH n'est pas encore compatible avec le balisage SGAI côté serveur.

Comparaison avec le suivi côté serveur en mode cousu

Le tableau suivant résume les différences entre le suivi côté serveur entre l'insertion d'annonces cousues et l'insertion guidée par le serveur :

Aspect Cousu (SSAI) Server-guided (SHAI)
Possibilité de mise en cache du manifeste Per-session, ne peut pas être mis en cache Peut être mis en cache, partagé entre les spectateurs
Routage des segments publicitaires En /v1/segment/ utilisant l'identifiant de session /v1/segment/En utilisant un blob de données de balise crypté
État de session pour les balises Stocké par session dans MediaTailor Sans session : tous les états sont enregistrés dans le paramètre crypté awsBeaconData
URL de suivi lors de l'initialisation de la session Renvoyé dans la réponse d'initialisation de session Non fourni : les données des balises sont intégrées aux URI des annonces dans chaque réponse à la liste d'actifs
Prise en charge de DASH Pris en charge Pas encore pris en charge
Note

Pour les sessions SGAI en direct, vous pouvez activer la prélecture des annonces basée sur le manifeste à l'aide de. aws.guidedPrefetchMode=MANIFEST Ceci est distinct de l'API de prélecture basée sur un calendrier utilisée avec les sessions Stitched (SSAI). Pour en savoir plus, consultez Prélecture guidée avec battements de cœur manifestes.