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 (
STITCHEDouPOD_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,WARNINGouERRORpour 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.streamCreateRequestpour vérifier l'appel d'enregistrement du flux, consultez les mappagesadSelectionsetadPodspour examiner la prise de décision concernant les annonces, et examinez le mappageadBreakspour 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.stitchingTypeest défini sur la valeurPOD_SERVING, comparez le champadBreakIddans les mappagesadPodsetadBreaksavec 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 mappagetrackingPings. - API DAI Ad Break : faites correspondre la valeur
breakSequenced'un objetAdBreakavec 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.