Reklamy wideo

W tym przewodniku znajdziesz wymagania dotyczące integracji, konfiguracji i odpowiednich pól protokołu OpenRTB, których możesz używać podczas ustalania stawek za zasoby reklamowe wideo. Protokół Google RTB został wycofany i nie jest omawiany w tym przewodniku. Informacje o reklamach wideo w protokole Google RTB znajdziesz w przewodniku Reklamy wideo w Google RTB.

Google obsługuje reklamy wideo In-Stream, natywne i pełnoekranowe. Więcej informacji o formatach reklam natywnym i pełnoekranowym znajdziesz w odpowiednich przewodnikach.

Wymagania dotyczące kupującego

Protokół RTB

W tym przewodniku ogólnie odwołujemy się do formatu Protobuf, ale nazwy pól i ścieżki są takie same w formacie Protobuf i JSON, chyba że zaznaczono inaczej.

Protokół OpenRTB i specyficzne dla Google rozszerzenia OpenRTB znajdziesz na stronie Protokoły i dane referencyjne. Więcej informacji o tworzeniu licytatora znajdziesz w artykułach Przesyłanie żądania i Tworzenie odpowiedzi.

Sprawdzanie kreacji

Google zaleca, aby przed ustalaniem stawek przesłać kreacje do zatwierdzenia. Aby rozpocząć proces weryfikacji, możesz użyć zasobu Kreacje w interfejsie licytowania w czasie rzeczywistym.

Konfiguracja kierowania wstępnego

Aby otrzymywać zasoby reklamowe wideo, na koncie Authorized Buyers musisz utworzyć konfigurację kierowania wstępnego, która obejmuje zasoby reklamowe wideo.

Makra

Makra możesz określić w linku do adresu URL filmu lub w pliku XML VAST określonym w sekcji BidResponse.seatbid.bid.adm. Jeśli określisz adres URL filmu, możesz też umieścić w połączonym dokumencie XML VAST odpowiednie makro. W przypadku kreacji wideo obsługiwane są te makra:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Makra kliknięć, takie jak CLICK_URL_ESC, nie są obsługiwane, ponieważ Authorized Buyers umieszcza tagi śledzenia kliknięć w opakowaniu VAST. Więcej informacji o obsługiwanych makro znajdziesz w sekcji Określanie makro.

Szczegóły objaśnienia

Korzystając z pola BidRequest.imp.video w OpenRTB, możesz określić, czy przychodzące żądanie stawki dotyczy zasobów reklamowych typu In-Stream czy Interstitial, a także uzyskać dodatkowe informacje o żądaniu dotyczące konkretnego filmu. Dodatkowo w przypadku natywnych zasobów reklamowych możesz używać parametru BidRequest.imp.native.{request/request_native}.assets.video do uzyskiwania informacji o poszczególnych filmach.

BidRequest.{app/site}.content.producer.domain

Adres URL (bez parametrów) strony zawierającej opis filmu. Wydawca przesyła ten adres URL do Google. Na przykład:

http://www.publisher.com/watchpagelink
banner.vcm
Jeśli ustawisz wartość true, reklama towarzysząca może zostać wybrana do renderowania jako karta informacyjna w boksie reklamowym po zakończeniu odtwarzania reklamy wideo. W przeciwnym razie reklama towarzysząca nie jest renderowana jako reklama końcowa.
BidRequest.imp.rwdd
Jeśli wartość to true, oznacza to, że użytkownik otrzymuje nagrodę za obejrzenie reklamy wideo. Typowe nagrody to np. możliwość bezpłatnego przeczytania dodatkowego artykułu, otrzymanie dodatkowego życia w grze lub obejrzenie sponsorowanej sesji muzycznej bez reklam.
BidRequest.imp.video.maxduration

Maksymalny dozwolony czas trwania reklamy, którą należy zwrócić, w sekundach. Jeśli nie ustawisz maksymalnego czasu trwania, nie będzie ono obowiązywać. Gdy BidRequest.imp.video.skip to true, może to działać inaczej. Więcej informacji znajdziesz w artykule Maksymalny czas trwania reklamy wideo możliwej do pominięcia.

BidRequest.imp.video.maxseq

Maksymalna liczba reklam w bloku reklamowym wideo. Jeśli nie jest ustawiony, boks reklamowy nie jest częścią bloku reklamowego wideo.

Rzeczywista liczba wyświetlanych reklam wideo może być mniejsza lub równa tej wartości, ale nie może jej przekroczyć.

BidRequest.imp.video.minduration
Minimalny czas trwania reklamy w sekundach, który należy zwrócić. Jeśli ta opcja jest wyłączona, nie ma minimalnego czasu trwania.
BidRequest.imp.video.plcmt
Wskazuje, gdzie będzie odtwarzany film.
PLCMT_UNKNOWN Miejsce docelowe jest nieznane lub nieokreślone.
PLCMT_INSTREAM Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed strumieniem treści wideo zażądanym przez konsumenta, w trakcie jego odtwarzania lub po jego zakończeniu. Film In-Stream musi mieć domyślnie włączony dźwięk na początku odtwarzania lub wyraźnie wskazywać, że użytkownik chce obejrzeć treści wideo. Chociaż wokół odtwarzacza mogą znajdować się inne treści, użytkownik musi być zainteresowany filmem. powinny pozostać głównymi treściami na stronie i jedynym widocznym odtwarzaczem z włączonym dźwiękiem podczas odtwarzania; Jeśli odtwarzacz zmienia się w odtwarzacz pływający lub przyklejony, kolejne wywołania reklamy powinny prawidłowo przekazywać zaktualizowany rozmiar odtwarzacza.
PLCMT_ACCOMPANYING_CONTENT Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed strumieniem treści wideo, w trakcie jego odtwarzania lub po jego zakończeniu. Odtwarzacz wczytuje się i odtwarza przed akapitami tekstu lub treścią graficzną, pomiędzy nimi lub po nich i zaczyna odtwarzać dopiero wtedy, gdy wejdzie do widocznego obszaru. Treści towarzyszące powinny się odtwarzać dopiero po wyświetleniu ich w widocznym obszarze. Podczas przewijania może przekształcić się w odtwarzacz pływający lub przyklejony.
PLCMT_INTERSTITIAL reklamy wideo wyświetlane bez treści wideo; Podczas odtwarzania musi być głównym elementem strony i zajmować większość widocznego obszaru. Nie może być przewinięty poza widok. Mogą to być miejsca docelowe takie jak filmy w aplikacji lub pokazy slajdów.
PLCMT_NO_CONTENT_STANDALONE reklamy wideo odtwarzane bez strumieniowych treści wideo; Mogą to być takie miejsca docelowe jak slajdy, natywne kanały, treści lub elementy przyklejone/pływające.
BidRequest.imp.video.playbackmethod
Opis sposobu odtwarzania reklamy wideo. Metoda odtwarzania jest określana jako automatyczne odtwarzanie lub odtwarzanie po kliknięciu na podstawie najlepszego dostępnego pomiaru.
AUTO_PLAY_SOUND_ON Rozpoczyna się po załadowaniu strony z włączonym dźwiękiem.
AUTO_PLAY_SOUND_OFF Rozpoczyna się po załadowaniu strony z wyłączonym dźwiękiem.
CLICK_TO_PLAY Uruchamia się po kliknięciu z włączonym dźwiękiem.
MOUSE_OVER Rozpoczyna się po najechaniu kursorem na element z włączonym dźwiękiem.
ENTER_SOUND_ON Rozpoczyna się po wejściu do widoku z włączonym dźwiękiem.
ENTER_SOUND_OFF Domyślnie inicjuje się po wyświetleniu z wyłączonym dźwiękiem.
BidRequest.imp.video.skip
Jeśli wartość to true, oznacza to, że odtwarzacz umożliwia pominięcie filmu lub wyświetlanie reklam możliwych do pominięcia. W przeciwnym razie oznacza to, że reklamy możliwe do pominięcia są niedozwolone.
BidRequest.imp.video.startdelay

Wartość 0 oznacza reklamę przed filmem, -1 – reklamę w trakcie filmu, a -2 – reklamę po filmie.

Każda inna wartość dodatnia to czas w sekundach od początku filmu do momentu wyświetlenia reklamy.

Te sygnały nie są charakterystyczne tylko dla kreacji wideo, ale są szczególnie przydatne dla licytujących:

BidRequest.device.ifa
To pole to 36-znakowy identyfikator UUID, który jest ustawiany tylko w przypadku korzystania z protokołu SSL i nie jest szyfrowany. Jest to niezaszyfrowana wersja pliku BidRequest.device.dpidm5. W przypadku urządzeń z iOS zawiera identyfikator dla reklamodawców (IDFA) w wersji wielkich liter. W przypadku urządzeń z Androidem zawiera on identyfikator Androida (ADID) w wersji łacińskiej. W przypadku urządzeń CTV zawiera ich unikalne identyfikatory (np. RIDA Roku).
BidRequest.device.devicetype
Określa typ urządzenia.
MOBILE Wycofany alias dla HIGHEND_PHONE lub TABLET.
PERSONAL_COMPUTER Dotyczy to komputerów stacjonarnych i laptopów.
CONNECTED_TV obejmuje zarówno telewizory z internetem (czyli telewizory smart TV), jak i urządzenia z internetem (np. Roku, Apple TV itp.).
HIGHEND_PHONE Obejmuje zaawansowane telefony.
TABLET Obejmuje tablety.
CONNECTED_DEVICE Obejmuje dedykowane urządzenia do gier.
SET_TOP_BOX Obejmuje dekodery.
OOH_DEVICE Obejmuje urządzenia do reklamy zewnętrznej, takie jak cyfrowe billboardy.
BidRequest.device.make
Określa markę urządzenia (np. Nokia lub Samsung).
BidRequest.device.model
Określa dokładny model urządzenia (np. N70 lub Galaxy), jeśli jest dostępny. W przeciwnym razie zawiera model ogólny, np. „iPhone” lub „iPad”.
BidRequest.imp.metric
Jeśli parametr Metric.type ma wartość completion_rate, parametr Metric.value będzie miał postać ułamka w zakresie [0,0–1,0], reprezentującego historyczną wartość współczynnika obejrzenia reklam wideo wyświetlanych w boksie reklamowym. Wartość domyślna -1.0 wskazuje, że dane historyczne dotyczące współczynnika ukończenia są niedostępne.
BidRequest.imp.video.poddur
Długość w sekundach całej przerwy na reklamę, łącznie ze wszystkimi boksami reklamowymi, z których składa się blok reklamowy. Jest ona ustawiana na wartość określoną w metadanych filmu dostarczonych przez wydawcę filmu.

Pytanie o stawkę reklamy wideo zawiera też informacje o zasobach, takie jak branża, dozwoleni dostawcy i informacje o kanałach. Wszystkie inne istniejące pola w pytaniu o stawkę dotyczą też filmów.

Pola szerokość i wysokość w wiadomości AdSlot żądania wideo odpowiadają rozmiarowi odtwarzacza reklamy wideo.

BidRequest.imp.ext.allowed_vendor_type
Dozwoleni dostawcy. Lista identyfikatorów znajduje się w pliku vendors.txt w dokumentacji technicznej. Przykład: 309 = jednostka reklamowa DFA.
BidRequest.imp.video.mimes
Lista dozwolonych typów MIME treści reklam wyświetlanych w odpowiedzi na żądanie stawki, np. „video/mp4”. Odpowiedź na stawkę powinna wskazywać obsługę co najmniej 1 z nich.
BidRequest.imp.video.protocols
Opisuje obsługiwane przez wydawcę wersje VAST w przypadku żądań reklam wideo. Zawiera tablicę wartości enum Protocol, w tym: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER i inne.
BidRequest.imp.video.companionad
To pole zawiera tablicę obiektów Banner reprezentujących reklamy towarzyszące (jeśli są dostępne).
BidRequest.site.page

Adres URL strony odtwarzania filmu lub adres URL strony, na której został umieszczony film. Na przykład:

http://www.publisher.com/watchpagelink

W odpowiedzi na żądanie dotyczące filmu w polu BidResponse.seatbid.bid.adm licytujący powinien zwrócić URL przekierowania VAST lub kod XML VAST. Odpowiedź na pytanie o stawkę powinna też zawierać odpowiednią deklarację dotyczącą reklamy wideo. Poniżej znajduje się fragment prawidłowej odpowiedzi na pytanie o stawkę w przypadku reklamy wideo: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Ważne pola w odpowiedzi na stawkę za wyświetlenie filmu to:

BidResponse.seatbid.bid.ext.attribute
Atrybuty reklam, które mogą być wyświetlane z danego fragmentu. Listę identyfikatorów znajdziesz w pliku buyer-declarable-creative-attributes.txt. Sprawdzamy, czy żaden z tych atrybutów nie pasuje do atrybutów niedozwolonych przez wydawcę w pytaniu o stawkę. Jeśli na przykład w jednym z tych pól znajduje się wartość 30, oznacza to, że do wyświetlenia reklamy wymagana jest obsługa VPAID.
BidResponse.seatbid.bid.adm

W przypadku reklam wideo jest to adres URL przekierowania VAST reklamy wideo. Na przykład:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Może to być też nieprzetworzony kod XML VAST.

Przykładowe pytania o stawkę i ich odpowiedzi

Formaty filmów wideo

Jak kupujący mogą dodawać filmy

Poniższe tabele pokazują, jak kupujący mogą uwzględniać filmy w swoich kreacjach i w jakich miejscach docelowych w internecie i aplikacjach mobilnych mogą one być wyświetlane.

Sieć

Kreacja wideo In-Stream (wszystkie) In-Feed/Article Natywny element w kanałach/artykule Pełnoekranowa Na banerze

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

Niestandardowy kod JS

 

Natywna + VAST

 

Aplikacja mobilna

Kreacja wideo In-Stream (wszystkie) In-Feed/Article Natywny element w kanałach/artykule Pełnoekranowa Na banerze

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

Niestandardowy kod JS

Reklama natywna + VAST

Klucz: Format lub technologia niedostępne

Kreacja wideo zaakceptowana w tym miejscu docelowym, podlegająca blokadom przez wydawcę

Kreacja wideo jest niedostępna w przypadku tego miejsca docelowego

Zalecane sygnały OpenRTB

W poniższych tabelach znajdziesz zalecane sygnały OpenRTB dla wszystkich formatów wideo w internecie na komputery i mobilne oraz w aplikacjach mobilnych.

Komputery i internet mobilny

Format filmu zalecane sygnały (tylko sygnały związane z filmami); Powiązane sygnały (tylko sygnały dotyczące filmów)

In-Stream (VPAID)

Obiekt VIDEO jest obecny   &
video.placement = INSTREAM   &

In-Stream (bez VPAID)

Obiekt VIDEO jest obecny   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Reklamy inne niż In-Stream

Obecność obiektu VIDEO

video.linearity: linear
placement zależy od faktycznego
miejsca docelowego, wartości jak poniżej
Video.startdelay = 0

In-Feed

Obiekt VIDEO jest obecny   &
video.placement = IN-FEED

In-Article

Obiekt VIDEO jest obecny   &
video.placement = IN-ARTICLE

Natywna

Obiekt NATIVE jest obecny &

Na banerze

Brak obiektu wideo &
banner.battr ≠ 6 Wideo banerowe (autoodtwarzanie) &
banner.battr ≠ 7 Wideo banerowe (inicjowane przez użytkownika)

Aplikacja mobilna

Format filmu Szczegóły pytania o stawkę (tylko szczegóły dotyczące filmu)

In-Stream

Obiekt VIDEO jest obecny   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 lub 2: VPAID 2.0

Reklamy inne niż In-Stream

Obecność obiektu VIDEO

video.linearity: linear
placement zależy od faktycznego
miejsca docelowego, wartości jak poniżej
Video.startdelay = 0

In-Feed

Obiekt VIDEO jest obecny   &
video.placement = IN-FEED

In-Article

Obiekt VIDEO jest obecny   &
video.placement = IN-ARTICLE

Natywna

Obiekt NATIVE jest obecny &

Reklama pełnoekranowa (VAST)

Obiekt VIDEO jest obecny   &
video.placement = INTERSTITIAL

Reklama pełnoekranowa (bez VAST)

Obiekt VIDEO jest obecny   &
video.placement = INTERSTITIAL

Odfiltrowany

Na banerze (MRAID)

Brak obiektu wideo &
banner.battr ≠ 6 Wideo banerowe (autoodtwarzanie) &
banner.battr ≠ 7 Wideo banerowe (inicjowane przez użytkownika)

Na banerze

(brak MRAID)

Brak obiektu wideo &
banner.battr ≠ 6 Wideo banerowe (autoodtwarzanie) &
banner.battr ≠ 7 Wideo banerowe (inicjowane przez użytkownika)

Jak wydawcy mogą zezwalać na wyświetlanie filmów lub je blokować

W tabeli poniżej przedstawiamy sposoby, w jakie wydawcy mogą zezwalać na wyświetlanie reklam wideo w swoich miejscach docelowych lub je blokować.

Opcja pub Odpowiednie formaty Opisane w pytaniu o stawkę jako

Określanie jednostki reklamy wideo In-Stream

In-Stream (wszystkie)

Obiekt wideo jest obecny &
video.placement = INSTREAM

Wyrażenie zgody na VPAID

In-Stream w internecie

Obiekt wideo jest obecny &
video.api = 1 (VPAID 1.0) lub 2 (VPAID 2.0)

Dołączanie do IBV

Na banerze

Pełnoekranowa

banner.battr ≠ 6 Wideo banerowe (autoodtwarzanie) lub 7 Wideo banerowe (inicjowane przez użytkownika)

Wyraź zgodę na: (instrukcje)

In-Feed

In-Article

Obiekt wideo jest obecny &
video.placement = IN-FEED lub IN-ARTICLE

Włączanie reklam innych niż In-Stream (instrukcje)

Natywna

Obecność obiektu natywnego

Blokowanie reklam wideo w interstialach

Aplikacja pełnoekranowa

Brak obiektu VIDEO

Przypadki ekstremalne

# Opis zgłoszenia Komentarze Pytanie o stawkę

1

Opóźnione niestandardowe zamknięcie za pomocą MRAID

W przypadku reklam przejściowych zamknięcie reklamy może spowodować wysłanie powiadomienia do kupującego za pomocą MRAID, nawet jeśli nie został użyty niestandardowy sposób zamykania.


Znak X użyty w ramach Authorized Buyers będzie zawsze wyświetlany nad każdą niestandardową opcją zamknięcia, nawet jeśli opcja ta pojawi się poniżej po 5 sekundach

Słowniczek

Zapoznaj się z  glosariuszem filmów Authorized Buyers.

Odpowiednie pola w przypadku formatów In-Stream i Out-of-Stream

OpenRTB 2.5 (od strony 47)

BidRequest.Video.
Placement
In-Stream mWeb

1: In-Stream
2: In-Banner

mApp

1: In-Stream
2: In-Banner
Reklamy inne niż In-Stream mApp Interstitial

5: reklama pełnoekranowa

Native

3: In-Article
4: In-Feed

Rewarded

is_rewarded_inventory: wartość logiczna rozszerzenia OpenRTB
linearity

Określa, czy wyświetlenie musi być linearne, nielinearne itp. Jeśli nie ma żadnych specyfikacji, przyjmuje się, że wszystkie są dozwolone.

In-Stream mWeb

1: LINEAR (reklama In-Stream)

mApp

1: LINEAR (reklama In-Stream)
Reklamy inne niż In-Stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-Stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Reklamy inne niż In-Stream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Źródło wartości pytania o stawkę

Obiekt OpenRTB
Pola Authorized Buyers 
/Exchange 
Ustalanie stawek 
Bez przepływu		 Przykładowe wartości Kto to określa?
/Skąd pochodzi ta wartość
?
Obiekt
Wideo mimes tak ["application/javascript",
"video/mp4"]",		 Google
minduration nie Konfiguracja przez wydawcę
maxduration tak Konfiguracja przez wydawcę
playbackmet
hod		 tak [6] Zwykle wydawca
Skonfigurowano
interfejs API (MRAID) tak [1,2] Google
protokoły tak [2,3,5,6,7,8] Google
liniowość tak [1] Google
miejsce docelowe tak [1] Google
szerokość odtwarzacza tak 400,400,300 Google
wysokość odtwarzacza tak 225,300,153 Google
opóźnienie rozpoczęcia tak 0 Google, domyślnie 5 s
pomiń tak 1 Wydawca/Google
- w przypadku reklam intersticjalnych => Google
- w przypadku reklam in-stream => wydawca
decyduje, czy dopuścić
reklamy możliwe do pominięcia, niemożliwe do pominięcia lub oba rodzaje.
Reklamy z nagrodą, które nie mogą być pominięte;
minimalna szybkość transmisji bitów Nie Google
max bitrate nie Google
pos tak 1 Google
Urządzenie
Współczynnik pikseli tak 1 Google
wyświetlenie miniatury
Bezpieczne tak 1 Google
domyślnie ustawia wartość true
, ponieważ adtag jest zawsze
bezpieczny