Dzięki obsłudze reklam wideo kupujący mogą kupować zasoby reklamowe wideo za pomocą Authorized Buyers. Ten dokument przedstawia wymagania dotyczące integracji związane z kupowaniem przez RTB przy użyciu protokołu Authorized Buyers. Informacje o dostępnych protokołach znajdziesz w sekcji Wybierz protokół w przewodniku dla początkujących.
Kupujący mogą kupować zasoby reklamowe wideo w różnych miejscach docelowych. Obecnie są to reklamy In-Stream i pełnoekranowe. Więcej informacji znajdziesz w sekcji Reklamy pełnoekranowe.
Wymagania dotyczące kupujących
Nowi kupujący korzystający z RTB powinni opracowywać swoich licytujących, korzystając z najnowszego bufora protokołów i informacji podanych w kolejnych sekcjach. Aby go pobrać, otwórz stronę z danymi referencyjnymi dotyczącymi określania stawek w czasie rzeczywistym. Informacje na temat tworzenia licytującego znajdziesz w artykułach Przetwarzanie żądania i Tworzenie odpowiedzi.
Obsługiwane makra
Kreacje wideo typu In-Stream obsługują te makra:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Makra kliknięć (np. CLICK_URL_ESC
) nie są konieczne, ponieważ Authorized Buyers umieszcza tagi śledzenia kliknięć w kodzie VAST.
Dlatego w przypadku reklam wideo typu In-Stream makra kliknięć nie są obsługiwane.
Więcej informacji o obsługiwanych makrach znajdziesz w sekcji Określanie makr w sekcji Tworzenie odpowiedzi.
Szczegóły objaśnienia
Protokół określania stawek w czasie rzeczywistym używa wiadomości wideo zdefiniowanej w pliku proto.txt w czasie rzeczywistym do identyfikowania żądań reklam wideo i dostarczania o nich dodatkowych informacji dotyczących wideo.
Poniższa lista pól w zagnieżdżonej wiadomości wideo zawiera też szczegółowe opisy i przykłady:
description_url
-
Adres URL strony opisującej treść wideo z usuniętymi parametrami. Wydawca przesyła ten URL do Google. Na przykład:
http://www.publisher.com/watchpagelink
EndCapSupport
- Gdy ta opcja jest włączona, po zakończeniu jej odtwarzania można wybrać reklamę towarzyszącą, która będzie wyświetlana jako reklama końcowa (karta informacyjna) w boksie wideo.
END_CAP_NOT_ENABLED
Reklama towarzysząca nie jest renderowana jako reklama po zakończeniu filmu. END_CAP_OPTIONAL
Reklama po zakończeniu jest renderowana, jeśli odpowiedź zawiera odpowiedni 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 jest filtrowana. is_embedded_offsite
- Jeśli zasada ma wartość
true
, film jest umieszczony na stronach spoza domeny wydawcy. is_rewarded
- Jeśli ma wartość
true
, oznacza to, że użytkownik otrzymuje nagrodę za obejrzenie reklamy wideo. Typowymi nagrodami może być przeczytanie dodatkowego artykułu bezpłatnie, dodatkowe życie w grze lub sponsorowana sesja muzyczną bez reklam. max_ad_duration
-
Maksymalny dozwolony czas trwania zwracanej reklamy (w milisekundach). Jeśli zasada ma wartość
0
, maksymalny czas trwania nie jest ustawiony. max_ads_in_pod
- Maksymalna liczba reklam w bloku reklamowym wideo w Authorized Buyers. Wartość inna niż 0 oznacza, że bieżący boks reklamowy to blok reklamowy wideo, który może wyświetlać wiele reklam wideo. Rzeczywista liczba wyświetlonych reklam wideo może być mniejsza lub równa tej wartości, ale nie może być większa.
min_ad_duration
- Minimalny czas trwania zwracanych reklam (w milisekundach). Jeśli ta wartość nie jest ustawiona lub ma wartość mniejszą niż lub równą 0, minimalny czas trwania nie jest określony.
Placement
- Wskazuje, gdzie film będzie odtwarzany.
UNKNOWN_PLACEMENT
Miejsce docelowe jest nieznane lub nie można go określić. INSTREAM
In-Stream oznacza, że reklama wyświetla się przed innymi treściami wideo, w ich trakcie lub po nich. Przypomina to tradycyjną reklamę telewizyjną Oglądane przez użytkownika treści wideo nie są odtwarzane podczas odtwarzania reklamy. INTERSTITIAL
Reklama pełnoekranowa oznacza, że reklama wideo wyświetla się przed treściami innymi niż wideo (np. artykułem z wiadomościami lub grą wideo). Reklama zajmuje całe lub prawie całe miejsce na ekranie zajmowane przez treść, a użytkownik nie może przejść do treści do czasu zakończenia reklamy lub jej pominięcia. IN_FEED
Format reklamy wideo In-Feed to kreacja wideo, która wyświetla się, gdy użytkownik przewija kanał z treściami (zwykle kanał aplikacji społecznościowej, artykuł z wiadomościami itp.). Film wyświetla się w głównym kanale oraz w wizji i procesie czytania użytkownika. Film nie jest renderowany z boku, tak jak wideo banerowe. skippable_max_ad_duration
- Maksymalny czas trwania reklamy (w milisekundach), którą należy zwrócić, jeśli można ją pominąć. Zasadniczo różni się on od maksymalnego czasu trwania reklam niemożliwych do pominięcia. Jeśli to pole nie jest ustawione lub ma wartość mniejszą niż lub równą 0, dozwolony jest dowolny czas trwania.
VideoPlaybackMethod
- Informacje o tym, jak odtworzyć reklamę wideo.
Metoda odtwarzania jest określana jako automatyczne odtwarzanie 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
co oznacza, że reklama nie jest odtwarzana, dopóki nie zostanie kliknięta. video_ad_skippable
- Jest to wartość
SkippableBidRequestType
, która zawiera jedną z tych wartości:ALLOW_SKIPPABLE
oznacza, że dozwolone są zarówno reklamy możliwe, jak i niemożliwe do pominięcia. REQUIRE_SKIPPABLE
co oznacza, że zwracane są tylko reklamy możliwe do pominięcia. BLOCK_SKIPPABLE
co oznacza, że zwracane są tylko reklamy niemożliwe do pominięcia. Jeśli to pole nie jest skonfigurowane, domyślnym ustawieniem jest zezwalanie na reklamy możliwe do pominięcia.
videoad_start_delay
-
Wyrażony w milisekundach czas od rozpoczęcia filmu do momentu, w którym reklama została wyświetlona. 0 oznacza reklamę przed filmem, a -1 oznacza reklamę po filmie. Wszelkie inne wartości dodatnie wskazują, że boks znajduje się w środku filmu.
Wartość jest prawidłowa tylko wtedy, gdy ten parametr jest ustawiony. Jeśli jej nie skonfigurujesz, pozycja wyświetlania będzie nieznana.
Sygnały te nie są unikalne dla kreacji wideo, ale są szczególnie ważne dla systemów licytujących:
advertising_id
- To pole zawiera 16-bajtowy identyfikator UUID, który jest ustawiany tylko podczas korzystania z protokołu SSL.
Jest to niezaszyfrowana wersja
encrypted_advertising_id
. W przypadku urządzeń z iOS zawiera on identyfikator dla reklamodawców (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 wartość domyślna tego pola. HIGHEND_PHONE
obejmuje telefony komórkowe z funkcją wideo. TABLET
obejmuje tablety. PERSONAL_COMPUTER
obejmuje komputery stacjonarne i laptopy. CONNECTED_TV
obejmuje zarówno urządzenia CTV (czyli telewizory smart TV), jak i podłączone urządzenia (np. Roku, Apple TV itp.). GAME_CONSOLE
obejmuje dedykowane urządzenia do grania. brand
- Określa markę urządzenia (np. Nokia lub Samsung). To pole jest opcjonalne i domyślnie nie jest określone.
model
- Określa dokładny model urządzenia (np. N70 lub Galaxy). To pole jest opcjonalne i domyślnie nie jest określone.
screen_orientation
- Określa orientację urządzenia w momencie wysyłania żądania reklamy.
Prawidłowe wartości to
LANDSCAPE
,PORTRAIT
iUNKNOWN_ORIENTATION
. viewability
- Pozwala oszacować prawdopodobieństwo, że dany boks będzie widoczny dla użytkownika, na podstawie tego, jak często był on wyświetlany w przeszłości. Wyrażona jako wartość procentowa w zakresie od [0 do 100]. Wartość domyślna
-1
wskazuje, że historyczne dane o widoczności są niedostępne. content_attributes.duration_seconds
- Liczba sekund (np. 200) odtwarzania filmu.
Jest to zadeklarowane w komunikacie
ContentAttributes
. Wartość jest ustawiona na wartość podaną w metadanych wideo podanych przez wydawcę filmu.
Pytanie o stawkę za reklamy wideo zawiera też informacje o zasobach reklamowych, takie jak branża, dopuszczeni dostawcy i informacje o kanale. Wszystkie pozostałe pola w pytaniu o stawkę mają też zastosowanie do wideo.
Pola szerokości i wysokości w komunikacie AdSlot w żądaniu wideo odpowiadają rozmiarowi odtwarzacza reklam wideo.
allowed_vendor_type
- Dozwolony dostawca. Listę identyfikatorów znajdziesz w pliku vendors.txt w dokumentacji technicznej. Na przykład 309 = Jednostka wideo DFA.
allowed_video_formats
- Określa dozwolone technologie wideo, które mogą być wyświetlane w odpowiedzi na to żądanie.
Odpowiedź powinna wskazywać, że masz wsparcie dla co najmniej 1 z nich.
Wartości dla tego pola powtarzanego pochodzą z wyliczenia VideoFormat:
VIDEO_FLASH
Zezwala na wyświetlanie filmów w formacie Flash Video (FLV). VIDEO_HTML5
Zezwala na wyświetlanie filmów w formacie HTML5. VPAID_FLASH
Zezwala na wyświetlanie filmów w formacie wideo Flash zgodny z formatem VPAID (Video Player Ad-Serving Interface Definition). VPAID_JS
Zezwala na wyświetlanie filmów w formacie wideo VPAID JavaScript. companion_slot
- To pole odpowiada wiadomości CompanionSlot, która zawiera te pola:
height
Dostępne wysokości dla tego przedziału. width
Dostępne szerokości tego boksu. CreativeFormat
Format kreacji określa możliwe formaty kreacji w tym boksie towarzyszącym. url
-
Adres URL strony odtwarzania filmu lub strony, na której film został umieszczony. Na przykład:
http://www.publisher.com/watchpagelink
W odpowiedzi na żądanie wideo licytujący powinien zwrócić adres URL przekierowania VAST w polu video_url
.
Odpowiedź na stawkę powinna też zawierać
właściwą deklarację dotyczącą reklamy wideo.
Poniżej znajdziesz fragment poprawnej odpowiedzi na stawkę 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" }
Odpowiedzi na pytanie o stawkę wideo mają te ważne pola:
attribute
- Wszystkie atrybuty reklam, które mogą się wyświetlać z tego fragmentu. Listę identyfikatorów znajdziesz w pliku
Buyers-deklarable-creative-attributes.txt.
Sprawdzamy, czy żaden z tych atrybutów nie znajduje się na liście
excluded_attribute
w pytaniu o stawkę. Ustawiaj to pole tylko wtedy, gdy zwrócony zostanie fragment kodu HTML lub reklama wideo. Na przykład jeśli pole ma wartość30
, oznacza to, że do renderowania reklama wymaga obsługi VPAID. protocol
- Opisuje obsługiwane przez wydawcę wersje VAST w przypadku żądań reklam wideo, co umożliwia wyświetlanie reklam VAST maksymalnie w danej wersji.
Zawiera tablicę obsługiwanych protokołów reklam wideo.
Odpowiada to działaniu w OpenRTB 2.4 i odpowiada to działaniu.
Dostępne wartości:
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
iVAST_4_0_WRAPPER
. video_url
- Adres URL przekierowania VAST reklamy wideo. Przykład:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- Jak kupujący mogą uwzględnić reklamy wideo
- Zalecane sygnały OpenRTB dla wszystkich formatów wideo
- Zalecane sygnały protokołu Authorized Buyers w przypadku wszystkich formatów wideo
- Jak wydawcy mogą zezwalać na wyświetlanie reklam wideo lub je blokować
- Edge sprawy
Kierowanie wstępne
Aby otrzymywać zasoby reklamowe wideo, kupujący RTB muszą mieć konfigurację kierowania wstępnego dla RTB, która obejmuje zasoby reklamowe wideo.
Przykładowe pytania o stawkę i odpowiedzi
Formaty wideo AdX
Jak kupujący mogą uwzględnić reklamy wideo
W tabelach poniżej pokazujemy, w jaki sposób kupujący mogą uwzględniać wideo w swoich kreacjach i miejscach docelowych, w których mogą się wyświetlać odpowiednio w przypadku stron internetowych i aplikacji mobilnych.
Sieć
Kreacja wideo | In-Stream (wszystkie) | Reklamy In-Feed/artykuł | Reklamy natywne In-Feed/artykuł | Pełnoekranowa | Na banerze |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
Niestandardowy JS |
|
||||
Natywna + VAST |
|
Aplikacja mobilna
Kreacja wideo | In-Stream (wszystkie) | Reklamy In-Feed/artykuł | Reklamy natywne In-Feed/artykuł | Pełnoekranowa | Na banerze |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
Niestandardowy JS |
|||||
Natywna + VAST |
Klucz: | Format/technologia niedostępna | Kreacja wideo została zaakceptowana w tym miejscu docelowym (może zostać zablokowana przez wydawcę) |
Kreacja wideo jest niedostępna w tym miejscu docelowym |
---|
Zalecane sygnały OpenRTB
W tabelach poniżej znajdziesz zalecane sygnały OpenRTB dla wszystkich formatów wideo na potrzeby internetu na komputery i urządzenia mobilnego oraz aplikacji mobilnych.
Komputery i internet mobilny
Format filmu | Zalecane sygnały (tylko sygnały dotyczące filmów) | Powiązane sygnały (tylko w przypadku filmów) |
---|---|---|
In-Stream (VPAID) |
Istnieje obiekt VIDEO & |
|
In-Stream (bez VPAID) |
Istnieje obiekt VIDEO & |
|
Out-Stream |
Obiekt VIDEO jest dostępny
|
|
In-Feed |
Istnieje obiekt VIDEO & |
|
In-Article |
Istnieje obiekt VIDEO & |
|
Natywna |
Istnieje obiekt NATIVE i |
|
Na banerze |
Brak obiektu wideo |
Aplikacja mobilna
Format filmu | Szczegóły pytania o stawkę (tylko istotne informacje o filmie) | |
---|---|---|
In-Stream |
Istnieje obiekt VIDEO & |
|
Out-Stream |
Obiekt VIDEO jest dostępny
|
|
In-Feed |
Istnieje obiekt VIDEO & |
|
In-Article |
Istnieje obiekt VIDEO & |
|
Natywna |
Istnieje obiekt NATIVE i |
|
Reklama pełnoekranowa (VAST) |
Istnieje obiekt VIDEO & |
|
Reklama pełnoekranowa (bez VAST) |
Istnieje obiekt VIDEO & |
Filtrowane |
Na banerze (MRAID) |
Brak obiektu wideo |
|
Na banerze (brak MRAID) |
Brak obiektu wideo |
Zalecane sygnały proto w AdX
W tabelach poniżej znajdziesz zalecane sygnały protokołu Authorized Buyers w przypadku wszystkich formatów wideo na potrzeby internetu na komputery i urządzenia mobilnego oraz aplikacji mobilnych.
Witryny na komputery i internet mobilny
Format filmu | Polecane sygnały dotyczące filmu | Sygnały dotyczące podobnych filmów |
---|---|---|
In-Stream (VPAID) |
Obecna wiadomość VIDEO & |
|
In-Stream (bez VPAID) |
Obecna wiadomość VIDEO & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Feed |
Obecna wiadomość VIDEO & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Article |
Obecna wiadomość VIDEO & |
|
Natywna |
Wiadomość NATIVE znajduje się & |
|
Na banerze |
|
|
Aplikacja mobilna
W tabelach poniżej znajdziesz zalecane sygnały protokołu AdX w przypadku wszystkich formatów wideo na potrzeby internetu na komputery i urządzenia mobilnego oraz aplikacji mobilnej.
Format filmu | Szczegóły pytania o stawkę dotyczące filmu | Sygnały dotyczące filmów |
---|---|---|
In-Stream |
Widoczna wiadomość VIDEO |
|
In-Feed |
Obecna wiadomość VIDEO & |
|
In-Article |
Obecna wiadomość VIDEO oraz & |
|
Natywna |
Wiadomość NATIVE znajduje się & |
|
Pełnoekranowa |
Obecna wiadomość VIDEO & |
|
Na banerze (MRAID) |
|
|
Na banerze (brak MRAID) |
|
|
Jak wydawcy mogą zezwalać na reklamy wideo lub je blokować
W tabelach poniżej pokazujemy, w jaki sposób wydawcy mogą zezwalać na reklamy wideo w swoich miejscach docelowych lub ich blokować, a także jak wygląda to w pytaniach o stawkę dla OpenRTB i AdX Proto.
OpenRTB
Opcja pubu | Dostępne formaty | Opisowany w pytaniu o stawkę jako |
---|---|---|
Określanie jednostki reklamy wideo typu In-Stream |
In-Stream (wszystkie) |
Istnieje obiekt wideo |
Zaakceptuj VPAID |
Reklama In-Stream w witrynie |
Występuje obiekt wideo |
Włącz IBV |
Na banerze Pełnoekranowa |
|
Włącz reklamy Out-Stream (instructions). |
In-Feed In-Article |
Istnieje obiekt wideo |
Włącz reklamy Out-Stream (instructions). |
Natywna |
Istnieje obiekt natywny |
Blokuj pełnoekranowe reklamy wideo |
Aplikacja pełnoekranowa |
Brak obiektu VIDEO |
Proto AdX
Opcja pubu | Dostępne formaty | Opis jest opisany w pytaniu o stawkę jako (UWAGA: to WSZYSTKIE wskaźniki opcji wydawcy w pytaniu o stawkę – zalecane sygnały znajdziesz w tabeli poniżej). | Domyślne ustawienie |
---|---|---|---|
Określanie jednostki reklamy wideo typu In-Stream |
In-Stream (wszystkie) |
Zawiera wiadomość wideo |
Nie dotyczy |
Zaakceptuj VPAID |
Reklama In-Stream w witrynie |
Zawiera wiadomość wideo
|
Wyłączone |
Włącz IBV |
Na banerze Pełnoekranowa |
|
Wyłączone |
włączyć reklamy Out-Stream (instructions), |
In-Feed In-Article |
Zawiera wiadomość wideo |
Wyłączone |
włączyć reklamy Out-Stream (instructions), |
Natywna |
Zawiera wiadomość NATIVE &
|
Wyłączone |
Blokuj pełnoekranowe reklamy wideo |
Aplikacja pełnoekranowa |
Brak wiadomości VIDEO & |
Włączone |
Skrajne przypadki
# | Opis zgłoszenia | Komentarze | Pytanie o stawkę |
---|---|---|---|
1 |
Opóźnione niestandardowe zamknięcie (MRAID) |
W przypadku reklam pełnoekranowych zamknięcie reklamy może wysłać do kupującego powiadomienie za pomocą MRAID, nawet jeśli nie użył on niestandardowego zamknięcia. Zastosowana wartość X przez AdX zawsze wyświetla się nad każdym niestandardowym zamknięciem, nawet jeśli niestandardowe zamknięcie pojawi się pod spodem po 5 sekundach |
Glosariusz
Zobacz glosariusz wideo dotyczący Authorized Buyers.
Pola AdX i OpenRTB w formatach In-Stream i Out-Stream
Proto AdX
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
Proto OpenRTB
Zapoznaj się z sekcją OpenRTB 2.5 (od strony 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Wskazuje, czy wyświetlenie musi mieć charakter liniowy, nieliniowy itp. Jeśli nic nie jest określone, zakładaj, że wszystkie są dozwolone.
|
||||
videoad_start_delay
|
|
Źródło wartości pytania o stawkę
Obiekt OpenRTB | Pola | AdX /Giełda Ustalanie stawek Out-Stream |
Przykładowe wartości | Kto to określa? /Skąd ta wartość pochodzi ? |
---|---|---|---|---|
Obiekt | ||||
Wideo | Mimes | tak | ["application/javascript", "video/mp4"]", |
|
czas trwania | nie | Skonfigurowane przez wydawcę | ||
maxduration | tak | Skonfigurowane przez wydawcę | ||
playmet hod |
tak | [6] | Zwykle konfigurowany przez wydawcę |
|
api (MRAID) | tak | [1,2]. | ||
protokoły | tak | [2,3,5,6,7,8] | ||
liniowość | tak | [1] | ||
miejsce docelowe | tak | [1] | ||
szerokość odtwarzacza | tak | 400,400,300 | ||
wysokość odtwarzacza | tak | 225,300,153 | ||
opóźnienie rozpoczęcia | tak | 0 | Google, domyślnie 5 s | |
pomiń | tak | 1 | Wydawca/Google – dla reklamy pełnoekranowej => Google – dla reklam In-Stream => Wydawca decyduje, czy zezwolić na reklamy możliwe do pominięcia, niemożliwe do pominięcia lub z obu tych elementów. Reklamy z nagrodą, bez możliwości pominięcia; |
|
minimalna szybkość transmisji bitów | Nie | |||
maksymalna szybkość transmisji bitów | nie | |||
pos | tak | 1 | ||
Urządzenie | ||||
Współczynnik Px | tak | 1 | ||
wyświetlenie miniatury | ||||
Bezpieczne | tak | 1 | Google domyślnie stosuje wartość true , ponieważ tag adtag jest zawsze bezpieczny |