Weitere Informationen zur DAI Ad Break API

Mit der DAI Ad Break API können Sie das Timing und die Daten zur Anzeigenausrichtung für bevorstehende Werbeunterbrechungen in Ihren Livestreams erstellen und verwalten.

Mit der DAI Werbeunterbrechungs-API haben Sie folgende Möglichkeiten:

  • Anzeigenverfügbarkeit bei hohem Traffic verbessern: DAI-Diensten mehr Zeit geben, um die Anzeigen mit dem höchsten Ertrag für Ihre Live-Events auszuwählen. Wir empfehlen die DAI Ad Break API, wenn Ihre Livestream-Events eine hohe Anzahl gleichzeitiger Zuschauer, dynamische Anzeigen-Tags oder Anzeigen mit hoher Latenz haben.
  • Volle Kontrolle über deine Werbeunterbrechungen: Du kannst Werbeunterbrechungen im Voraus erstellen, aktualisieren und löschen. Das bietet mehr Flexibilität als die In-Manifest-Anzeigensignalisierung und eine höhere Fillrate für die Pod-Bereitstellung als die Just-in-Time-Entscheidungsfindung.
  • Unterbrechungsfreie Wiedergabe für Zuschauer: Durch die Bereitstellung präziser Pauseninformationen können Sie wiedergabebezogene Anzeigenfehler wie unter- oder überfüllte Anzeigen-Pods minimieren.

In diesem Leitfaden werden die Methoden der DAI Ad Break API beschrieben und der Lebenszyklus von Werbeunterbrechungen für DAI Full Service- und Pod Serving-Abläufe wird erläutert.

DAI Ad Break API-Methoden

Die API bietet die folgenden Standardmethoden zum Verwalten von AdBreak-Ressourcen:

  • Create: Definiert eine neue AdBreak-Entität für eine LiveStreamEvent-Entität. Optional: Legen Sie das Attribut expectedStartTime fest, um eine Anzeigenentscheidung so zu planen, dass sie innerhalb von 60 Sekunden vor Beginn der Werbeunterbrechung startet.
  • Get: Ruft die Details einer bestimmten AdBreak-Entität ab, einschließlich des Status von Werbeunterbrechungen und der Timing-Metadaten.
  • List: Gibt eine Liste der AdBreak-Entitäten zurück, die zuvor mit der API für eine bestimmte LiveStreamEvent-Entität erstellt wurden, sortiert in umgekehrter chronologischer Reihenfolge. Die API gibt keine Werbeunterbrechungen zurück, die nur im Manifest des Contentstreams definiert sind.
  • Update: Ändert eine vorhandene AdBreak-Entität, bevor die Anzeigenentscheidung beginnt.
  • Delete: Bricht die Anzeigenentscheidung für eine zuvor erstellte AdBreak-Einheit ab.

Lebenszyklus von Werbeunterbrechungen

Eine AdBreak-Einheit kann die folgenden Status haben:

  • BREAK_STATE_UNSPECIFIED: Der Standardstatus.
  • BREAK_STATE_SCHEDULED: Die Werbeunterbrechung wurde erstellt und für die Anzeigenentscheidung geplant.
  • BREAK_STATE_DECISIONED: Die DAI-Dienste haben mit der Auswahl von Anzeigen für die Werbeunterbrechung begonnen. Sie können die Werbeunterbrechung nicht ändern, aber weiterhin abbrechen. Das kann sich jedoch negativ auf die Ad-Server auswirken.
  • BREAK_STATE_COMPLETE: Die Werbeunterbrechung wurde Nutzern ausgeliefert.

Das folgende Diagramm zeigt den Zeitablauf eines AdBreak-Objekts von der Erstellung bis zum Abschluss.

Werbeunterbrechung von der Erstellung bis zum Abschluss.

Sie können eine AdBreak-Entität 1 bis 300 Minuten vor dem erwarteten Beginn der Werbeunterbrechung erstellen.

  • Erstelle keine Werbeunterbrechung weniger als eine Minute vor dem erwarteten Beginn der Unterbrechung. Google DAI hat dann möglicherweise nicht genügend Zeit für die Anzeigenauswahl, was zu einer niedrigeren Anzeigenauslieferungsrate führt.
  • Erstellen Sie eine Werbeunterbrechung nicht mehr als 6 Stunden vor dem erwarteten Beginn, da Ad-Server die angeforderten Anzeigen sonst möglicherweise ungültig machen.

In den folgenden Abschnitten werden die Statusübergänge für Werbeunterbrechungen bei der dynamischen Anzeigenbereitstellung mit Full Service und bei der Pod-Auslieferung beschrieben.

Workflow für die dynamische Anzeigenbereitstellung mit Komplettservice

Bei der dynamischen Anzeigenbereitstellung mit Full-Service-Lösung von Google werden sowohl das Contentmanifest als auch die Anzeigen-Pods verwaltet.

Für das benutzerdefinierte Anzeigen-Targeting verwenden Sie die DAI Ad Break API, um vor der entsprechenden Anzeigenmarkierung im Manifest des Content-Livestreams eine AdBreak-Entität zu erstellen.

  • Durch diese Vorlaufzeit können die Google DAI-Dienste Ihre AdBreak-Daten für die Anzeigenentscheidung verwenden.
  • Wenn Google DAI die Manifest-Anzeigenmarkierung erkennt, verwendet das System Anzeigenentscheidungen mit den AdBreak-Entitätsdaten und ändert den Status der Entität in BREAK_STATE_COMPLETE.

Werbeunterbrechungsentität von der Erstellung bis zum Abschluss im Komplettservice-DAI-Ablauf.

Ablauf der Pod-Bereitstellung

In diesem Ablauf verwalten Sie das Manifest des Content-Livestreams oder verwenden einen Drittanbieterdienst zur Manifestbearbeitung, um die Anzeigenmarkierungen im Manifest zu erkennen.

Rufen Sie die DAI Ad Break API vor der erwarteten Startzeit der Werbeunterbrechung auf, um eine AdBreak-Entität zu erstellen, bevor Sie die Segmente des Anzeigen-Pods oder das Anzeigenmanifest anfordern müssen.

Wenn Ihr Video-Stitcher den Manifest-Anzeigenmarker erkennt und Anzeigensegmentanfragen mit einer Werbeunterbrechungs-ID stellt, verwendet Google DAI die AdBreak-Daten mit derselben ID für Anzeigenentscheidungen.

Nachdem Ihr Client Anzeigenmedien angefordert hat, wechselt die AdBreak-Einheit, die Sie über die API erstellt haben, in den Status BREAK_STATE_COMPLETE.

Status der Werbeunterbrechung.

Erste Anfrage senden

Informationen zum Einrichten des API-Zugriffs und zum Senden der ersten Anfrage finden Sie unter DAI-Werbeunterbrechungs-API verwenden.