Mit der API für die Überprüfung der Streamingaktivitäten (Stream Activity Monitor, SAM) für die dynamische Anzeigenbereitstellung (Dynamic Ad Insertion, DAI) können Sie einzelne Livestream- und Video-on-Demand-Sitzungen (VOD) prüfen und Fehler beheben.
Wenn Sie einen einzelnen Livestream oder eine VOD-Wiedergabesitzung visuell prüfen und Fehler beheben möchten, verwenden Sie die Überprüfung der Streamingaktivitäten in der Google Ad Manager-Benutzeroberfläche.
Wenn Sie Diagnosedaten für eine Sitzung programmatisch abrufen möchten, verwenden Sie die Ad Manager API-Ressource networks.daiSessions.
Anwendungsfälle kennenlernen
Mit der SAM API können Sie die Streamdiagnose automatisieren und Probleme bei der Anzeigenauslieferung in Ihren DAI-Integrationen beheben, z. B.:
- Erstellung der Streamsitzung prüfen: Bestätigen Sie die Parameter, den Stitching-Modus von
STITCHEDoderPOD_SERVING, den Berichtsmodus und die Content-Metadaten, die die dynamische Anzeigenbereitstellung von Google beim Erstellen einer Livestream- oder VOD-Sitzung empfängt. - Anzeigenanfragen und -antworten prüfen: Prüfen Sie ausgehende VAST- (Video Ad Serving Template) und VMAP-Anzeigen-Tags (Video Multiple Ad Playlist), HTTP-Statuscodes, Antwortlatenzen, Roh-XML-Antworttext und Wrapper-Weiterleitungsketten.
- Fehlerbehebung bei Entscheidungen und Creatives für Anzeigen-Pods: Sie können prüfen, welche Anzeigen von Google DAI für die einzelnen Pods ausgewählt oder verworfen werden, wie lange die einzelnen Anzeigen im Pod dauern und welches Quellanzeigensystem für das Anzeigen-Creative verwendet wird.
- Prefetch-Ausführung für Anzeigen verfolgen: Sie können feststellen, ob die dynamische Anzeigenbereitstellung von Google einen Anzeigen-Pod vorab abruft, und die Prefetch-Phase jedes Anzeigen-Pods prüfen.
- API-Aufrufe für die DAI Ad Break API und die Pod Serving DAI API validieren: Vergleichen Sie die tatsächliche Ausführung von Werbeunterbrechungen, die Dauer der ausgelieferten Anzeigen und die Dauer der eingefügten Slates mit API-Aufrufen, z. B. für die DAI Ad Break API und die Pod Serving DAI API.
- Anzeigenereignis-Tracking prüfen: Prüfen Sie, ob clientseitige oder serverseitige Tracking-Pings erfolgreich waren, und sehen Sie sich die HTTP-Antworten von Ad-Servern an.
- Sitzungsmonitoring und Benachrichtigungen automatisieren: Parsen Sie strukturierte Ergebniseinträge mit dem Schweregrad
INFO,WARNINGoderERROR, um Wiedergabe- oder Monetarisierungsprobleme in automatisierten Integrationstests und Produktionsmonitoring-Pipelines zu erkennen.
Ressource der obersten Ebene kennenlernen
Die SAM API ist Teil der Google Ad Manager REST API (Beta) am Endpunkt admanager.googleapis.com und stellt die schreibgeschützte Methode networks.daiSessions.get bereit. Sie können eine DaiSession-Ressource mit einer Sitzungs-ID für die dynamische Anzeigenbereitstellung oder einem benutzerdefinierten Schlüssel zur Fehlerbehebung abfragen. Bei der dynamischen Anzeigenbereitstellung werden die Sitzungsaufzeichnungen bis zu drei Tage nach der Wiedergabe aufbewahrt.
Die SAM API unterstützt nicht das Auflisten aller DaiSession-Ressourcen in einem Google Ad Manager-Netzwerk.
Antworten von Streams der dynamischen Anzeigenbereitstellung mit SAM prüfen
Wenn Sie prüfen möchten, wie Google DAI Ihre Streamanfragen verarbeitet, sehen Sie sich die Antwort von DaiSession an:
- Full-Service-API für die dynamische Anzeigenbereitstellung: Prüfen Sie das Feld
creationContext.streamCreateRequest, um den Aufruf zur Streamregistrierung zu verifizieren. Sehen Sie sich die ZuordnungenadSelectionsundadPodsan, um die Anzeigenentscheidung zu überprüfen. Untersuchen Sie die ZuordnungadBreaks, um die Dauer der eingefügten Anzeigen, Slate-Creatives und zugrunde liegenden Inhalte zu bestätigen. - Pod-Auslieferung über die DAI API: Prüfen Sie, ob das Feld
creationContext.stitchingTypeauf den WertPOD_SERVINGfestgelegt ist. Vergleichen Sie das FeldadBreakIdin den MapsadPodsundadBreaksmit Ihren Pod-Manifest- oder Pod-Segment-Anfrageaufrufen und prüfen Sie serverseitige oder Medienbestätigungs-Beacons in der MaptrackingPings. - DAI Ad Break API: Gleichen Sie den
breakSequence-Wert einesAdBreak-Objekts mit demAdBreak.breakSequence-Attribut ab.
Erste Anfrage senden
Informationen zum Einrichten der Authentifizierung und zum Abrufen von DAI-Sitzungsressourcen finden Sie unter API zur Überprüfung der Streamingaktivitäten verwenden.