Ta strona została przetłumaczona przez Cloud Translation API.

Reklamy wideo z protokołem RTB Google

Po wprowadzeniu obsługi reklam wideo kupujący mogą kupować zasoby reklamowe wideo w Authorized Buyers. W tym dokumencie opisujemy wymagania związane z integracją zakupów przez RTB. za pomocą protokołu Authorized Buyers. Informacje na temat dostępnych protokołów znajdziesz w Wybierz protokół w przewodniku dla początkujących.

Kupujący mogą kupować zasoby reklamowe wideo w różnych miejscach docelowych, na reklamy In-Stream i pełnoekranowe. Zobacz o reklamach pełnoekranowych.

Wymagania dotyczące kupujących

Nowi kupujący, którzy korzystają z określania stawek w czasie rzeczywistym (RTB), powinni tworzyć licytujących, korzystając z najnowszego bufora protokołów oraz informacje opisane w kolejnych sekcjach. Aby pobrać protokół, wejdź na stronę z danymi referencyjnymi dotyczącymi określania stawek w czasie rzeczywistym. Aby dowiedzieć się, jak wybrać licytującego, Więcej informacji znajdziesz w sekcji Przetwarzanie żądania. i Budowanie reakcji.

Obsługiwane makra

W kreacjach wideo typu In-Stream obsługiwane są te makra:

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

Makra kliknięć (np. CLICK_URL_ESC) nie są potrzebne bo usługa Authorized Buyers umieszcza tagi śledzenia kliknięć w opakowaniu VAST. Dlatego makra kliknięć nie są obsługiwane w przypadku reklam wideo typu In-Stream. Więcej informacji o obsługiwanych makrach znajdziesz Więcej informacji znajdziesz w artykule o określaniu makr. w sekcji Budowanie odpowiedzi.

Szczegóły objaśnienia

Protokół określania stawek w czasie rzeczywistym używa komunikatu wideo zdefiniowanego w sekcji Real-time-bidding-proto.txt do identyfikowania żądań wideo. oraz podać dodatkowe informacje o żądaniu związane z filmem.

Poniższa lista pól w zagnieżdżonej wiadomości wideo udostępnia też szczegółowe opisy i przykłady:

description_url

Adres URL po usunięciu parametrów na stronie z opisem treści filmu. Wydawca przesyła ten adres URL do Google. Na przykład:

    http://www.publisher.com/watchpagelink

EndCapSupport

Po włączeniu tej opcji można wybrać reklamę towarzyszącą do renderowania w postaci reklamy po zakończeniu filmu (karta informacyjna) w boksie wideo. po zakończeniu odtwarzania reklamy wideo.

`END_CAP_NOT_ENABLED`	Reklama towarzysząca nie jest renderowana jako reklama po zakończeniu filmu.
`END_CAP_OPTIONAL`	Limit końcowy jest renderowany, jeśli odpowiedź zawiera kwalifikującą się wartość baner towarzyszący, ale nie jest on wymagany.
`END_CAP_FORBIDDEN`	Odpowiedź z reklamą towarzyszącą została odfiltrowana.
`END_CAP_REQUIRED`	Odpowiedź bez reklamy towarzyszącej zostaje odfiltrowana.

is_embedded_offsite

Jeśli ustawiono wartość true, film jest umieszczony na stronach spoza domeny wydawcy.

is_rewarded

Jeśli ma wartość true, użytkownik otrzymuje nagrodę za obejrzenie reklamy wideo. Typowe nagrody to czytanie dostaniecie bezpłatnie dodatkowe życie w grze czy sponsorowanej sesji muzycznej bez reklam.

max_ad_duration

Maksymalny dozwolony czas trwania zwróconej reklamy (w milisekundach). Jeśli ustawisz wartość 0, nie ma maksymalnego czasu trwania.

max_ads_in_pod

Maksymalna liczba reklam w bloku reklamowym wideo Authorized Buyers. Wartość inna niż 0 oznacza, że bieżący boks reklamowy jest blokiem wideo. które mogą wyświetlać wiele reklam wideo. Rzeczywista liczba wyświetlonych reklam wideo może być jest mniejsza lub równa tej wartości, ale nie może go przekroczyć.

min_ad_duration

Minimalny czas (w milisekundach) reklamy, która ma zostać zwrócona. Jeśli nie jest ustawiony lub ma wartość mniejszą lub równą 0, nie ma minimalnego czasu trwania.

Placement

Określa miejsce odtwarzania filmu.

`UNKNOWN_PLACEMENT`	Miejsce docelowe jest nieznane lub nie można określić.
`INSTREAM`	In-Stream oznacza, że reklama wyświetla się przed, w trakcie lub po innym treści wideo. Jest to podobne do tradycyjnej reklamy telewizyjnej. Treści wideo oglądane przez użytkownika nie są odtwarzane, reklama jest odtwarzana.
`INTERSTITIAL`	„Pełnoekranowe” oznacza, że reklama wideo jest odtwarzana przed treści innych niż filmy (np. artykuł prasowy lub gra wideo). Reklama zajmuje całe lub prawie całe miejsce na ekranie są zajęte przez treść i użytkownik nie może kontynuować do czasu zakończenia odtwarzania lub pominięcia reklamy.
`IN_FEED`	Format wideo In-Feed to kreacja wideo wyświetlana, gdy użytkownik to przewijanie kanału treści, zwykle kanału aplikacji społecznościowej, w artykule prasowym itp. Film jest renderowany w kanale głównym oraz płynności czytania i widzenia. Film nie wyświetla się z boku – np. wideo banerowego.

skippable_max_ad_duration

Maksymalny czas trwania reklamy (w milisekundach) który należy zwrócić, jeśli reklamę można pominąć. Zwykle różni się od maksymalnego czasu trwania są dozwolone w przypadku reklam niemożliwych do pominięcia. Jeśli to pole nie jest ustawione lub ma wartość mniejszą lub równą 0, dowolny dozwolony czas trwania.

VideoPlaybackMethod

Opis sposobu odtwarzania reklamy wideo. Wybraną metodą odtwarzania jest autoodtwarzanie lub „kliknij, aby odtworzyć” na podstawie najlepszych dostępnych pomiarów.

`AUTO_PLAY_SOUND_ON`	oznacza, że reklama odtwarza się automatycznie z włączonym dźwiękiem.
`AUTO_PLAY_SOUND_OFF`	oznacza, że reklama odtwarza się automatycznie z wyłączonym dźwiękiem.
`CLICK_TO_PLAY`	oznacza, że reklama nie jest odtwarzana, dopóki użytkownik jej nie kliknie.

video_ad_skippable

To jest wartość SkippableBidRequestType zawierające jedną z tych wartości:

`ALLOW_SKIPPABLE`	oznacza, że dozwolone są zarówno reklamy możliwe do pominięcia, jak i niemożliwe do pominięcia.
`REQUIRE_SKIPPABLE`	co oznacza, że mogą zostać zwrócone tylko te reklamy, które można pominąć.
`BLOCK_SKIPPABLE`	co oznacza, że mogą zostać zwrócone tylko reklamy niemożliwe do pominięcia.

Jeśli to pole nie jest skonfigurowane, domyślnie dozwolone jest wyświetlanie reklam możliwych do pominięcia.

videoad_start_delay

Czas w milisekundach od początku filmu do momentu wyświetlenia reklamy. 0 oznacza reklamę przed filmem, a -1 – reklamę po filmie. Wszystkie inne wartości dodatnie wskazują boks. jest w środku filmu.

Wartość jest prawidłowa tylko wtedy, gdy jest ustawiony ten parametr. Jeśli nie jest skonfigurowana, pozycja wyświetlania jest nieznana.

Te sygnały nie są unikalne dla kreacji wideo, , ale są szczególnie przydatne dla licytujących.

advertising_id

To pole jest 16-bajtowym identyfikatorem UUID ustawianym tylko podczas korzystania z protokołu SSL. Jest to niezaszyfrowana wersja usługi encrypted_advertising_id. W przypadku urządzeń z iOS zawiera identyfikator reklamowy IDFA. W przypadku urządzeń z Androidem zawiera identyfikator Androida (ADID). W przypadku urządzeń CTV zawiera ich unikalne identyfikatory (np. RIDA Roku).

device_type

Określa typ urządzenia.

`UNKNOWN_DEVICE`	to domyślna wartość tego pola.
`HIGHEND_PHONE`	obejmuje telefony komórkowe z funkcją wideo.
`TABLET`	obejmuje tablety.
`PERSONAL_COMPUTER`	obejmuje komputery stacjonarne i laptopy.
`CONNECTED_TV`	obejmuje oba urządzenia CTV (czyli telewizory smart TV). i połączonych urządzeń (takich jak Roku czy Apple TV).
`GAME_CONSOLE`	obejmuje specjalne urządzenia do grania.

brand

Określa markę (np. Nokia lub Samsung) urządzenia. To pole jest opcjonalne. domyślnie nie jest ono określone.

model

Określa dokładny model urządzenia (np. N70 lub Galaxy). To pole jest opcjonalne. domyślnie nie jest ono określone.

screen_orientation

Określa orientację urządzenia, gdy żądanie reklamy jest wysyłane. Prawidłowe wartości to LANDSCAPE, PORTRAIT, i UNKNOWN_ORIENTATION.

viewability

Zapewnia oszacowanie prawdopodobieństwa, że ten przedział będą widoczne dla użytkownika na podstawie tego, jak często były widoczne w przeszłości. Wyrażona jako procent w zakres [0, 100]. Wartość domyślna: -1. wskazuje, że historyczne dane o widoczności są niedostępne.

content_attributes.duration_seconds

Liczba sekund odtwarzania filmu (np. 200). Jest to deklarowane w komunikacie ContentAttributes. Tutaj ustawiana jest wartość określona w metadanych filmu. podane przez wydawcę.

Pytanie o stawkę za wideo zawiera też informacje o zasobach reklamowych. takie jak branża, dozwoleni dostawcy i informacje o kanałach. Wszystkie inne pola w pytaniu o stawkę mają zastosowanie do reklam wideo.

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

allowed_vendor_type

Dozwolony dostawca. Zobacz vendors.txt w dokumentacji technicznej, aby uzyskać listę identyfikatorów. Na przykład 309 = jednostka wideo DFA.

allowed_video_formats

Opis dozwolonych technologii wideo dla reklam wyświetlanych w odpowiedzi na to żądanie. Odpowiedź powinna wskazywać, że obsługuje ona co najmniej 1 z nich. Wartości dla tego pola powtarzanego pochodzą z wyliczenia VideoFormat:

`VIDEO_FLASH`	Zezwala na pliki wideo w formacie Flash Video (FLV).
`VIDEO_HTML5`	Zezwala na filmy w formacie wideo HTML5.
`VPAID_FLASH`	Zezwala na filmy przy użyciu wyświetlania reklam w odtwarzaczu wideo Format wideo Flash według standardu VPAID (Interface Definition).
`VPAID_JS`	Zezwala na filmy przy użyciu Format wideo JavaScript VPAID.

companion_slot

To pole reprezentuje wiadomość CompanionSlot który zawiera następujące pola:

`height`	Dostępne wysokości dla tego przedziału.
`width`	Dostępne szerokości tego boksu.
`CreativeFormat`	Format kreacji odzwierciedla możliwe formaty dla kreacji w tym boksie towarzyszącym.

url

URL strony odtwarzania filmu lub strony w których film jest umieszczony. Na przykład:

    http://www.publisher.com/watchpagelink

Gdy odpowiadasz na prośbę dotyczącą filmu, licytujący powinien zwrócić adres URL przekierowania VAST. w polu video_url. Odpowiedź na stawkę powinna też zawierać odpowiednią deklarację dotyczącą reklamy wideo. Poniżej znajduje się fragment prawidłowej odpowiedzi na stawkę za reklamę wideo:

protocol_version: 1
  ad {
    adslot {
      id: 1
      max_cpm_micros: 50000000
    }
    click_through_url: "http://google.com/"
    video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/
    B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml"
  }

Ważne pola odpowiedzi na stawkę wideo to:

attribute: Wszystkie atrybuty reklam, które mogą być wyświetlane z tego fragmentu. Zobacz Kupujący-declarable-creative-attributes.txt do listy identyfikatorów. Sprawdzamy, czy żaden z tych atrybutów nie znajduje się w Lista excluded_attribute pytania o stawkę. Ustaw to pole tylko po zwróceniu fragmentu kodu HTML lub zwrócenia reklamy wideo. Na przykład ustawienie tego pola na 30 wskazuje, reklama wymaga obsługi VPAID do renderowania.

Kreacja wideo	In-Stream (wszystkie)	In-Feed/artykuł	Natywne reklamy In-Feed/artykuł	Pełnoekranowa	Na banerze
VPAID + VAST
VAST
MRAID + JS
Niestandardowy JS
Natywna + VAST

Kreacja wideo	In-Stream (wszystkie)	In-Feed/artykuł	Natywne reklamy In-Feed/artykuł	Pełnoekranowa	Na banerze
VPAID + VAST
VAST
MRAID + JS
Niestandardowy JS
Natywna + VAST

Format filmu	Zalecane sygnały (tylko istotne sygnały dotyczące reklam wideo)	Powiązane sygnały (tylko istotne sygnały dotyczące reklam wideo)
In-Stream (VPAID)	Występuje obiekt VIDEO & `video.placement = INSTREAM &`
In-Stream (bez VPAID)	Występuje obiekt VIDEO & `video.placement = INSTREAM & video.api = 1 VPAID 1.0 or 2:VPAID 2.0`
Out-Stream	Występuje obiekt VIDEO `video.linearity: linear`, zależy od rzeczywistej wartości miejsce docelowe, wartości jak poniżej `Video.startdelay = 0`
In-Feed	Występuje obiekt VIDEO & `video.placement = IN-FEED`
In-Article	Występuje obiekt VIDEO & `video.placement = IN-ARTICLE`
Natywna	Obiekt NATIVE obecny i
Na banerze	Brak obiektu wideo & `banner.battr ≠ 6` wideo banerowego (odtwarzanie automatyczne) i `banner.battr ≠ 7` Wideo banerowe (zainicjowane przez użytkownika)

Format filmu	szczegóły pytania o stawkę (tylko istotne informacje o filmie).
In-Stream	Występuje obiekt VIDEO & `video.placement = INSTREAM &`	`video.api = 1` VPAID 1.0 lub `2`: VPAID 2.0
Out-Stream	Występuje obiekt VIDEO `video.linearity: linear`, zależy od rzeczywistej wartości miejsce docelowe, wartości jak poniżej `Video.startdelay = 0`
In-Feed	Występuje obiekt VIDEO & `video.placement = IN-FEED`
In-Article	Występuje obiekt VIDEO & `video.placement = IN-ARTICLE`
Natywna	Obiekt NATIVE obecny i
Reklama pełnoekranowa (VAST)	Występuje obiekt VIDEO & `video.placement = INTERSTITIAL`
Reklama pełnoekranowa (bez VAST)	Występuje obiekt VIDEO & `video.placement = INTERSTITIAL`	Odfiltrowany
Baner (MRAID)	Brak obiektu wideo & `banner.battr ≠ 6` wideo banerowego (odtwarzanie automatyczne) i `banner.battr ≠ 7` Wideo banerowe (zainicjowane przez użytkownika)
Na banerze (brak MRAID)	Brak obiektu wideo & `banner.battr ≠ 6` wideo banerowego (odtwarzanie automatyczne) i `banner.battr ≠ 7` Wideo banerowe (zainicjowane przez użytkownika)

Format filmu	Zalecane sygnały dotyczące filmu	Sygnały dotyczące podobnych filmów
In-Stream (VPAID)	Dostępna wiadomość FILM & `placement = INSTREAM & Allowed_video_formats = VPAID_JS`	`Allowed_video_formats = VIDEO_HTML5 Allowed_ad_types = VIDEO`
In-Stream (bez VPAID)	Dostępna wiadomość FILM & `placement = INSTREAM & Allowed_video_formats ≠ VPAID_JS`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-Feed	Dostępna wiadomość FILM & `placement = IN-FEED`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-Article	Dostępna wiadomość FILM & `placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Natywna	Zawiera wiadomość NATIVE & `VIDEO = 000x000` w wiadomości natywnej	`Allowed_ad_types = NATIVE`
Na banerze	`excluded_attribute ≠ 95` VideoType: reklama wideo banerowa (z możliwością blokowania przez wydawcę)	`Allowed_ad_types = BANNER`

Reklamy wideo z protokołem RTB Google

Wymagania dotyczące kupujących

Obsługiwane makra

Szczegóły objaśnienia

Kierowanie wstępne

Przykładowe pytania o stawkę i odpowiedzi

Formaty wideo AdX

Jak kupujący mogą dodać reklamy wideo

Przeglądarka

Zalecane sygnały OpenRTB

Komputery i internet mobilny

Aplikacja mobilna

Zalecane sygnały Proto AdX

Komputery i internet mobilny

Aplikacja mobilna

Jak wydawcy mogą zezwalać na treści wideo i blokować dostęp do nich

OpenRTB

AdX Proto,

Skrajne przypadki

Słowniczek

Pola AdX i OpenRTB w formatach In-Stream i Out-Stream

AdX Proto,

Proto OpenRTB

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

Format filmu	Szczegóły pytania o stawkę dotyczące filmu	Sygnały powiązane z filmem
In-Stream	Masz wiadomość VIDEO `placement = INSTREAM`	`Allowed_video_formats = VIDEO_HTML5 excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-Feed	Dostępna wiadomość FILM & `placement = IN-FEED`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-Article	Dostępna wiadomość FILM &`placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Natywna	Zawiera wiadomość NATIVE & `VIDEO = 000x000` w wiadomości natywnej	`Allowed_ad_types = NATIVE`
Pełnoekranowa	Dostępna wiadomość FILM & `placement = INTERSTITIAL &`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Baner (MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute ≠ 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`
Na banerze (brak MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute = 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`

Opcja Pub	Dostępne formaty	Opisana w pytaniu o stawkę jako
Określanie jednostki wideo typu In-Stream	In-Stream (wszystkie)	Występuje obiekt wideo & `video.placement = INSTREAM`
Włącz VPAID	Reklamy In-Stream w internecie	Występuje obiekt wideo & `video.api = 1` (VPAID 1.0) lub `2` (VPAID 2.0)
Włącz IBV	Na banerze Pełnoekranowa	`banner.battr ≠ 6` Wideo banerowe (odtwarzanie automatyczne) i/lub `7` Wideo banerowe (zainicjowane przez użytkownika)
Włącz reklamy Out-Stream (instrukcje).	In-Feed In-Article	Występuje obiekt wideo & `video.placement = IN-FEED` lub `IN-ARTICLE`
Włącz reklamy Out-Stream (instrukcje).	Natywna	Występuje obiekt natywny
Zablokuj pełnoekranową reklamę wideo	Aplikacja pełnoekranowa	Obiekt VIDEO nie jest dostępny

Opcja Pub	Dostępne formaty	Opisane w pytaniu o stawkę w taki sposób: (UWAGA: to WSZYSTKIE wskaźniki opcji wydawcy pytanie o stawkę – rekomendowane sygnały znajdziesz w tabeli poniżej)	Domyślne ustawienie
Określanie jednostki wideo typu In-Stream	In-Stream (wszystkie)	Obecna wiadomość wideo & `placement = INSTREAM`	nie dotyczy
Włącz VPAID	Reklamy In-Stream w internecie	Obecna wiadomość wideo & `Allowed_video_formats = VPAID_JS &` `excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid`	Wyłączone
Włącz IBV	Na banerze Pełnoekranowa	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)`	Wyłączone
Włącz reklamy Out-Stream (instrukcje).	In-Feed In-Article	Obecna wiadomość wideo & `Allowed_video_formats = VIDEO_HTML5 & placement = IN-FEED or IN-ARTICLE`	Wyłączone
Włącz reklamy Out-Stream (instrukcje).	Natywna	Obecna wiadomość NATIVE & `VIDEO = 000x000` w wiadomości natywnej	Wyłączone
Zablokuj pełnoekranową reklamę wideo	Aplikacja pełnoekranowa	Brak wiadomości VIDEO & `excluded_attribute = 30 InstreamVastVideoType: Vpaid`	Włączone

OpenRTB Obiekt	Pola	AdX /Giełda Określanie stawek Out-Stream	Przykładowe wartości	Kto decyduje o tym? /Skąd ta wartość pochodzi skąd?
Obiekt
Wideo	mimy	tak	["application/javascript", "wideo/mp4"]",	Google
	minimalny czas trwania	nie		Skonfigurowane przez wydawcę
	maxduration	tak		Skonfigurowane przez wydawcę
	odtwórz Hod	tak	[6]	Zwykle wydawca Skonfigurowano
	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ślne 5 s
	pomiń	tak	1	Wydawca/Google - w przypadku reklamy pełnoekranowej => Google – dla In-Stream => Wydawca decyduje, czy zezwolić na rozszerzenie możliwych do pominięcia, niemożliwych do pominięcia lub obu tych elementów. reklamy z nagrodą – zawsze bez możliwości pominięcia;
	minimalna szybkość transmisji bitów	Nie		Google
	maksymalna szybkość transmisji bitów	nie		Google
	pos	tak	1	Google
Urządzenie
	Współczynnik Px	tak	1	Google
wyświetlenie miniatury
	Bezpieczne	tak	1	Google wartość domyślna to prawda ponieważ adtag to zawsze bezpieczny