Włączanie reklam możliwych do pominięcia w strumieniu VOD

Z tego przewodnika dowiesz się, jak za pomocą interfejsu DAI API poprosić o strumień VOD z reklamami, które można pominąć, wyświetlić przycisk pominięcia zgodnie z wymaganiami Google Ads i wysłać powiązane zdarzenia śledzenia.

Wymagania wstępne

Prześlij prośbę o możliwość wyświetlania reklam możliwych do pominięcia

Aby poprosić o strumień VOD z reklamami możliwymi do pominięcia, musisz przekazać parametr dai-sas w żądaniu 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 strumienia.
{VIDEO_ID} Identyfikator filmu strumienia.

Parametry ciała

dai-sas Ustaw wartość 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ć w ciele żądania kilka parametrów strumienia, użyj tego formatu:

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

Postępowanie z reklamami, które można pominąć

Aby obsługiwać pomijanie reklam, użyj informacji w strukturze Ad lub AdBreak, w zależności od tego, czy pomijasz bieżącą reklamę, czy całą przerwę na reklamę. Weź wartość start i dodaj wartość duration, a następnie przejdź do tego punktu w strumieniu. Submessage SkipMetadata zawiera też wartość offset, która określa czas w sekundach, po którym można pominąć reklamę. SubmessageSkipMetadata będzie uwzględniany tylko w reklamach możliwych do pominięcia.

ad_breaks lista przerw na reklamę,
start (liczba) Pozycja w strumieniu, w której zaczyna się przerwa (w sekundach).
duration (liczba) Czas trwania przerwy na reklamę (w sekundach).
ads (object(Ad)) Lista reklam w strumieniu.
start (liczba) – pozycja w strumieniu, w której rozpoczyna się reklama (w sekundach).
duration (liczba) Czas trwania reklamy w sekundach.
skip_metadata (object(SkipMetadata)) Opcjonalne metadane dotyczące reklam możliwych do pominięcia. Jeśli jest ustawiony, oznacza, że reklama jest możliwa do pominięcia i zawiera instrukcje dotyczące obsługi interfejsu pominięcia oraz zdarzenia śledzenia.
offset (liczba) Opóźnienie określa liczbę sekund, przez którą odtwarzacz powinien czekać na wyrenderowanie przycisku pominięcia. Pomiń, jeśli nie podano w pliku VAST.
tracking_url (string) Adres URL, pod który należy wysłać ping po zdarzeniu 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, prześlij ping do adresu URL zdarzenia pominięcia, który znajduje się w odpowiedzi na strumień. Jest ona zawarta w subwiadomości SkipMetadata.

Wymagania dotyczące przycisku pomijania

W przypadku reklam możliwych do pominięcia renderuj przycisk pominięcia zgodnie z tymi wymaganiami dotyczącymi projektu. Nieprzestrzeganie tych wymagań może spowodować ograniczenie wyświetlania reklam Google w Twojej witrynie lub aplikacji.

Samowyzwalacz

Reklama nie może być możliwa do pominięcia do czasu skipoffset określonego w szablonie VAST. W tym okresie użytkownik musi zobaczyć powiadomienie informujące, że reklamę można pominąć za X sekund. Ostrzeżenie musi być przetłumaczone na język użytkownika.

Położenie przycisku pominięcia

W przypadku języków czytanych od lewej do prawej umieść przycisk pomijania w prawym dolnym rogu odtwarzacza. W przypadku języków zapisywanych od prawej do lewej umieść przycisk pomijania po lewej stronie dołu odtwarzacza.

Rozmiar przycisku pominięcia

Przycisk i tekst muszą być na tyle duże, aby były wyraźnie widoczne w trybie lean-back.

Tekst i ikona

Przycisk pomijania musi zawierać zarówno tekst, jak i ikonografię. Jako ikonografię możesz użyć ikony przejścia do następnego materiału.

Ułatwienia dostępu

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

Internacjonalizacja

Zalecamy przetłumaczenie tekstu opcji pomijania na język użytkownika.

Bloki reklamowe

Za pomocą przycisku pomijania można pominąć bieżącą reklamę w bloku reklamowym lub cały blok.

Tłumaczenia przycisku „Pomiń reklamę”

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