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 des prochaines coupures publicitaires dans vos diffusions en direct.

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

  • Améliorez le taux de remplissage des annonces pendant les pics de trafic : donnez plus de temps aux services d'IA 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 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 d'annonces sous-remplis ou surremplis, en fournissant des informations précises sur les pauses publicitaires.

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 de coupure publicitaire DAI

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 la coupure 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 créée précédemment.

Comprendre le cycle de vie des pauses publicitaires

Une entité AdBreak peut présenter 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 DAI 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.

Le schéma suivant illustre 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 point d'insertion 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 DAI Full Service et Pod Serving.

Comprendre le flux de l'insertion dynamique d'annonces à service complet

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

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

  • Ce délai permet aux services Google DAI d'utiliser vos données AdBreak pour la décision publicitaire.
  • Lorsque l'insertion dynamique d'annonces Google détecte le repère d'annonce 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 DAI à service complet.

Comprendre le flux de diffusion des pods

Dans ce flux, vous gérez le fichier manifeste du flux en direct de contenu ou vous 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 la coupure publicitaire pour créer une entité AdBreak avant de devoir demander les segments de série d'annonces ou le fichier manifeste d'annonces.

Lorsque votre Video Stitcher détecte le repère publicitaire du fichier manifeste et envoie des demandes de segments publicitaires avec un ID de coupure 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 envoyer votre première requête, consultez Utiliser l'API DAI Ad Break.