Weitere Informationen zur DAI Ad Break API

Mit der API für Werbeunterbrechungen bei der dynamischen Anzeigenbereitstellung können Sie das Timing und die Anzeigen-Targeting-Daten von anstehenden Werbeunterbrechungen in Ihren Livestreams erstellen und verwalten.

Mit der DAI Ad Break API können Sie Folgendes tun:

  • Anzeigenausführungsrate bei hohem Traffic verbessern: Geben Sie DAI-Diensten mehr Zeit, die Anzeigen mit den höchsten Erträgen für Ihre Live-Veranstaltungen auszuwählen. Wir empfehlen die DAI Ad Break API, wenn Ihre Livestream-Ereignisse eine hohe Gleichzeitigkeit, dynamische Anzeigen-Tags oder Anzeigen mit hoher Latenz haben.
  • Volle Kontrolle über Werbeunterbrechungen: Sie können Werbeunterbrechungen im Voraus erstellen, aktualisieren und löschen. Das bietet mehr Flexibilität als die Signalisierung von Anzeigen im Manifest und eine höhere Ausführungsrate für die Anzeigenbereitstellung im Vergleich zur Just-in-Time-Entscheidung.
  • Wiedergabe ohne Unterbrechungen: Durch die Bereitstellung präziser Informationen zu Werbeunterbrechungen lassen sich Wiedergabefehler im Zusammenhang mit Anzeigen minimieren, z. B. zu wenige oder zu viele Anzeigen-Pods.

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

Methoden der DAI Ad Break API kennenlernen

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

  • Create: Definiert eine neue AdBreak-Entität für eine LiveStreamEvent-Entität. Optional können Sie das Attribut expectedStartTime festlegen, um eine Anzeigenentscheidung so zu planen, dass sie innerhalb von 60 Sekunden vor Beginn der Werbeunterbrechung beginnt.
  • Get: Ruft die Details einer bestimmten AdBreak-Entität ab, einschließlich des Status der Werbeunterbrechung 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. Beachten Sie, dass die API keine Werbeunterbrechungen zurückgibt, 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-Entität ab.

Lebenszyklus von Werbeunterbrechungen

Eine AdBreak-Entität hat die folgenden Status:

  • 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 Anzeigenauswahl für die Werbeunterbrechung begonnen. Sie können die Werbeunterbrechung nicht ändern, aber abbrechen. Das kann sich jedoch negativ auf die Ad-Server auswirken.
  • BREAK_STATE_COMPLETE: Die Werbeunterbrechung wurde Nutzern präsentiert.
  • BREAK_STATE_EXPIRED: Die Werbeunterbrechung ist vor der Auslieferung abgelaufen. Gilt nur, wenn Sie die Planung mehrerer Werbeunterbrechungen für das Livestream-Ereignis aktivieren. Weitere Informationen findest du unter Einstellungen für Mid-Roll-Werbeunterbrechungen. Standardmäßig laufen Werbeunterbrechungen 30 Minuten nach dem Wert des Felds expectedStartTime ab oder 30 Minuten nach Beginn der Entscheidungsfindung, wenn Sie das Feld expectedStartTime nicht festlegen. Sie können diese Dauer mit dem Feld expireDuration anpassen.

Das folgende Diagramm zeigt die Zeitleiste einer AdBreak-Entität von der Erstellung bis zum Abschluss.

Werbeunterbrechungs-Entität von der Erstellung bis zum Abschluss.

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

  • Erstellen Sie eine Werbeunterbrechung nicht weniger als eine Minute vor dem erwarteten Beginn der Unterbrechung, da Google DAI möglicherweise nicht genügend Zeit für Anzeigenentscheidungen hat, was zu einer niedrigeren Anzeigenausführungsrate führt.
  • Erstellen Sie eine Werbeunterbrechung nicht mehr als 6 Stunden vor dem erwarteten Beginn der Unterbrechung, da Ad-Server die angeforderten Anzeigen möglicherweise für ungültig erklären.

In den folgenden Abschnitten werden die Zustandsübergänge von Werbeunterbrechungen in den Abläufen für die dynamische Anzeigenbereitstellung (Full Service) und die Pod-Auslieferung beschrieben.

Ablauf der dynamischen Anzeigenbereitstellung mit Komplettservice

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

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

  • Diese Vorlaufzeit ermöglicht es den Google DAI-Diensten, deine AdBreak-Daten für die Anzeigenentscheidung zu verwenden.
  • Wenn die dynamische Anzeigenbereitstellung von Google die Anzeigenmarkierung im Manifest erkennt, verwendet das System Anzeigenentscheidungen mit den Entitätsdaten AdBreak und ändert den Status der Entität in BREAK_STATE_COMPLETE.

Wenn Sie die Planung mehrerer Unterbrechungen für das Livestream-Ereignis aktivieren, können Sie das Feld matchParams für eine AdBreak-Entität festlegen. So kann die dynamische Anzeigenbereitstellung von Google erkannte Anzeigenmarkierungen im Manifest mit Werbeunterbrechungen im Status BREAK_STATE_SCHEDULED oder BREAK_STATE_DECISIONED abgleichen.

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

Pod-Bereitstellungsablauf

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

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

Wenn der Video-Stitcher die Anzeigenmarkierung im Manifest erkennt und Anfragen für Anzeigensegmente mit einer Werbeunterbrechungs-ID stellt, verwendet die dynamische Anzeigenbereitstellung von Google die AdBreak-Daten mit derselben ID für Anzeigenentscheidungen.

Nachdem Ihr Client Anzeigenmedien angefordert hat, wechselt die über die API erstellte AdBreak-Entität in den Status BREAK_STATE_COMPLETE.

Status „Abgeschlossen“ für die Werbeunterbrechung.

Erste Anfrage senden

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