En savoir plus sur l'API Stream Activity Monitor

L'API CAF (contrôle de l'activité des flux) pour l'insertion dynamique d'annonces (DAI) vous permet d'inspecter et de résoudre les problèmes liés aux sessions de visionnage individuelles de diffusions en direct et de vidéos à la demande (VOD).

Pour inspecter visuellement et résoudre les problèmes d'une session de visionnage de diffusion en direct ou de VOD, utilisez le contrôle de l'activité des flux dans l'interface utilisateur de Google Ad Manager. Pour récupérer les données de diagnostic d'une session de manière programmatique, utilisez la ressource networks.daiSessions de l'API Ad Manager.

Comprendre les cas d'utilisation

L'API SAM vous permet d'automatiser les diagnostics de flux et de résoudre les problèmes de diffusion des annonces dans vos intégrations DAI, par exemple :

  • Vérifier la création de la session de flux : confirmez les paramètres, le mode d'assemblage (STITCHED ou POD_SERVING), le mode de reporting et les métadonnées de contenu que l'insertion dynamique d'annonces Google reçoit lors de la création d'une session de diffusion en direct ou de VOD.
  • Auditer les demandes d'annonces et les réponses : inspectez les tags d'emplacement publicitaire VAST (Video Ad Serving Template) et VMAP (Video Multiple Ad Playlist) sortants, les codes d'état HTTP, les latences de réponse, les corps de réponse XML bruts et les chaînes de redirection de wrapper.
  • Résoudre les problèmes liés aux décisions et aux créations des séries d'annonces : vérifiez les annonces que Google DAI sélectionne ou supprime pour chaque série, la durée de chaque annonce dans la série et le système publicitaire source de la création.
  • Suivre l'exécution du préchargement des annonces : déterminez si l'insertion dynamique d'annonces Google précharge une série d'annonces et vérifiez l'étape de préchargement de chaque série d'annonces.
  • Valider les appels d'API pour les coupures publicitaires DAI et les appels d'API DAI pour la diffusion de séries d'annonces : vérifiez l'exécution réelle des coupures, la durée des annonces diffusées et la durée des écrans de transition insérés par rapport aux appels d'API, tels que l'API Ad Break et l'API d'insertion dynamique de séries d'annonces.
  • Vérifier le suivi des événements d'annonce : vérifiez si les pings de suivi côté client ou côté serveur ont réussi et inspectez les réponses HTTP des ad servers.
  • Automatiser la surveillance des sessions et les alertes : analysez les entrées de résultats structurées avec un niveau de gravité INFO, WARNING ou ERROR pour détecter les problèmes de lecture ou de monétisation dans les tests d'intégration automatisés et les pipelines de surveillance de la production.

Découvrir la ressource de premier niveau

L'API SAM fait partie de l'API REST Google Ad Manager (bêta) sur le point de terminaison admanager.googleapis.com et expose la méthode en lecture seule networks.daiSessions.get. Vous pouvez interroger une ressource DaiSession avec un ID de session DAI ou une clé de débogage personnalisée. L'insertion dynamique d'annonces conserve les enregistrements de session pendant trois jours maximum après la lecture.

L'API SAM ne permet pas de lister toutes les ressources DaiSession d'un réseau Google Ad Manager.

Inspecter les réponses de flux d'insertion dynamique d'annonce avec SAM

Pour vérifier comment Google DAI traite vos requêtes de flux, examinez la réponse DaiSession :

  • API DAI à service complet : inspectez le champ creationContext.streamCreateRequest pour vérifier l'appel d'enregistrement du flux, consultez les mappages adSelections et adPods pour examiner la prise de décision concernant les annonces, et examinez le mappage adBreaks pour confirmer les durées des annonces raccordées, des créations de type écran de remplacement et du contenu sous-jacent.
  • API d'insertion dynamique d'annonce pour la diffusion de séries d'annonces : vérifiez que le champ creationContext.stitchingType est défini sur la valeur POD_SERVING, comparez le champ adBreakId dans les mappages adPods et adBreaks avec vos appels de requête de fichier manifeste ou de segment de série d'annonces, et inspectez les balises de vérification côté serveur ou de vérification des médias dans le mappage trackingPings.
  • API DAI Ad Break : faites correspondre la valeur breakSequence d'un objet AdBreak avec la propriété AdBreak.breakSequence.

Créer votre première requête

Pour configurer l'authentification et récupérer les ressources de session d'insertion dynamique d'annonce, consultez Utiliser l'API Stream Activity Monitor.