Informationen zur DAI Ad Break API

Mit der Ad Break API für die dynamische Anzeigenbereitstellung (Dynamic Ads Insertion, DAI) können Sie das Timing und die Daten zur Anzeigenausrichtung für bevorstehende Werbeunterbrechungen in Ihren Livestreams erstellen und verwalten.

Mit der DAI Ad Break API haben Sie folgende Möglichkeiten:

• Anzeigenverfügbarkeit bei hohem Traffic verbessern: DAI-Diensten (Dynamic Ads Insertion, dynamische Anzeigenbereitstellung) 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 Nutzer, dynamische Anzeigen-Tags oder Anzeigen mit hoher Latenz aufweisen.
• 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 Auslieferungsrate für die Pod-Auslieferung im Vergleich zur Just-in-Time-Entscheidungsfindung.
• Unterbrechungsfreie Wiedergabe für Zuschauer: Minimieren Sie wiedergabebezogene Fehler im Zusammenhang mit Anzeigen, z. B. unvollständige oder überfüllte Anzeigenblöcke, indem Sie genaue Informationen zu Pausen bereitstellen.

In diesem Leitfaden werden die DAI Ad Break API-Methoden 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 stellt die folgenden Standardmethoden zum Verwalten von AdBreak-Ressourcen bereit:

• Create: Definiert eine neue AdBreak-Einheit für eine LiveStreamEvent-Einheit. Optional können Sie die Eigenschaft expectedStartTime festlegen, um eine Anzeigenentscheidung so zu planen, dass sie innerhalb von 60 Sekunden vor Beginn der Werbeunterbrechung startet.
• Get: Ruft die Details einer bestimmten AdBreak-Einheit ab, einschließlich des Status der Werbeunterbrechung und der Timing-Metadaten.
• List: Gibt eine Liste von AdBreak-Entitäten zurück, die zuvor mit der API für eine bestimmte LiveStreamEvent-Entität erstellt wurden. Die Liste ist in umgekehrter chronologischer Reihenfolge sortiert. 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 hat die folgenden Status:

• BREAK_STATE_UNSPECIFIED: Der Standardstatus.
• BREAK_STATE_SCHEDULED: Die Werbeunterbrechung wurde erstellt und für die Anzeigenauswahl 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 trotzdem abbrechen. Das kann sich jedoch negativ auf die Ad-Server auswirken.

Achtung :Wenn Sie eine Werbeunterbrechung während des Status BREAK_STATE_DECISIONED abbrechen, können Ad-Server die Anzeigen nicht ausliefern. Das kann sich negativ auf die Budgetierung und das Frequency Capping des Ad-Servers auswirken.

• BREAK_STATE_COMPLETE: Die Werbeunterbrechung wurde Nutzern präsentiert.

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

Sie können ein AdBreak-Objekt 1 bis 300 Minuten vor dem erwarteten Beginn der Werbeunterbrechung erstellen.

• Erstelle keine Werbeunterbrechung weniger als eine Minute vor dem erwarteten Startzeitpunkt, da Google DAI möglicherweise nicht genügend Zeit für Anzeigenentscheidungen hat. Dies kann zu einer niedrigeren Anzeigenverfügbarkeit führen.
• Erstelle eine Werbeunterbrechung nicht mehr als 6 Stunden vor dem erwarteten Beginn, da Ad-Server die angeforderten Anzeigen sonst möglicherweise ungültig machen.

Hinweis :Wenn du ein Livestream-Event deaktivierst, werden die Werbeunterbrechungen im Status BREAK_STATE_SCHEDULED oder BREAK_STATE_DECISIONED verworfen.

In den folgenden Abschnitten werden die Statusübergänge von Werbeunterbrechungen in DAI Full Service- und Pod Serving-Abläufen beschrieben.

Full-Service-DAI-Ablauf

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

Verwenden Sie für das benutzerdefinierte Targeting von Anzeigen 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.

Achtung :Wenn Google DAI die Manifest-Anzeigenmarkierung erkennt und die AdBreak-Einheit den Status BREAK_STATE_SCHEDULED hat, werden die AdBreak-Daten nicht vom System verwendet. Die AdBreak-Einheit bleibt im Status BREAK_STATE_SCHEDULED, bis Sie die Löschmethode aufrufen, um die Werbeunterbrechung zu beenden.

Ablauf der Pod-Bereitstellung

In diesem Ablauf verwalten Sie das Manifest für den Content-Livestream oder verwenden einen Drittanbieterdienst zur Manifestbearbeitung, um die Anzeigenmarker 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 Anfragen für Anzeigensegmente mit einer Pausen-ID sendet, 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.

Erste Anfrage senden

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