W tym przewodniku znajdziesz wymagania dotyczące integracji, konfigurację i odpowiednie pola, których możesz używać podczas określania stawek za zasoby reklamowe wideo.
Google obsługuje reklamy wideo In-Stream, natywne i pełnoekranowe, które są reprezentowane jako pojedyncze miejsca docelowe reklam lub dynamiczne bloki reklam wideo. Bloki dynamiczne to grupy reklam wideo wyświetlane w sekwencji, w których maksymalny czas trwania bloku jest podzielony na co najmniej 1 film o zmiennej długości. 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 podobnych 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 ograniczenie końcowe. 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 w sekundach każdej reklamy uwzględnionej w odpowiedzi na stawkę. Jeśli nie ustawisz maksymalnego czasu trwania, nie będzie ono obowiązywać. Gdy
BidRequest.imp.video.skip
=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, które mogą być wyświetlane w bloku reklamowym wideo z reklamami dynamicznymi. Jeśli parametr
poddur
jest ustawiony, ale parametrmaxseq
nie jest ustawiony lub jest ustawiony jako0
, nie ma ograniczeń dotyczących liczby reklam, które mogą się wyświetlać w bloku reklamowym. Google obsługuje tylko moduły dynamiczne.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 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
-
Opisuje, 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, które zażądał konsument, w trakcie lub po nim. 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. powinna pozostać główną treścią 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 nim. Odtwarzacz wczytuje się i odtwarza przed akapitami tekstu lub treścią graficzną, w ich trakcie lub po nich i rozpoczyna odtwarzanie dopiero wtedy, gdy znajdzie się w widocznym obszarze ekranu. 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 slajdowce, 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
Rozpoczyna się po wyświetleniu z domyślnie wyłączonym dźwiękiem. BidRequest.imp.video.skip
- Jeśli
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.
BidRequest.imp.video.durfloors
iBidRequest.imp.audio.durfloors
-
Tablica obiektów
DurFloors
wskazująca ceny minimalne kreacji wideo lub audio o różnych długościach, na które kupujący może licytować.Oto przykład tego, jak wygląda
durfloors
określone przez Google:{"maxdur": 16, "bidfloor": 5}
reprezentujący(0, 16)
sekund w okresie$5
.{"mindur": 16, "maxdur": 31, "bidfloor": 10}
reprezentujący[16, 31)
sekund w$10
.{"mindur": 31, "bidfloor": 20}
reprezentujący[31, inf)
sekund w okresie$20
.
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 identyfikator Androida (ADID) w wersji małej. 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 multimedialne z internetem (np. Roku, Apple TV itd.). 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
, parametrMetric.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
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ć blok reklamy wideo dynamicznej. To pole odnosi się do długości całej przerwy na reklamę. Jeśli nie jest ustawiony, boks reklamowy nie należy do bloku.
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 prośbę o stawkę, 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 wyliczonych
Protocol
, m.in.: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, o ile 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: "79N7F1708654i75q3k69j1" seatbid { bid { id: "1gR655162hOsH9q3X6R" impid: "1" price: 2.3833 adid: "test_creative_id_648299" adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" crid: "test_creative_id_648299" attr: VIDEO_IN_BANNER_AUTO_PLAY w: 1920 h: 1080 [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 11004606416 skadn { version: "4.0" network: "O5O88B57" itunesitem: "509167749" nonce: "" sourceapp: "com.google.testapp" timestamp: "OMITTED" signature: "OMITTED" fidelities { fidelity: VIEW_THROUGH_ADS nonce: "d3be52b1-8ef6-4277-8922-54450b07fd5b" timestamp: "1730409097616" signature: "8d52E359K158Dj1u89EpLP3544Qz7B10CV0a92YZJ6JXX8d9uXi72N43ZxjRl96Ph7v8R5u1k5y9Aoy3jZcN3C5dxRU390qc" } fidelities { fidelity: STOREKIT_RENDERED_ADS nonce: "d3be52b1-8ef6-4277-8922-54450b07fd5b" timestamp: "1730409097616" signature: "43C2b79X4nPY913Qs3jJLLhCjUNZg39cK022pCE2wH731Ie7q4584b5UGG137Jh12I2R6a0e35LJbvQJbn5o564roQ7G1Mtd" } sourceidentifier: "1" } app_promotion_type: INSTALLS } } seat: "1061:9160:833989" } bidid: "m7V3rjn0-aF599ZZ6-37hA-b9o7DU8CLrtp" cur: "USD"
Ważne pola w odpowiedzi na stawkę za wyświetlenie filmu:
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 jest 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
- Zalecane sygnały OpenRTB dla wszystkich formatów wideo
- Zalecane sygnały proto Authorized Buyers dla wszystkich formatów wideo
- Jak wydawcy mogą zezwalać na wyświetlanie filmów lub je blokować
- Przypadki ekstremalne
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 | Natywne reklamy w kanałach i artykułach | Pełnoekranowa | Na banerze |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
Niestandardowy kod JS |
|
||||
Reklama natywna + VAST |
|
Aplikacja mobilna
Kreacja wideo | In-Stream (wszystkie) | In-Feed/Article | Natywne reklamy w kanałach i artykułach | 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, podlega blokadom wydawcy |
Kreacja wideo jest niedostępna w przypadku tego miejsca docelowego |
---|
Zalecane sygnały OpenRTB
Poniższe tabele przedstawiają 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 & |
|
In-Stream (bez VPAID) |
Obiekt VIDEO jest obecny & |
|
Reklamy inne niż In-Stream |
Obecność obiektu wideo
|
|
In-Feed |
Obiekt VIDEO jest obecny & |
|
In-Article |
Obiekt VIDEO jest obecny & |
|
Natywna |
Obiekt NATIVE jest obecny & |
|
Na banerze |
Brak obiektu wideo & |
Aplikacja mobilna
Format filmu | Szczegóły pytania o stawkę (tylko szczegóły dotyczące filmu) | |
---|---|---|
In-Stream |
Obiekt VIDEO jest obecny & |
|
Reklamy inne niż In-Stream |
Obecność obiektu wideo
|
|
In-Feed |
Obiekt VIDEO jest obecny & |
|
In-Article |
Obiekt VIDEO jest obecny & |
|
Natywna |
Obiekt NATIVE jest obecny & |
|
Reklama pełnoekranowa (VAST) |
Obiekt VIDEO jest obecny & |
|
Reklama pełnoekranowa (bez VAST) |
Obiekt VIDEO jest obecny & |
Odfiltrowany |
Na banerze (MRAID) |
Brak obiektu wideo & |
|
Na banerze (brak MRAID) |
Brak obiektu wideo & |
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 & |
Wyrażenie zgody na VPAID |
In-Stream w internecie |
Obiekt wideo jest obecny & |
Dołącz do programu IBV |
Na banerze Pełnoekranowa |
|
Wyraź zgodę na: (instrukcje) |
In-Feed In-Article |
Obiekt wideo jest obecny & |
Włączanie reklam innych niż In-Stream (instrukcje) |
Natywna |
Obecność obiektu natywnego |
Blokowanie reklam wideo na cały ekran |
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 zastosowano niestandardowego zamknięcia. Znak X użyty w ramach Authorized Buyers będzie zawsze wyświetlany nad każdą niestandardową opcją zamknięcia, nawet jeśli pojawi się ona 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
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Określa, czy wyświetlenie musi być linearne, nielinearne itp. Jeśli nie ma żadnego parametru, przyjmuje się, że wszystkie są dozwolone.
|
||||
videoad_start_delay
|
|
Ź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"]", |
|
minduration | nie | Konfiguracja przez wydawcę | ||
maxduration | tak | Konfiguracja przez wydawcę | ||
playbackmet hod |
tak | [6] | Zwykle wydawca Skonfigurowano |
|
interfejs 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 reklamy intersticjalnej => Google - w przypadku reklamy In-Stream => wydawca decyduje, czy dopuścić reklamy możliwe i niemożliwe do pominięcia, czy obie. Reklamy z nagrodą, które nie mogą być pominięte; |
|
minimalna szybkość transmisji bitów | Nie | |||
max bitrate | nie | |||
pos | tak | 1 | ||
Urządzenie | ||||
Współczynnik pikseli | tak | 1 | ||
wyświetlenie miniatury | ||||
Bezpieczne | tak | 1 | Google domyślnie ustawiona na wartość true ponieważ adtag jest zawsze bezpieczny |