Reklamy możliwe do pominięcia w strumieniu VOD

Ten przewodnik pokazuje, jak za pomocą interfejsu DAI API zażądać strumienia VOD z z możliwością pominięcia, wyrenderuj przycisk pominięcia zgodnie z Wymagania Google Ads, i wysyłanie powiązanych zdarzeń śledzenia.

Wymagania wstępne

Wysyłanie żądania reklam możliwych do pominięcia

Aby poprosić o transmisję VOD z reklamami możliwymi do pominięcia, musisz przekazać dai-sas w tagu żądanie strumienia.

punkt końcowy API

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Parametry ścieżki

{CMS_ID} Identyfikator CMS transmisji.
{VIDEO_ID} Identyfikator filmu w strumieniu.

Parametry ciała

dai-sas Ustaw dai-sas=1, aby włączyć reklamy możliwe do pominięcia.

Przykładowe żądanie (cURL)

W przypadku żądań strumienia HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Zastąp 'dash' w adresie URL strumieni DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Aby uwzględnić wiele parametrów strumienia w żądaniu żądania, użyj poniższego formatu treść:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Obsługa pomijania reklam

Aby uniknąć pomijania reklam, skorzystaj z informacji podanych w tagu Ad struct lub AdBreak struct w zależności od tego, czy pomijasz bieżącą reklamę, czy całą przerwę na reklamę. Wybierz wartość start i dodaj wartość duration, a następnie przewiń do tego momentu w argumencie w transmisji na żywo. SkipMetadata podkomunikat także zawiera wartość offset, która jest wartością w sekund, od których można pominąć reklamę. Podkomunikat SkipMetadata będą uwzględniane tylko w reklamach możliwych do pominięcia.

ad_breaks Lista przerw na reklamę.
start (liczba) Pozycja w sekundach, w której rozpoczyna się przerwa w strumieniu.
duration (number) Czas trwania przerwy na reklamę w sekundach.
ads (object(Ad)) Lista reklam w strumieniu.
start (number) – pozycja w strumieniu, w której rozpoczyna się reklama, sek.
duration (number) Czas trwania reklamy w sekundach.
skip_metadata (object(SkipMetadata)) Opcjonalne metadane reklam możliwych do pominięcia reklam. Jeśli jest ustawione, oznacza to, że reklama można pominąć i zawiera ona jak obsługiwać UI pomijania i zdarzenia śledzenia.
offset (liczba) Przesunięcie wskazuje czas w sekundy, po której odtwarzacz powinien czekać na wyrenderowanie przycisk pominięcia. Pomijany, jeśli nie został podany w VAST.
tracking_url (ciąg znaków) Adres URL, który ma zostać wysłany poleceniem ping w przypadku pominięcia .

Przykładowa odpowiedź

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Gdy reklama zostanie pominięta, wyślij ping do adresu URL zdarzenia pominięcia podanego w odpowiedzi na żądanie strumienia. Jest on zawarty w podwiadomości (SkipMetadata).

Wymagania dotyczące przycisku pominięcia

W przypadku reklam możliwych do pominięcia wyrenderuj przycisk pominięcia w taki sposób . Nieprzestrzeganie tych wymagań może skutkować ograniczeniami umieszczane w reklamach Google wyświetlanych w witrynie lub aplikacji.

Samowyzwalacz

Reklamę nie można pominąć przed upływem czasu skipoffset określonego w VAST. W tym okresie, którego nie można pominąć, musisz wyświetlać użytkownikowi że reklamę można pominąć w X s. Powiadomienie musi zostać przetłumaczone na język na język użytkownika.

Pozycja przycisku pomijania

W przypadku języka pisanego od lewej do prawej umieść przycisk pominięcia w prawym dolnym rogu w odtwarzaczu wideo. W przypadku języka pisanego od prawej do lewej umieść przycisk pominięcia na w lewym dolnym rogu odtwarzacza.

Rozmiar przycisku pominięcia

Przycisk i tekst muszą być wystarczająco duże, aby były czytelne i pozycjonowane. z myślą o użytkownikach.

Tekst i ikona

Przycisk pomijania musi zawierać zarówno tekst, jak i ikonę. Za pomocą pomiń ikonę następnego materiału jako swoją ikonę.

Ułatwienia dostępu

Użytkownik powinien być w stanie przejść do przycisku pominięcia za pomocą klawiatury lub pilota. Aplikacja powinna wyświetlać przycisk pominięcia po zakończeniu odliczania. gotowe.

Internacjonalizacja

Zaleca się przetłumaczenie pominiętego tekstu na język użytkownika.

Bloki reklamowe

Za pomocą przycisku pominięcia możesz pominąć bieżącą reklamę w bloku reklamowym lub pominąć dla całego bloku reklamowego.

Pomiń reklamę tłumaczenia

Używaj plik skipAdTranslations.json za tłumaczenie tekstu „Pomiń reklamę” według regionu użytkownika.