Métadonnées d'annonce

Ce guide décrit la fonctionnalité de métadonnées d'annonces compatible de l'API Video Stitcher. Les métadonnées de l'annonce sont extraites d'une annonce VAST dans une réponse de tag d'annonce, contenant des événements de suivi des annonces et des annonces associées. L'URL du tag d'emplacement publicitaire est configurée dans la requête de création de session. Pour en savoir plus, consultez les pages Gérer une session en direct et Gérer une session VOD.

Avant de commencer

Assurez-vous de bien connaître les concepts et la terminologie de l'API Video Stitcher. Pour en savoir plus, consultez la présentation technique.

Présentation

Les métadonnées de l'annonce contiennent des événements de suivi des annonces et des annonces associées associées à une annonce assemblée. Un événement de suivi des annonces contient un ping de rappel utilisé pour suivre l'interaction entre l'annonce VAST et le spectateur. Une annonce associée est une annonce destinée à compléter l'annonce VAST parente. En mode de suivi côté client, vous êtes responsable du déclenchement d'événements en fonction du comportement du lecteur.

Suivi des annonces côté serveur

En mode de suivi côté serveur, chaque URI de segment d'annonce est encapsulé dans un URI de redirection, et l'API Video Stitcher gère le traitement des événements de progression chaque fois que le lecteur demande ces segments. Toutefois, les événements d'activité, tels que pause, ne sont pas gérés par l'API Video Stitcher.

Suivi des annonces côté client

En mode de suivi côté client, le client est responsable du déclenchement des événements. Pour en savoir plus, consultez la documentation sur les événements.

Les événements de progression doivent être déclenchés lorsque le temps spécifié s'est écoulé pendant la diffusion de l'annonce. Par exemple, l'événement Start doit être déclenché au début de l'annonce. Pour en savoir plus sur les événements de progression, consultez l'objet d'événement de progression.

Les événements d'activité doivent être déclenchés lorsqu'un spectateur effectue une activité spécifique. Par exemple, l'événement pause doit être déclenché lorsque le spectateur met en pause la vidéo publicitaire. Pour en savoir plus sur les événements d'activité, consultez l'objet d'événement d'activité.

Suivi des annonces VOD côté client

Un objet "interstitials" est renvoyé dans la réponse d'une requête de création de session VOD. Pour savoir comment créer une session de vidéo à la demande, consultez la section Créer une session de vidéo à la demande.

Les interstitiels contiennent les métadonnées de chaque annonce insérée. Lorsque le mode de suivi des annonces client est activé, le client est responsable du déclenchement des événements de suivi si nécessaire. Pour en savoir plus, consultez l'objet "interstitials".

Suivi des annonces en direct côté client

L'API Video Stitcher insère en continu des annonces dans une diffusion en direct. Des informations sur les métadonnées des annonces sont générées chaque fois qu'une nouvelle annonce est insérée.

Pour HLS, le AdMetadataURI permettant de récupérer les métadonnées des annonces se trouve dans la balise #EXT-X-DATERANGE.

Pour DASH, l'AdMetadataURI permettant d'extraire les métadonnées des annonces se trouve dans l'élément <EventStream> pour chaque élément <Period>.

Pour en savoir plus, consultez Gérer le suivi côté client en temps réel.

Annonces associées

Les annonces associées sont des annonces supplémentaires qui peuvent s'afficher avec les annonces linéaires insérées. Pour en savoir plus, consultez l'objet annonces associées.

Étape suivante