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 zostanie on omówiony 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. Zobacz przewodniki dla Natywnych i Formaty reklam pełnoekranowych .

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 rozszerzenia OpenRTB właściwe dla Google znajdziesz w Strona Prototy 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. Interfejsu API do określania stawek w czasie rzeczywistym możesz używać Zasób kreacji aby rozpocząć proces weryfikacji.

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. Ponadto, jeśli wskażesz film URL możesz też umieścić w powiązanym dokumencie XML VAST. te makra są obsługiwane w przypadku kreacji wideo:

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

Makra kliknięć, np. CLICK_URL_ESC, nie są obsługiwane, ponieważ Authorized Buyers umieszcza tagi śledzenia kliknięć w opakowaniu VAST. Więcej informacji na temat obsługiwanych makr znajdziesz w artykule Określanie makr.

Szczegóły objaśnienia

Za pomocą pola BidRequest.imp.video OpenRTB można zidentyfikować czy przychodzące pytanie o stawkę dotyczy reklam wideo typu In-Stream czy pełnoekranowych. zasobów reklamowych i znaleźć dodatkowe informacje o żądaniu dotyczące reklam wideo. W przypadku zasobów reklamowych natywnych możesz też użyć opcji BidRequest.imp.native.{request/request_native}.assets.video dla podobne informacje dotyczące konkretnego filmu.

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

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
banner.vcm
Jeśli ma wartość true, reklama towarzysząca może zostać wybrana do renderowania. w postaci reklamy po zakończeniu filmu. gra. W przeciwnym razie reklama towarzysząca nie będzie renderowana jako reklama po zakończeniu filmu.
.
BidRequest.imp.rwdd
Jeśli ma wartość 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 (w sekundach), który należy zwrócić. Jeśli zasada jest nieskonfigurowana, nie ma maksymalnego czasu trwania. Kiedy BidRequest.imp.video.skip ma wartość true, może to spowodować zachowywania się 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 skonfigurowana, boks reklamowy nie jest są 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 powinieneś zwrócić. Kiedy nie ustawiono, nie ma minimalnego czasu trwania.
BidRequest.imp.video.plcmt
Określa miejsce odtwarzania filmu.
PLCMT_UNKNOWN Miejsce docelowe jest nieznane lub nie można określić.
PLCMT_INSTREAM reklamy przed filmem, w trakcie filmu i po filmie, które są odtwarzane wcześniej; w trakcie lub po zakończeniu strumieniowego przesyłania treści wideo, poproszono o dostęp. W przypadku reklamy In-Stream należy włączyć dźwięk domyślnie na odtwarzacza, lub wyraźnie wyraźną chęć użytkownika treści wideo. Chociaż mogą istnieć inne treści dotyczące w odtwarzaczu muszą być skupione na treści wideo. it powinna pozostać główną treścią strony i jedynym filmem, w widocznym obszarze odtwarzacza, który może odtwarzać dźwięk. 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ą, między nimi albo po nich i uruchamia się dopiero, gdy wejdzie do widocznego obszaru. Treści towarzyszące powinny się odtwarzać dopiero po wyświetleniu ich w widocznym obszarze. Podczas przewijania może on przekształcić się w pływający odtwarzacz przyklejony. przestaje działać.
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. Wybraną metodą odtwarzania jest autoodtwarzanie lub „kliknij, aby odtworzyć” na podstawie najlepszych dostępnych pomiarów.
AUTO_PLAY_SOUND_ON Uruchamia się podczas wczytywania 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 oznacza reklamę w trakcie filmu, a -2 – reklamę w trakcie filmu. czyli reklamy 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ą unikalne 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 parametr Identyfikator dla reklamodawców (IDFA) zapisany wielkimi literami. 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 Nieaktualny 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ę (np. Nokia lub Samsung) urządzenia.
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
Gdy zasada Metric.type ma wartość completion_rate, Metric.value będzie ułamkiem z zakresu [0,0, 1,0] reprezentujący historyczny współczynnik pełnych obejrzeń reklam wideo wyświetlanych w reklamie gniazdo. 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ę 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.

BidRequest.imp.ext.allowed_vendor_type
Dozwoleni dostawcy. Lista identyfikatorów znajduje się 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 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
Opis obsługiwanych przez wydawcę wersji VAST dla żą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 reklam towarzyszących (jeśli są dostępne).
BidRequest.site.page

Adres URL strony z filmem 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 stawkę za reklamę 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 odpowiedzi na stawkę wideo to:

BidResponse.seatbid.bid.ext.attribute
Atrybuty reklam, które mogą się wyświetlać z tego fragmentu kodu. Zobacz buyer-declarable-creative-attributes.txt z listą identyfikatorów. 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 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ą się one wyświetlać.

Sieć

Kreacja wideo In-Stream (wszystkie) In-Feed/artykuł Natywne reklamy w kanałach i artykułach Pełnoekranowa Na banerze

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

Niestandardowy kod JS

 

Natywna + VAST

 

Aplikacja mobilna

Kreacja wideo In-Stream (wszystkie) In-Feed/artykuł 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/technologia jest niedostępna

Kreacja wideo została zaakceptowana w tym miejscu docelowym (podlega ona blokadzie 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 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

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

Występuje obiekt VIDEO   &
video.placement = IN-FEED

In-Article

Obiekt VIDEO jest obecny &
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)

Aplikacja mobilna

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

In-Stream

Występuje obiekt VIDEO   &
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

Występuje obiekt VIDEO   &
video.placement = IN-FEED

In-Article

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

Natywna

Obecny obiekt NATIVE &

Reklama pełnoekranowa (VAST)

Występuje obiekt VIDEO   &
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 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)

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

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 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

Wyrażenie zgody na VPAID

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 (autoodtwarzanie) lub 7 Wideo banerowe (inicjowane przez użytkownika)

Włącz tę funkcję (instrukcje).

In-Feed

In-Article

Występuje obiekt wideo &
video.placement = IN-FEED lub IN-ARTICLE

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

Natywna

Występuje obiekt natywny

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 przy użyciu MRAID

W przypadku reklam pełnoekranowych zamknięcie reklamy może spowodować wysłanie powiadomienia do kupującego za pomocą MRAID. nawet gdyby nie używali niestandardowego zamknięcia.


Wartość X zastosowanej w usłudze Authorized Buyers będzie zawsze wyświetlana na początku listy niestandardowe zamknięcie, nawet jeśli pojawi się ono poniżej po 5 sekundach.

Słowniczek

Zobacz Glosariusz filmowy Authorized Buyers.

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

OpenRTB 2.5 (od strony 47)

BidRequest.Video.
Placement
In-Stream mWeb

1: In-Stream
2: In-Banner

mApp

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

5: reklama pełnoekranowa

Native

3: w artykule
4: In-Feed

Rewarded

is_rewarded_inventory: wartość logiczna rozszerzenia OpenRTB
linearity

Wskazuje, czy wyświetlenie musi być liniowe, nieliniowe itd. Jeśli nie podasz żadnej wartości, zakładamy, że wszystkie są dozwolone.

In-Stream mWeb

1: LINEAR (In-Stream)

mApp

1: LINEAR (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,
/Giełda
Określanie stawek
Reklamy inne niż In-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
minduration nie Konfiguracja przez wydawcę
maxduration tak Skonfigurowane przez wydawcę
playbackmet
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ś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 wartość domyślna to prawda
ponieważ adtag to zawsze
bezpieczny