Frühzeitige Benachrichtigungen zu Werbeunterbrechungen senden

Die dynamische Anzeigenbereitstellung von Google unterstützt Livestreams mit hoher Gleichzeitigkeit. Early Ad Break Notifications (EABN) sind Anfragen an Google DAI, eine anstehende Werbeunterbrechung zu planen oder sofort mit Anzeigenentscheidungen zu beginnen. So werden sowohl die Anzeigenauslieferungsrate als auch die Ladezeit optimiert.

Wenn du frühzeitige Benachrichtigungen zu Werbeunterbrechungen für den Vollservice, die Pod-Auslieferung oder die servergestützte Anzeigenbereitstellung aktivieren möchtest, verwende die Ressource AdBreaks. Mit dieser Ressource kannst du Werbeunterbrechungen für alle Livestreams erstellen und verwalten, die du über die Google Ad Manager-Benutzeroberfläche oder die Google Ad Manager SOAP API LiveStreamEventService erstellst.

Auf dieser Seite erfährst du, wie du eine Werbeunterbrechung als frühzeitige Benachrichtigung zur Werbeunterbrechung planst.

Vorbereitung

Zum Erstellen oder Verwalten von Werbeunterbrechungen benötigst du einen vom System generierten Asset-Schlüssel oder einen benutzerdefinierten Asset-Schlüssel für den Livestream. Du findest diese Schlüssel auch auf der Detailseite des Livestreams. Weitere Informationen findest du unter Livestream für die dynamische Anzeigenbereitstellung einrichten.

Werbeunterbrechung planen

Du kannst eine Werbeunterbrechung planen, wenn die Zuschauerzahl deines Streams steigt. Plane für jedes Livestream-Ereignis bis zu sechs Stunden im Voraus eine Werbeunterbrechung mit der Dienstmethode Create. Gib die voraussichtliche Startzeit und die ID der Werbeunterbrechung an. Bei der dynamischen Anzeigenbereitstellung werden Anzeigenentscheidungen kurz vor der geplanten Zeit getroffen. Bei sofortigen Entscheidungen zur Werbeunterbrechung kannst du den erwarteten Beginn der Werbeunterbrechung weglassen.

Wenn du möchtest, dass Google DAI sofort Anzeigenentscheidungen trifft, kannst du beim Aufrufen von Create die voraussichtliche Startzeit der Werbeunterbrechung weglassen.

Im folgenden Beispiel wird eine Werbeunterbrechung für ein Livestream-Ereignis vom Typ Linear geplant, das am 6. März 2025 um 16:00 Uhr (UTC) beginnt:

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

Bei Erfolg wird die folgende JSON-Antwort angezeigt:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Verwende die Methode List, um Werbeunterbrechungen abzufragen. Wenn du die Details einer Werbeunterbrechung prüfen möchtest, verwende die Methode Get.

Im folgenden Beispiel werden alle Werbeunterbrechungen für ein Livestream-Ereignis aufgelistet:

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

Bei Erfolg wird die folgende JSON-Antwort angezeigt:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Wenn du die aktuelle Werbeunterbrechung vorziehen möchtest, verwende die Methode Patch, um den voraussichtlichen Beginn zu ändern. Wenn du die aktuelle Werbeunterbrechung abbrechen möchtest, verwende die Methode Delete, bevor ihr Status COMPLETED ist.

Wenn du eine weitere Werbeunterbrechung erstellen möchtest, warte, bis der Status der aktuellen Werbeunterbrechung COMPLETED ist.