L'API DAI Ad Break vous permet de créer et de gérer les données de timing et de ciblage des annonces pour les prochaines coupures publicitaires de vos diffusions en direct.
L'API DAI Ad Break vous permet d'effectuer les opérations suivantes :
- Améliorez le taux de remplissage publicitaire pendant les pics de trafic : donnez aux services d'insertion dynamique d'annonce plus de temps pour sélectionner les annonces les plus rentables pour vos événements en direct. Nous vous recommandons d'utiliser l'API DAI Ad Break lorsque vos événements de diffusion en direct présentent une simultanéité élevée, des tags d'emplacement publicitaire dynamiques ou des annonces à latence élevée.
- Contrôlez entièrement vos coupures publicitaires : créez, mettez à jour et supprimez des coupures publicitaires à l'avance, ce qui offre plus de flexibilité que la signalisation des annonces dans le fichier manifeste et un taux de remplissage plus élevé pour la diffusion de pods par rapport à la prise de décision juste-à-temps.
- Offrez une expérience de visionnage sans interruption : réduisez les erreurs de lecture liées aux annonces, telles que les séries d'annonces incomplètes ou trop longues, en fournissant des informations précises sur les coupures.
Ce guide décrit les méthodes de l'API DAI Ad Break et vous présente le cycle de vie des coupures publicitaires pour les flux DAI Full Service et Pod Serving.
Découvrir les méthodes de l'API DAI pour les coupures publicitaires
L'API expose les méthodes standards suivantes pour gérer les ressources AdBreak :
Create: définit une nouvelle entitéAdBreakpour une entitéLiveStreamEvent. Vous pouvez également définir la propriétéexpectedStartTimepour planifier une décision publicitaire qui commencera dans les 60 secondes précédant le début de la coupure publicitaire.Get: récupère les détails d'une entitéAdBreakspécifique, y compris l'état de la coupure publicitaire et les métadonnées de code temporel.List: renvoie une liste d'entitésAdBreakprécédemment créées avec l'API pour une entitéLiveStreamEventdonnée, triées par ordre chronologique inverse. Notez que l'API ne renvoie pas les coupures publicitaires définies uniquement dans le fichier manifeste du flux de contenu.Update: modifie une entitéAdBreakexistante avant le début de la décision d'annonce.Delete: annule la décision d'annonce pour une entitéAdBreakcréée précédemment.
Comprendre le cycle de vie d'une coupure publicitaire
Une entité AdBreak peut avoir les états suivants :
BREAK_STATE_UNSPECIFIED: état par défaut.BREAK_STATE_SCHEDULED: la coupure publicitaire a bien été créée et planifiée pour la décision d'annonce.BREAK_STATE_DECISIONED: les services d'insertion dynamique d'annonce ont commencé le processus de sélection des annonces pour la coupure publicitaire. Vous ne pouvez pas modifier la coupure publicitaire, mais vous pouvez toujours l'annuler, ce qui peut avoir des effets négatifs sur les ad servers.
BREAK_STATE_COMPLETE: la coupure publicitaire a été diffusée auprès des utilisateurs.BREAK_STATE_EXPIRED: la coupure publicitaire a expiré avant d'être diffusée. Cette option n'est applicable que lorsque vous activez la planification de plusieurs coupures sur l'événement de diffusion en direct. Pour en savoir plus, consultez Paramètres des coupures publicitaires mid-roll. Par défaut, les coupures publicitaires expirent 30 minutes après la valeur du champexpectedStartTime, ou 30 minutes après le début de la prise de décision si vous ne définissez pas le champexpectedStartTime. Vous pouvez personnaliser cette durée à l'aide du champexpireDuration.
Le schéma suivant montre la chronologie d'une entité AdBreak, de sa création à sa finalisation.

Vous pouvez créer une entité AdBreak entre 1 et 300 minutes avant le début prévu de la coupure publicitaire.
- Évitez de créer une coupure publicitaire moins d'une minute avant l'heure de début prévue, car l'insertion dynamique d'annonces Google risque de ne pas avoir assez de temps pour prendre des décisions concernant les annonces, ce qui entraînerait une baisse du taux de remplissage publicitaire.
- Évitez de créer une coupure publicitaire plus de six heures avant l'heure de début prévue, car les ad servers pourraient invalider les annonces demandées.
Les sections suivantes décrivent les transitions d'état des coupures publicitaires dans les flux de service complet et de diffusion de groupes d'annonces de l'insertion dynamique d'annonce.
Comprendre le flux d'insertion dynamique d'annonce à service complet
L'insertion dynamique d'annonce Google à service complet gère à la fois le fichier manifeste du contenu et les séries d'annonces.
Pour le ciblage d'annonces personnalisé, utilisez l'API DAI Ad Break pour créer une entité AdBreak avant le repère d'annonce correspondant dans le fichier manifeste du flux de contenu en direct.
- Ce délai permet aux services d'insertion dynamique d'annonce Google d'utiliser vos données
AdBreakpour prendre une décision concernant l'annonce. - Lorsque l'insertion dynamique d'annonces Google détecte le repère d'annonce du fichier manifeste, le système utilise les décisions d'annonce avec les données de l'entité
AdBreaket fait passer l'état de l'entité àBREAK_STATE_COMPLETE.
Lorsque vous activez la programmation de plusieurs coupures sur l'événement de diffusion en direct, vous pouvez définir le champ matchParams sur une entité AdBreak. Ce processus permet à l'IDA Google de faire correspondre les repères d'annonce détectés dans le fichier manifeste avec les coupures publicitaires à l'état BREAK_STATE_SCHEDULED ou BREAK_STATE_DECISIONED.

Comprendre le flux de diffusion des pods
Dans ce flux, vous gérez le fichier manifeste de diffusion en direct du contenu ou utilisez un service tiers de manipulation du fichier manifeste pour détecter les repères d'annonce dans le fichier manifeste.
Appelez l'API DAI Ad Break avant l'heure de début prévue de la coupure publicitaire pour créer une entité AdBreak avant de devoir demander les segments de la série d'annonces ou le fichier manifeste d'annonce.
Lorsque votre Video Stitcher détecte le repère d'annonce du fichier manifeste et envoie des requêtes de segment d'annonce avec un ID de coupure publicitaire, l'IDA Google utilise les données AdBreak avec le même ID pour prendre des décisions concernant les annonces.
Une fois que votre client a demandé un contenu multimédia publicitaire, l'entité AdBreak que vous avez créée via l'API passe à l'état BREAK_STATE_COMPLETE.

Créer votre première requête
Pour configurer l'accès à l'API et envoyer votre première requête, consultez Utiliser l'API DAI Ad Break.