Reklamy możliwe do pominięcia w strumieniu VOD

Z tego przewodnika dowiesz się, jak za pomocą interfejsu DAI API wysyłać żądania strumienia VOD z reklamami możliwymi do pominięcia, renderować przycisk pominięcia zgodnie z wymaganiami Google Ads i wysyłać powiązane zdarzenia śledzenia.

Wymagania wstępne

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

Aby wysłać żądanie strumienia VOD z reklamami możliwymi do pominięcia, musisz w żądaniu strumienia przekazać parametr dai-sas.

Punkt końcowy interfejsu 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 treści żądania, użyj tego formatu:

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

Obsługa pomijania reklam

Aby to zrobić, skorzystaj z informacji w strukturze Ad lub AdBreak 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ń strumień do tego momentu. Podkomunikat SkipMetadata zawiera też wartość offset, która jest wartością wyrażoną w sekundach, zanim reklamę można było pominąć. Podwiadomość SkipMetadata będzie się pojawiać tylko w reklamach, które można pominąć.

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 sekundach, w której rozpocznie się reklama w strumieniu.
duration (number) Czas trwania reklamy w sekundach.
skip_metadata (object(SkipMetadata)) Opcjonalne metadane reklam możliwych do pominięcia. Jeśli jest ustawiony, oznacza to, że reklamę można pominąć, i zawiera instrukcje obsługi interfejsu pominięcia i zdarzenia śledzenia.
offset (liczba) Przesunięcie wskazuje czas (w sekundach) odtwarzania reklamy, przez który odtwarzacz powinien czekać na wyrenderowanie przycisku pominięcia. Pomijany, jeśli nie został podany w VAST.
tracking_url (string) Adres URL, który powinien zostać pingowany w przypadku zdarzenia 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 zgodnie z tymi wymaganiami. Nieprzestrzeganie tych wymagań może spowodować nałożenie ograniczeń na reklamy Google wyświetlane w Twojej witrynie lub aplikacji.

Samowyzwalacz

Reklamę nie można pominąć przed upływem czasu skipoffset określonego w VAST. W tym okresie musisz wyświetlać użytkownikowi powiadomienie, że reklamę można pominąć w ciągu X s. Powiadomienie musi zostać przetłumaczone 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 odtwarzacza. W przypadku języka pisanego od prawej do lewej umieść przycisk pomijania w lewym dolnym rogu odtwarzacza.

Rozmiar przycisku pominięcia

Przycisk i tekst muszą być na tyle duże, aby były czytelne i wygodnie.

Tekst i ikona

Przycisk pomijania musi zawierać zarówno tekst, jak i ikonę. Jako ikony możesz użyć ikony pomiń następny materiał.

Ułatwienia dostępu

Użytkownik powinien mieć możliwość przejścia do przycisku pomijania za pomocą klawiatury lub pilota. Po zakończeniu odliczania aplikacja powinna skupić się na przycisku pominięcia.

Internacjonalizacja

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

Bloki reklamowe

Za jego pomocą możesz pominąć bieżącą reklamę w bloku reklamowym lub cały blok reklamowy.

Tłumaczenia typu „Pomiń reklamę”

Użyj pliku skipAdTranslations.json, by przetłumaczyć tekst „Pomiń reklamę” na podstawie języka użytkownika.