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
- Aplikacja implementująca wywołania interfejsu DAI API dla strumieni VOD. Więcej informacji znajdziesz w przewodniku po strumieniach VOD w interfejsie DAI API.
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ę.
|
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.