Reklamy wideo

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 możliwości wyświetlenia reklamy lub dynamiczne bloki reklamowe wideo. Dynamiczne bloki reklamowe to grupy reklam wideo wyświetlanych w sekwencji, w której maksymalny czas trwania bloku jest podzielony na co najmniej 1 film o różnej długości. Więcej informacji o reklamach natywnych i pełnoekranowych znajdziesz w przewodnikach dotyczących tych formatów reklam.

Wymagania dotyczące kupujących

Protokół RTB

W tym przewodniku będziemy odnosić się do formatu Protobuf, ale nazwy pól i ścieżki są takie same jak w formacie JSON, chyba że zaznaczono inaczej.

Protokół OpenRTB i rozszerzenia OpenRTB Google znajdziesz na stronie Protokoły i dane referencyjne. Więcej informacji o tworzeniu licytującego znajdziesz w artykułach Przetwarzanie żądania i Tworzenie odpowiedzi.

Sprawdzanie kreacji

Google zaleca przesłanie kreacji do zatwierdzenia przed ustaleniem dla nich stawek. Aby rozpocząć proces sprawdzania, możesz użyć zasobu Kreacje interfejsu API określania stawek w czasie rzeczywistym.

Konfigurowanie 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 parametrze 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ęć, takie jak CLICK_URL_ESC, nie są obsługiwane, ponieważ Authorized Buyers uwzględnia swoje tagi śledzenia kliknięć w kodzie 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 pytanie o stawkę dotyczy zasobów reklamowych In-Stream czy pełnoekranowych zasobów reklamowych wideo, oraz znaleźć dodatkowe informacje o pytaniu dotyczące filmu. Dodatkowo w przypadku zasobów reklamowych na reklamy natywne możesz używać parametru BidRequest.imp.native.{request/request_native}.assets.video, aby przekazywać podobne informacje dotyczące filmów.

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

Adres URL (bez parametrów) strony, która opisuje treści wideo. 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 reklama na zakończenie filmu (karta informacyjna) w boksie reklamowym po zakończeniu odtwarzania reklamy wideo. W przeciwnym razie reklama towarzysząca nie zostanie wyrenderowana jako reklama na zakończenie.

BidRequest.imp.rwdd

Jeśli ustawisz wartość true, oznacza to, że użytkownik otrzyma nagrodę za obejrzenie reklamy wideo. Typowe nagrody to np. możliwość przeczytania dodatkowego artykułu bez opłat, dodatkowe życie w grze lub sponsorowana sesja muzyczna bez reklam.

BidRequest.imp.video.maxduration

Maksymalny dozwolony czas trwania (w sekundach) każdej pojedynczej reklamy uwzględnionej w odpowiedzi na pytanie o stawkę. Jeśli nie ustawisz tego parametru, nie ma limitu czasu trwania. Gdy BidRequest.imp.video.skip ma wartość true, 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ą zostać wyświetlone w dynamicznym bloku reklam wideo. Jeśli parametr poddur jest ustawiony, ale parametr maxseq nie jest ustawiony lub ma wartość 0, nie masz ograniczeń dotyczących liczby reklam, które mogą się wyświetlać w bloku reklamowym wideo. Google obsługuje tylko bloki dynamiczne.

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 pojedynczej reklamy uwzględnionej w odpowiedzi na pytanie o stawkę. Jeśli nie jest ustawiona, nie ma minimalnego czasu trwania.

BidRequest.imp.video.plcmt

Opisuje, gdzie film będzie odtwarzany.

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ą odtwarzane przed strumieniem treści wideo, w jego trakcie lub po jego zakończeniu. W reklamach wideo typu In-Stream dźwięk musi być domyślnie włączony po uruchomieniu odtwarzacza lub użytkownik musi wyraźnie wskazać, że chce obejrzeć treści wideo. Odtwarzacz może być otoczony innymi treściami, ale to treści wideo muszą być głównym celem wizyty użytkownika. Powinien on pozostać główną treścią na stronie i jedynym widocznym odtwarzaczem, 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 przekazywać zaktualizowany rozmiar odtwarzacza.
PLCMT_ACCOMPANYING_CONTENT	Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed strumieniową transmisją treści wideo, w jej trakcie lub po jej zakończeniu. Odtwarzacz wideo wczytuje się i odtwarza przed akapitami tekstu lub treściami graficznymi, między nimi lub po nich. Zaczyna odtwarzać dopiero po wejściu do widocznego obszaru. Odtwarzanie treści towarzyszących powinno rozpoczynać się dopiero po wejściu do widocznego obszaru. Może on przekształcić się w pływający/przyklejony odtwarzacz, gdy użytkownik przewinie stronę.
PLCMT_INTERSTITIAL	Reklamy wideo wyświetlane bez treści wideo. Podczas odtwarzania musi być najważniejszym elementem strony i zajmować większość widocznego obszaru. Nie może też znikać z widoku podczas przewijania. Może to być w miejscach docelowych, takich jak filmy w aplikacji lub pokazy slajdów.
PLCMT_NO_CONTENT_STANDALONE	Reklamy wideo wyświetlane bez strumieniowych treści wideo. Mogą to być miejsca docelowe takie jak pokazy slajdów, natywne kanały, treści lub reklamy przyklejone/pływające.

BidRequest.imp.video.playbackmethod

Opisuje sposób odtwarzania reklamy wideo. Metoda odtwarzania jest określana jako autoodtwarzanie lub odtwarzanie po kliknięciu na podstawie najlepszych dostępnych danych.

AUTO_PLAY_SOUND_ON	Uruchamia się po wczytaniu strony z włączonym dźwiękiem.
AUTO_PLAY_SOUND_OFF	Uruchamia się po wczytaniu strony z wyłączonym dźwiękiem.
CLICK_TO_PLAY	Uruchamia się po kliknięciu z włączonym dźwiękiem.
MOUSE_OVER	Uruchamia się po najechaniu kursorem, z włączonym dźwiękiem.
ENTER_SOUND_ON	Uruchamia się po wejściu do widocznego obszaru z włączonym dźwiękiem.
ENTER_SOUND_OFF	Uruchamia się po wejściu w widoczny obszar, domyślnie z wyłączonym dźwiękiem.

BidRequest.imp.video.skip

Jeśli wartość to true, oznacza to, że odtwarzacz zezwala na pominięcie filmu lub że dozwolone są reklamy możliwe do pominięcia. W przeciwnym razie oznacza, ż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 i BidRequest.imp.audio.durfloors

Tablica obiektów DurFloors wskazujących odpowiednie ceny minimalne kreacji wideo lub audio o różnych czasach trwania, za które kupujący może licytować.

Oto przykład, jak wyglądałby parametr durfloors określony przez Google:

1. {"maxdur": 16, "bidfloor": 5}, co odpowiada (0, 16) s przy $5.
2. {"mindur": 16, "maxdur": 31, "bidfloor": 10}, co odpowiada [16, 31) s przy $10.
3. {"mindur": 31, "bidfloor": 20}, co odpowiada [31, inf) s przy $20.

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

BidRequest.device.ifa

To pole zawiera 36-znakowy identyfikator UUID, który jest ustawiany tylko wtedy, gdy używany jest protokół SSL, i nie jest on 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ń CTV zawiera unikalne identyfikatory (np. RIDA w przypadku Roku).

BidRequest.device.devicetype

Określa typ urządzenia.

MOBILE	Nieaktualny alias dla HIGHEND_PHONE lub TABLET.
PERSONAL_COMPUTER	Obejmuje komputery stacjonarne i laptopy.
CONNECTED_TV	obejmuje zarówno telewizory smart TV, jak i urządzenia multimedialne z internetem (np. Roku, Apple TV).
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 wyświetlania reklam zewnętrznych, 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 pełnych obejrzeń reklam wideo wyświetlanych w boksie reklamowym. Wartość domyślna -1.0 oznacza, że dane historyczne dotyczące współczynnika pełnych obejrzeń są niedostępne.

BidRequest.imp.video.poddur

Czas (w sekundach), który możesz wypełnić w dynamicznym bloku reklamowym wideo. To pole odnosi się do długości całej przerwy na reklamę. Jeśli nie jest ustawiony, boks reklamowy nie jest częścią bloku reklamowego.

Pytanie o stawkę wideo zawiera też informacje o zasobach reklamowych, takie jak branża, dozwoleni dostawcy i informacje o kanale. Wszystkie pozostałe pola w pytaniu o stawkę również dotyczą reklam wideo.

Pola szerokości i wysokości w komunikacie AdSlot żądania 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 opisująca obsługiwane typy MIME treści reklam wyświetlanych w odpowiedzi na pytanie o stawkę, 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 typu wyliczeniowego 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 strony, na której film został umieszczony. Na przykład:

http://www.publisher.com/watchpagelink

W odpowiedzi na żądanie reklamy wideo licytujący powinien zwrócić URL przekierowania VAST lub kod XML VAST w polu BidResponse.seatbid.bid.adm. Odpowiedź na pytanie o stawkę powinna też zawierać prawidłową deklarację dotyczącą reklamy wideo. Poniżej znajdziesz fragment prawidłowej odpowiedzi na pytanie o stawkę w przypadku reklamy wideo:

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

Ważne pola w odpowiedzi na pytanie o stawkę wideo:

BidResponse.seatbid.bid.ext.attribute

Atrybuty reklam, które mogą się wyświetlać z tego fragmentu kodu. Listę identyfikatorów znajdziesz w pliku buyer-declarable-creative-attributes.txt. Sprawdzamy, czy żaden z tych atrybutów nie jest niedozwolony przez wydawcę w pytaniu o stawkę. Jeśli na przykład którekolwiek z tych pól zawiera wartość 30, oznacza to, że reklama wymaga obsługi VPAID do renderowania.

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

• Przykładowe filmy – pytania o stawkę
• Przykładowe odpowiedzi na pytania o stawkę wideo

Dostosowanie możliwości pominięcia

Google automatycznie stosuje dostosowanie możliwości pomijania do stawek w określaniu stawek w czasie rzeczywistym w przypadku zasobów reklamowych wideo. Może to zapobiec odfiltrowaniu Twoich stawek z aukcji z powodu różnic między możliwością pominięcia wymaganą w pytaniu o stawkę a możliwością pominięcia kreacji, które zwracasz w odpowiedzi na pytanie o stawkę. Dostosowanie możliwości pomijania nie jest stosowane w tych przypadkach:

• Kreacja określona w odpowiedzi na pytanie o stawkę jest implementowana za pomocą VPAID. Możesz określić, które z Twoich kreacji wideo są wdrażane za pomocą VPAID, korzystając z pola Creative.video.videoMetadata.isVpaid w interfejsie API określania stawek w czasie rzeczywistym.
• Wydawca wyrenderuje kreację. Możesz to określić na podstawie pola BidRequest.imp.displaymanager, które ma wartość 'PUBLISHER', jeśli wydawca ma renderować kreację.

Oto przykłady zastosowania dostosowania możliwości pomijania:

• Scenariusz 1:
• Otrzymujesz pytanie o stawkę z polem BidRequest.imp.video.skip ustawionym na 0 w przypadku formatu JSON lub false w przypadku formatu Protobuf.
• Ustalasz stawkę za kreację możliwą do pominięcia.
• Wynik: Twoja stawka bierze udział w aukcji. Jeśli Twoja stawka wygra i kreacja wideo zostanie wyrenderowana, będzie ona niemożliwa do pominięcia.
• Scenariusz 2:
• Otrzymujesz pytanie o stawkę z polem BidRequest.imp.video.skip ustawionym na 1 w przypadku formatu JSON lub true w przypadku formatu Protobuf.
• Przesyłasz stawkę z kreacją niemożliwą do pominięcia, która trwa dłużej niż czas określony w polu BidRequest.imp.video.skipmin.
• Wynik: Twoja stawka bierze udział w aukcji. Jeśli Twoja stawka wygra i kreacja wideo zostanie wyrenderowana, będzie ona możliwa do pominięcia.

Formaty filmów wideo

• Jak kupujący mogą dołączać filmy
• Sygnały OpenRTB zalecane w przypadku wszystkich formatów wideo
• Zalecane sygnały protokołu Authorized Buyers dla wszystkich formatów wideo
• Jak wydawcy mogą zezwalać na reklamy wideo lub je blokować
• Przypadki skrajne

Jak kupujący mogą dołączać filmy

W tabelach poniżej pokazujemy, jak kupujący mogą uwzględniać filmy w swoich kreacjach i miejscach docelowych, w których mogą być wyświetlane w przypadku odpowiednio stron internetowych i aplikacji mobilnych.

Sieć

Aplikacja mobilna

Zalecane sygnały OpenRTB

W tabelach poniżej znajdziesz zalecane sygnały OpenRTB dla wszystkich formatów wideo w internecie na komputerach i urządzeniach mobilnych oraz w aplikacjach mobilnych.

Komputery i internet mobilny

Aplikacja mobilna

Jak wydawcy mogą zezwalać na reklamy wideo lub je blokować

W tabeli poniżej pokazujemy, jak wydawcy mogą zezwalać na reklamy wideo w swoich miejscach docelowych lub je blokować.

Przypadki skrajne

Słowniczek

Zobacz Słowniczek pojęć związanych z reklamami wideo w Authorized Buyers.

Odpowiednie pola dla formatów In-Stream i innych niż In-Stream

Zobacz OpenRTB 2.5 (od strony 47).

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