Wysyłanie wcześniejszych powiadomień o przerwie na reklamę

Dynamiczne wstawianie reklam Google (DAI) obsługuje transmisje na żywo o wysokiej współbieżności. Wczesne powiadomienia o przerwie na reklamę to żądania wysyłane do Google DAI w celu zaplanowania nadchodzącej przerwy na reklamę lub natychmiastowego podjęcia decyzji o wyświetleniu reklamy, co pozwala zoptymalizować zarówno współczynnik wypełnienia reklam, jak i czas wczytywania.

Aby rozpocząć wczesne powiadomienia o przerwie na reklamę w przypadku pełnej usługi, podwyświetlania lub wstawiania reklam za pomocą serwera, skorzystaj z zasobu AdBreaks. Ten zasób może tworzyć przerwy na reklamy i zarządzać nimi w przypadku wszystkich transmisji na żywo utworzonych za pomocą interfejsu Google Ad Managera lub interfejsu SOAP Google Ad Managera LiveStreamEventService.

Z tej strony dowiesz się, jak zaplanować przerwę na reklamę jako wcześniejsze powiadomienie o przerwie na reklamę.

Wymagania wstępne

Aby utworzyć przerwy na reklamę lub nimi zarządzać, musisz mieć klucz pliku wygenerowany przez system lub klucz pliku niestandardowego. Klucze te znajdziesz też na stronie z informacjami o transmisji na żywo. Zapoznaj się z artykułem Konfigurowanie transmisji na żywo na potrzeby dynamicznego wstawiania reklam, aby dowiedzieć się, jak skonfigurować transmisję na żywo w interfejsie Google Ad Managera.

Planowanie przerwy na reklamę

Możesz zaplanować przerwę na reklamę, gdy liczba widzów Twojego strumienia wzrośnie. W przypadku każdego wydarzenia transmitowanego na żywo zaplanuj pojedynczą przerwę na reklamę z co najmniej 6-godzinnym wyprzedzeniem, korzystając z metody Create usługi. Podaj przewidywany czas rozpoczęcia i identyfikator przerwy na reklamę. DAI podejmuje decyzje dotyczące reklam w pobliżu zaplanowanego czasu. W przypadku decyzji o natychmiastowej przerwie na reklamę pomiń spodziewany czas rozpoczęcia przerwy.

Aby Google DAI mógł podejmować decyzje dotyczące rozpoczęcia reklamy natychmiast, możesz pominąć oczekiwany czas rozpoczęcia przerwy na reklamy podczas wywołania funkcji Create.

W tym przykładzie planujemy przerwę na reklamę w przypadku wydarzenia typu Linear, które ma się rozpocząć 6 marca 2025 r. o 16:00 czasu uniwersalnego koordynowanego (UTC):

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"
});

Jeśli operacja się powiedzie, zobaczysz tę odpowiedź w formacie JSON:

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

Aby zapytać o przerwy na reklamy, użyj metody List. Aby sprawdzić szczegóły przerwy na reklamę, użyj metody Get.

W tym przykładzie wymieniono wszystkie przerwy na reklamy w przypadku transmisji na żywo:

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"
  }
);

Jeśli operacja się powiedzie, zobaczysz tę odpowiedź w formacie JSON:

{
  "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"
    }
  ]
}

Jeśli chcesz zmienić harmonogram obecnej przerwy na reklamy na wcześniejszy, użyj metody Patch, aby zmienić oczekiwany czas rozpoczęcia. Jeśli chcesz anulować bieżącą przerwę na reklamę, użyj metody Delete, zanim stan się COMPLETED.

Aby utworzyć kolejną przerwę na reklamę, poczekaj, aż stan bieżącej przerwy będzie wynosił COMPLETED.