Informationen zur Stream Activity Monitor API

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 STITCHED oder POD_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, WARNING oder ERROR, 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 Zuordnungen adSelections und adPods an, um die Anzeigenentscheidung zu überprüfen. Untersuchen Sie die Zuordnung adBreaks, 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.stitchingType auf den Wert POD_SERVING festgelegt ist. Vergleichen Sie das Feld adBreakId in den Maps adPods und adBreaks mit Ihren Pod-Manifest- oder Pod-Segment-Anfrageaufrufen und prüfen Sie serverseitige oder Medienbestätigungs-Beacons in der Map trackingPings.
  • DAI Ad Break API: Gleichen Sie den breakSequence-Wert eines AdBreak-Objekts mit dem AdBreak.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.