Ten przewodnik zawiera wymagania dotyczące integracji, konfigurację i odpowiednie pola, których możesz używać podczas składania ofert na zasoby reklamowe wideo.
Google obsługuje reklamy wideo In-Stream, natywne i pełnoekranowe, które są reprezentowane jako pojedyncze możliwości wyświetlenia reklamy lub dynamiczne bloki reklam wideo. Dynamiczne bloki reklamowe to grupy reklam wideo wyświetlanych w sekwencji, w których maksymalny czas trwania bloku jest dzielony na co najmniej 1 film o różnej długości. Więcej informacji o formatach reklam natywnych i pełnoekranowych znajdziesz w przewodnikach.
Wymagania kupującego
Protokół RTB
W tym przewodniku będziemy się odnosić do formatu Protobuf, ale nazwy pól i ścieżki są w nim i w formacie JSON równoważne, chyba że podano inaczej.
Protokół OpenRTB i rozszerzenia OpenRTB specyficzne dla Google znajdziesz na stronie Protokół i dane referencyjne. Więcej informacji o tworzeniu komponentu ustalającego stawki znajdziesz w sekcjach Przetwarzanie żądania i Tworzenie odpowiedzi.
Sprawdzanie kreacji
Zalecamy przesyłanie kreacji do zatwierdzenia przed rozpoczęciem ustalania stawek za ich wyświetlanie. Aby rozpocząć proces sprawdzania, możesz użyć zasobu Kreacje interfejsu Real-time Bidding API.
Konfigurowanie kierowania wstępnego
Aby otrzymywać zasoby reklamowe wideo, konto Authorized Buyers powinno utworzyć konfigurację kierowania wstępnego, która obejmuje zasoby reklamowe wideo.
Makra
Makra możesz określić w adresie URL filmu lub w pliku XML VAST określonym w zasadzie
BidResponse.seatbid.bid.adm
. Jeśli podasz adres URL filmu, możesz też umieścić makra w połączonym dokumencie XML VAST. W przypadku kreacji wideo obsługiwane są te makra:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Makra kliknięć, np. CLICK_URL_ESC
, nie są obsługiwane, ponieważ Authorized Buyers umieszcza swoje tagi śledzenia kliknięć w opakowaniu VAST. Więcej informacji o obsługiwanych makrach znajdziesz w artykule Określanie makr.
Szczegóły objaśnienia
Możesz użyć pola BidRequest.imp.video
w OpenRTB, aby określić, czy przychodzące żądanie stawki dotyczy zasobów reklamowych wideo In-Stream czy pełnoekranowych, oraz znaleźć dodatkowe informacje o żądaniu dotyczące wideo.
W przypadku zasobów reklamowych w reklamach natywnych możesz też używać parametru BidRequest.imp.native.{request/request_native}.assets.video
, aby uzyskać podobne informacje dotyczące filmów.
BidRequest.{app/site}.content.producer.domain
-
Adres URL strony, na której znajdują się informacje o treściach wideo (bez parametrów). Wydawca przesyła ten adres URL do Google. Na przykład:
http://www.publisher.com/watchpagelink
banner.vcm
-
Jeśli wartość jest ustawiona na
true
, reklama towarzysząca może zostać wybrana do wyświetlenia jako karta końcowa (karta informacyjna) w boksie na film po zakończeniu odtwarzania reklamy wideo. W przeciwnym razie reklama towarzysząca nie będzie renderowana jako zakończenie. BidRequest.imp.rwdd
- Jeśli wartość tego parametru to
true
, oznacza to, że użytkownik otrzymuje nagrodę za obejrzenie reklamy wideo. Typowe nagrody to np. możliwość przeczytania dodatkowego artykułu bezpłatnie, otrzymanie dodatkowego życia w grze lub dostęp do sponsorowanej sesji muzycznej bez reklam. BidRequest.imp.video.maxduration
-
Maksymalny dozwolony czas trwania (w sekundach) każdej reklamy uwzględnionej w odpowiedzi na ofertę. Jeśli nie ustawisz tego parametru, nie ma maksymalnego czasu trwania. Gdy
BidRequest.imp.video.skip
jesttrue
, może to działać inaczej. Więcej informacji znajdziesz w sekcji Maksymalny czas trwania reklamy wideo możliwej do pominięcia. BidRequest.imp.video.maxseq
-
Maksymalna liczba reklam, które mogą być wyświetlane w dynamicznym bloku reklamowym wideo. Jeśli parametr
poddur
jest ustawiony, ale parametrmaxseq
jest nieustawiony lub ma wartość0
, nie masz ograniczeń co do liczby reklam, które mogą być wyświetlane w bloku reklamowym wideo. Google obsługuje tylko dynamiczne pakiety reklam.Rzeczywista liczba wyświetlonych reklam wideo może być mniejsza lub równa tej wartości, ale nie może jej przekraczać.
BidRequest.imp.video.minduration
- Minimalny czas trwania w sekundach każdej reklamy uwzględnionej w odpowiedzi na stawkę. Jeśli nie jest ustawiony, nie ma minimalnego czasu trwania.
BidRequest.imp.video.plcmt
-
Określa, gdzie będzie odtwarzany film.
PLCMT_UNKNOWN
Miejsce docelowe jest nieznane lub nie można go określić. PLCMT_INSTREAM
Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed, w trakcie lub po przesyłanych strumieniowo treściach wideo, o które poprosił konsument. Reklama wideo In-Stream musi być domyślnie ustawiona na „dźwięk włączony” na początku odtwarzania lub musi być wyraźnie widoczny zamiar użytkownika, aby obejrzeć treści wideo. Wokół odtwarzacza mogą znajdować się inne treści, ale treści wideo muszą być celem wizyty użytkownika. Powinien on pozostać główną treścią na stronie i jedynym widocznym odtwarzaczem wideo, który może odtwarzać dźwięk. Jeśli odtwarzacz zmieni się w pływający lub przyklejony, kolejne wywołania reklamy powinny dokładnie odzwierciedlać zaktualizowany rozmiar odtwarzacza. PLCMT_ACCOMPANYING_CONTENT
Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed przesyłaną strumieniowo treścią wideo, w jej trakcie lub po niej. Odtwarzacz wideo wczytuje się i odtwarza przed akapitami tekstu lub treści graficznych, między nimi lub po nich. Odtwarzanie rozpoczyna się dopiero po wejściu odtwarzacza w obszar widoczny. Treści towarzyszące powinny rozpocząć odtwarzanie dopiero po wejściu w widoczny obszar. Podczas przewijania strony może się przekształcić w pływający lub przyklejony odtwarzacz. 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żna jej przewinąć poza widoczny obszar. Może to być w miejscach docelowych, takich jak reklamy wideo w aplikacjach czy pokazy slajdów. PLCMT_NO_CONTENT_STANDALONE
reklamy wideo odtwarzane bez strumieniowych treści wideo; Mogą one być umieszczane w takich miejscach jak pokazy slajdów, źródła natywne, treści lub elementy przyklejone/pływające. BidRequest.imp.video.playbackmethod
-
Opisuje sposób odtwarzania reklamy wideo.
Metoda odtwarzania jest określana jako odtwarzanie automatyczne lub odtwarzanie po kliknięciu na podstawie najlepszych dostępnych pomiarów.
AUTO_PLAY_SOUND_ON
Rozpoczyna się po wczytaniu 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
Rozpoczyna się po kliknięciu z włączonym dźwiękiem. MOUSE_OVER
Rozpoczyna się po najechaniu kursorem myszy z włączonym dźwiękiem. ENTER_SOUND_ON
Rozpoczyna się po wejściu w obszar widoczny z włączonym dźwiękiem. ENTER_SOUND_OFF
Rozpoczyna się po wyświetleniu reklamy, gdy dźwięk jest domyślnie wyłączony. BidRequest.imp.video.skip
- Jeśli
true
, oznacza to, że odtwarzacz zezwala na pominięcie filmu lub że dozwolone są reklamy z możliwością 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.
BidRequest.imp.video.durfloors
iBidRequest.imp.audio.durfloors
-
Tablica obiektów
DurFloors
wskazujących odpowiednie ceny minimalne kreacji wideo lub audio o różnym czasie trwania, za które kupujący może składać oferty.Oto przykład, jak wyglądałby
durfloors
określony przez Google:{"maxdur": 16, "bidfloor": 5}
, co oznacza(0, 16)
sekund przy$5
.{"mindur": 16, "maxdur": 31, "bidfloor": 10}
reprezentuje[16, 31)
sekund przy$10
.{"mindur": 31, "bidfloor": 20}
, co oznacza[31, inf)
sekund przy$20
.
Te sygnały nie są unikalne dla kreacji wideo, ale są szczególnie przydatne dla licytujących:
BidRequest.device.ifa
- To pole zawiera 36-znakowy identyfikator UUID, który jest ustawiany tylko w przypadku korzystania z protokołu SSL i nie jest haszowany. Jest to niezaszyfrowana wersja
BidRequest.device.dpidm5
. W przypadku urządzeń z iOS zawiera identyfikator dla reklamodawców (IDFA) zapisany wielkimi literami. W przypadku urządzeń z Androidem zawiera identyfikator Androida (ADID) zapisany małymi literami. W przypadku urządzeń Connected TV zawiera ich unikalne identyfikatory (np. RIDA Roku). BidRequest.device.devicetype
- Określa typ urządzenia.
MOBILE
Przestarzały alias dla HIGHEND_PHONE lub TABLET. PERSONAL_COMPUTER
Obejmuje komputery stacjonarne i laptopy. CONNECTED_TV
obejmuje zarówno telewizory podłączone do internetu (czyli telewizory smart TV), jak i urządzenia podłączone do internetu (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 reklamowe zewnętrzne, np. 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 ogólny model, np. „iphone” lub „ipad”.
BidRequest.imp.metric
-
Gdy parametr
Metric.type
ma wartośćcompletion_rate
,Metric.value
będzie ułamkiem z zakresu [0,0, 1,0] reprezentującym historyczny współczynnik ukończenia reklam wideo wyświetlanych w boksie reklamowym. Wartość domyślna-1.0
oznacza, że dane historyczne dotyczące współczynnika ukończenia są niedostępne. BidRequest.imp.video.poddur
- Czas (w sekundach), w którym możesz wypełnić dynamiczny blok reklam wideo. To pole odnosi się do długości całej przerwy na reklamy. Jeśli nie jest ustawiony, boks reklamowy nie jest częścią bloku.
Żądanie stawki za reklamę wideo zawiera też informacje o zasobach reklamowych, takie jak kategoria, dozwoleni dostawcy i informacje o kanale. Wszystkie inne pola w pytaniu o stawkę mają też zastosowanie w przypadku filmów.
Pola szerokości i wysokości w wiadomości AdSlot w żądaniu wideo odpowiadają rozmiarowi odtwarzacza reklam wideo.
BidRequest.imp.ext.allowed_vendor_type
- Dozwoleni dostawcy. Listę identyfikatorów znajdziesz w pliku vendors.txt w dokumentacji technicznej. Na przykład 309 = jednostka wideo DFA.
BidRequest.imp.video.mimes
- Lista dozwolonych typów MIME treści obsługiwanych w przypadku reklam wyświetlanych w odpowiedzi na żądanie stawki, np. „video/mp4”. Odpowiedź na pytanie o stawkę powinna wskazywać obsługę co najmniej jednego z nich.
BidRequest.imp.video.protocols
-
Opisuje obsługiwane przez wydawcę wersje VAST w przypadku żądań reklam wideo.
Zawiera tablicę wartości wyliczenia
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 film został umieszczony. Na przykład:
http://www.publisher.com/watchpagelink
W odpowiedzi na żądanie reklamy wideo uczestnik aukcji powinien zwrócić URL przekierowania VAST lub kod XML VAST w polu BidResponse.seatbid.bid.adm
. Odpowiedź na pytanie o stawkę powinna też zawierać odpowiednią deklarację dotyczącą reklamy wideo. Poniżej znajdziesz fragment prawidłowej odpowiedzi na pytanie o stawkę za film:
id: "n40G42d551UX18627ao8lt" seatbid { bid { id: "17u6BnD62h88r5q7066" impid: "1" price: 0.797848 adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" crid: "test_creative_id_987914" w: 320 h: 480 cattax: GOOGLE_CATEGORIES [com.google.doubleclick.bid] { attribute: 47 attribute: 50 billing_id: 55383762512 skadn { version: "4.0" network: "306el65O" itunesitem: "832461214" sourceapp: "977150768" fidelities { fidelity: VIEW_THROUGH_ADS nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565" timestamp: "1757329316673" signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7" } fidelities { fidelity: STOREKIT_RENDERED_ADS nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565" timestamp: "1757329316673" signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b" } sourceidentifier: "8396" } app_promotion_type: INSTALLS clickurl: "google.com" } } } [com.google.doubleclick.bid_response] { processing_time_ms: 20 }
Ważne pola w odpowiedzi na stawkę za film 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 jest zgodny z atrybutami niedozwolonymi przez wydawcę w pytaniu o stawkę.
Jeśli na przykład w którymś z tych pól znajduje się znak
30
, oznacza to, że reklama wymaga obsługi VPAID, aby można było ją wyświetlić. 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 odpowiedzi
Formaty filmów wideo
- Jak kupujący mogą uwzględniać filmy
- Zalecane sygnały OpenRTB dla wszystkich formatów wideo
- Zalecane sygnały protokołu Authorized Buyers dla wszystkich formatów wideo
- Jak wydawcy mogą zezwalać na wyświetlanie filmów i im zapobiegać
- Przypadki ekstremalne
Jak kupujący mogą dodawać filmy
W tabelach poniżej przedstawiamy sposoby, w jakie kupujący mogą umieszczać wideo w swoich kreacjach, oraz miejsca docelowe, w których mogą się one wyświetlać w internecie i aplikacjach mobilnych.
Sieć
Kreacja wideo | In-Stream (wszystkie) | In-Feed/In-Article | Reklamy natywne In-Feed lub In-Article | Pełnoekranowa | Na banerze |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
Niestandardowy kod JS |
|
||||
Reklama natywna + VAST |
|
Aplikacja mobilna
Kreacja wideo | In-Stream (wszystkie) | In-Feed/In-Article | Reklamy natywne In-Feed lub In-Article | 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, z zastrzeżeniem blokad wydawcy |
Kreacja wideo jest niedostępna w tym miejscu docelowym |
---|
Zalecane sygnały OpenRTB
W tabelach poniżej przedstawiamy zalecane sygnały OpenRTB dla wszystkich formatów wideo w przypadku internetu na komputerach i urządzeniach mobilnych oraz aplikacji mobilnych.
Komputery i internet mobilny
Format filmu | Sygnały rekomendowane (tylko sygnały związane z filmem) | Powiązane sygnały (tylko sygnały związane z filmem) |
---|---|---|
Instream (VPAID) |
Obiekt VIDEO jest obecny & |
|
Instream (bez VPAID) |
Obiekt VIDEO jest obecny & |
|
Inne niż In-Stream |
Obiekt VIDEO jest obecny
|
|
In-Feed |
Obiekt VIDEO jest obecny & |
|
In-Article |
Obiekt VIDEO jest obecny & |
|
Natywna |
Obiekt NATIVE jest obecny i |
|
Na banerze |
Obiekt wideo nie występuje & |
Aplikacja mobilna
Format filmu | Szczegóły pytania o stawkę (tylko informacje dotyczące filmu) | |
---|---|---|
In-Stream |
Obiekt VIDEO jest obecny & |
|
Inne niż In-Stream |
Obiekt VIDEO jest obecny
|
|
In-Feed |
Obiekt VIDEO jest obecny & |
|
In-Article |
Obiekt VIDEO jest obecny & |
|
Natywna |
Obiekt NATIVE jest obecny i |
|
Reklama pełnoekranowa (VAST) |
Obiekt VIDEO jest obecny & |
|
Reklama pełnoekranowa (bez VAST) |
Obiekt VIDEO jest obecny & |
Odfiltrowany |
W banerze (MRAID) |
Obiekt wideo nie występuje & |
|
Na banerze (bez MRAID) |
Obiekt wideo nie występuje & |
Jak wydawcy mogą zezwalać na wyświetlanie filmów i im zapobiegać
W tabeli poniżej przedstawiamy sposoby, w jakie wydawcy mogą zezwalać na wyświetlanie reklam wideo w swoich miejscach docelowych lub je blokować.
Opcja wydawcy | Odpowiednie formaty | Opis w pytaniu o stawkę |
---|---|---|
Określanie jednostki reklamy wideo In-Stream |
In-Stream (wszystkie) |
Obiekt wideo jest obecny |
Wyrażanie zgody na VPAID |
In-Stream w internecie |
Obiekt wideo jest obecny i |
Włączanie weryfikacji tożsamości |
Na banerze Pełnoekranowa |
|
Wyraź zgodę na (instrukcje) |
In-Feed In-Article |
Obiekt wideo jest obecny |
Wyrażanie zgody na reklamy inne niż In-Stream (instrukcje) |
Natywna |
Obiekt natywny jest obecny |
Blokowanie pełnoekranowej reklamy wideo |
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 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. Zastosowany znak X usługi Authorized Buyers będzie zawsze wyświetlany nad niestandardowym przyciskiem zamykania, nawet jeśli po 5 sekundach pojawi się pod nim. |
Słowniczek
Zapoznaj się z słowniczkiem pojęć dotyczących wideo w Authorized Buyers.
Odpowiednie pola w przypadku formatów In-Stream i Out-Stream
Zobacz OpenRTB 2.5 (od strony 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Określa, czy wyświetlenie musi być linearne, nielinearne itp. Jeśli nie podano żadnej wartości, przyjmuje się, że wszystkie są dozwolone.
|
||||
videoad_start_delay
|
|
Źródło wartości pytania o stawkę
OpenRTB Obiekt |
Pola | Authorized Buyers /Wymiana określania stawek Non-instream |
Przykładowe wartości | Kto o tym decyduje? /Skąd pochodzi ta wartość? |
---|---|---|---|---|
Obiekt | ||||
Wideo | mimów, | tak | ["application/javascript", "video/mp4"]", |
|
minduration | nie | Skonfigurowane przez wydawcę | ||
maxduration | tak | Skonfigurowane przez wydawcę | ||
playbackmet hod |
tak | [6] | Zwykle wydawca Skonfigurowano |
|
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 – w przypadku reklam pełnoekranowych => Google – w przypadku reklam In-Stream => wydawca decyduje, czy zezwolić na reklamy możliwe do pominięcia, niemożliwe do pominięcia czy na oba rodzaje. reklamy z nagrodą, których nie można pominąć; |
|
minimalna szybkość transmisji bitów | Nie | |||
maksymalna szybkość transmisji bitów, | nie | |||
pos | tak | 1 | ||
Urządzenie | ||||
Współczynnik pikseli | tak | 1 | ||
wyświetlenie miniatury | ||||
Bezpieczeństwo | tak | 1 | Google domyślnie ma wartość „true” , ponieważ tag reklamy jest zawsze bezpieczny. |