En savoir plus sur l'API DAI Ad Break

L'API Ad Break pour l'insertion dynamique d'annonces (DAI) vous permet de créer et de gérer les données de timing et de ciblage des annonces pour les prochaines coupures publicitaires dans vos diffusions en direct.

L'API DAI Ad Break vous permet d'effectuer les opérations suivantes :

  • Améliorer le taux de remplissage des annonces lors des pics de trafic : donnez plus de temps aux services d'insertion dynamique d'annonces (DAI) 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 forte simultanéité, des tags d'annonces dynamiques ou des annonces à latence élevée.
  • Contrôlez entièrement vos pauses publicitaires : créez, modifiez et supprimez des pauses publicitaires à l'avance. Vous bénéficierez ainsi d'une plus grande flexibilité que si vous utilisiez la signalisation d'annonces dans le fichier manifeste. Vous obtiendrez également un taux de remplissage plus élevé pour la diffusion de pods que si vous utilisiez la prise de décision juste à temps.
  • Offrez une expérience ininterrompue aux spectateurs : minimisez les erreurs de lecture liées aux annonces, comme les pods publicitaires sous-remplis ou surremplis, en fournissant des informations précises sur les pauses.

Ce guide décrit les méthodes de l'API DAI Ad Break et vous explique le cycle de vie des pauses publicitaires pour les flux DAI Full Service et Pod Serving.

Découvrir les méthodes de l'API DAI Ad Break

L'API expose les méthodes standards suivantes pour gérer les ressources AdBreak :

  • Create : définit une nouvelle entité AdBreak pour une entité LiveStreamEvent. Vous pouvez également définir la propriété expectedStartTime pour planifier une décision publicitaire qui commencera dans les 60 secondes précédant le début de l'emplacement publicitaire.
  • Get : récupère les détails d'une entité AdBreak spécifique, y compris l'état de la coupure publicitaire et les métadonnées de timing.
  • List : renvoie une liste d'entités AdBreak créées précédemment avec l'API pour une entité LiveStreamEvent donnée, triées par ordre chronologique inverse. Notez que l'API ne renvoie pas les pauses publicitaires définies uniquement dans le fichier manifeste du flux de contenu.
  • Update : modifie une entité AdBreak existante avant le début de la décision publicitaire.
  • Delete : annule la décision publicitaire pour une entité AdBreak précédemment créée.

Comprendre le cycle de vie des pauses publicitaires

Une entité AdBreak peut avoir les états suivants :

  • BREAK_STATE_UNSPECIFIED : état par défaut.
  • BREAK_STATE_SCHEDULED : la coupure publicitaire a été créée et planifiée pour la décision publicitaire.
  • BREAK_STATE_DECISIONED : les services d'insertion dynamique d'annonces ont commencé le processus de sélection des annonces pour la coupure publicitaire. Vous ne pouvez pas modifier le point d'insertion 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.

Le schéma suivant montre le calendrier d'une entité AdBreak, de sa création à sa finalisation.

Entité de coupure publicitaire, de la création à la fin

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 un emplacement publicitaire moins d'une minute avant l'heure de début prévue, car Google DAI peut ne pas avoir suffisamment de temps pour prendre des décisions concernant les annonces, ce qui entraîne un taux de remplissage des annonces plus faible.
  • É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 pauses publicitaires dans les flux de service complet d'insertion dynamique d'annonces et de diffusion de podcasts.

Comprendre le flux DAI en mode service complet

L'insertion dynamique d'annonces Google en mode service complet gère à la fois le fichier manifeste du contenu et les séries d'annonces.

Pour le ciblage d'annonces personnalisées, utilisez l'API DAI Ad Break pour créer une entité AdBreak avant le repère publicitaire correspondant dans le fichier manifeste du flux de contenu en direct.

  • Ce délai permet aux services Google DAI d'utiliser vos données AdBreak pour la décision publicitaire.
  • Lorsque Google DAI détecte le repère publicitaire dans le fichier manifeste, le système utilise des décisions publicitaires avec les données de l'entité AdBreak et fait passer l'état de l'entité à BREAK_STATE_COMPLETE.

Entité de coupure publicitaire, de la création à la fin, dans le flux de diffusion de pods.

Comprendre le flux de diffusion des pods

Dans ce flux, vous gérez le fichier manifeste du flux en direct de contenu ou utilisez un service tiers de manipulation du fichier manifeste pour détecter les repères publicitaires dans le fichier manifeste.

Appelez l'API DAI Ad Break avant l'heure de début prévue de l'insertion publicitaire pour créer une entité AdBreak avant de demander les segments de l'emplacement publicitaire ou le fichier manifeste de l'annonce.

Lorsque votre assembleur de vidéos détecte le repère publicitaire du fichier manifeste et envoie des requêtes de segment publicitaire avec un ID d'emplacement publicitaire, Google DAI utilise les données AdBreak avec le même ID pour prendre des décisions publicitaires.

Une fois que votre client a demandé un support publicitaire, l'entité AdBreak que vous avez créée via l'API passe à l'état BREAK_STATE_COMPLETE.

État "Terminé" de l'entité de coupure publicitaire

Créer votre première demande

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