Specyfikacja OpenRTB w DV360

Podczas korzystania z tej strony miej pod ręką specyfikację OpenRTB 2.6.

Display & Video 360 nie obsługuje wszystkich pól w specyfikacji OpenRTB, a w niektórych przypadkach mogą występować różnice. W poszczególnych sekcjach tego dokumentu znajdziesz informacje i rekomendacje dotyczące wdrożenia Display & Video 360. Oprócz tego postępuj zgodnie z wytycznymi podanymi w specyfikacji OpenRTB, chyba że podano inaczej.

Niektóre pola nie są obsługiwane, ale są nadal analizowane. Te pola muszą być prawidłowo sformatowane, ale nie mają wpływu na wynik określania stawek.

Specyfikacja pytania o stawkę

Pytanie o stawkę to żądanie HTTP POST z treścią w postaci obiektu pytania o stawkę. Format treści jest zdefiniowany w nagłówku Content-Type.

Odpowiedź to HTTP 204 bez treści w przypadku braku oferty lub HTTP 200 z treścią w postaci odpowiedzi na ofertę.

Jeśli pytanie o stawkę jest nieprawidłowe, może zostać zwrócony kod HTTP 200 z treścią bid response z wypełnionym polem nbr.

Format odpowiedzi jest kontrolowany przez nagłówek Accept.

Format JSON

Format domyślny jest używany, gdy nie podano akceptowanego typu MIME.

Żądania i odpowiedzi JSON są zgodne ze specyfikacją OpenRTB 2.6 IAB. W dokumentacji poniżej znajdziesz informacje o rozszerzeniach i obsłudze pól.

Nagłówek Content-Type: application/json wskazuje, że żądanie stawki jest w formacie JSON, Accept: application/json wskazuje, że odpowiedzi na żądanie stawki powinny być w formacie JSON.

Format Protobuf

UWAGA: obsługa Protobuf jest w wersji beta. Jeśli jesteś zainteresowany(-a), skontaktuj się z zespołem DV360.

Żądania i odpowiedzi JSON są zgodne ze specyfikacją OpenRTB 2.6 Protobuf organizacji IAB.

Rozszerzenia są obsługiwane w ograniczonym zakresie. Jeśli Cię to interesuje, skontaktuj się z zespołem DV360.

Wyślij nagłówek Content-Type: application/x-protobuf, aby wskazać żądanie Protobuf, i ustaw Accept: application/x-protobuf, aby otrzymywać odpowiedzi Protobuf.

Obiekt pytania o stawkę

Pole Typ Szczegóły
id Ciąg znaków Wymagane.
Unikalny identyfikator pytania o stawkę. Można go używać do identyfikowania poszczególnych żądań przez bardzo krótki czas po ich obsłużeniu.
imp Tablica Imp Wymagany jest co najmniej 1 obiekt imp.

W przypadku zasobów audio obsługiwanych jest więcej niż 1 obiekt imp.
W przypadku innych zastosowań (np. wielu niezależnych boksów na stronie) używany jest pierwszy obiekt imp, a pozostałe są odrzucane.
site Witryna Wymagane w przypadku próśb o dostęp do witryn.
site i app wykluczają się nawzajem.
app Aplikacja Wymagany w przypadku próśb o aplikacje.
app i site wykluczają się nawzajem.
device Urządzenie Wymagane.
user Użytkownik Wymagane.
test Liczba całkowita  Nieobsługiwane.
at Liczba całkowita 1: aukcja pierwszej ceny, w której reklamodawca płaci kwotę swojej stawki.
2 (domyślnie): aukcja drugiej ceny, w której reklamodawca płaci stawkę nieco wyższą od stawki drugiego najwyższego licytującego.
3: cena minimalna jest podana w żądaniu i nie ma nic wspólnego z konkurencyjnymi stawkami.
tmax Liczba całkowita Opcjonalny, domyślnie niestandardowy dla każdej integracji.
wseat Tablica ciągów znaków Lista dozwolonych stanowisk kupującego.
Zalecane, chyba że wszyscy reklamodawcy mogą składać oferty.
Brak ustawienia oznacza brak ograniczeń.
bseat Tablica ciągów znaków Lista miejsc kupujących, których stawki powinny być blokowane. Wymienieni kupujący nie będą mogli licytować w przypadku umów ani aukcji otwartych.
allimps Liczba całkowita  Nieobsługiwane.
cur Tablica ciągów znaków

Opcjonalne, ale zdecydowanie zalecane. Domyślne ustawienie to na integrację.

Waluta w pytaniu o stawkę musi być zgodna z jedną z walut zarejestrowanych podczas integracji.

Zdecydowanie zalecamy obsługę 1 waluty na giełdę.
wlang Tablica ciągów znaków  Nieobsługiwane.
bcat Tablica ciągów znaków zablokowane kategorie reklamodawców z wykorzystaniem kategorii treści IAB;
Nieskonfigurowana oznacza brak zablokowanych kategorii.
badv Tablica ciągów znaków Określ zablokowanego reklamodawcę na podstawie domeny podanej przez reklamodawcę.
Brak ustawienia oznacza brak zablokowanych reklamodawców.
bapp Tablica ciągów znaków  Nieobsługiwane.
source Źródło Wymagane w przypadku schain.
regs Regs Opcjonalnie.
ext Rozszerzenia pytania o stawkę Opcjonalnie.

Obiekt rozszerzeń pytania o stawkę

Pole Typ Szczegóły
schain Łańcuch dostaw w przypadku nowych integracji należy używać pola BidRequest.source.schain w źródle.
purch Liczba całkowita Parametr Ruch kupiony to ruch przekierowywany z usług innych niż te, które należą do podmiotu, uzyskany przez pozyskanie lub w wyniku innego działania stanowiącego zachętę.
Zgodnie z nową specyfikacją MRC IVT 2.0.

W raportach dla kupujących będzie to pole Źródło wizyt wydawcy, które może przyjmować jedną z tych wartości :
0 (domyślna): niezdefiniowane – wartość nie została wysłana w żądaniach stawek. Nie można zarejestrować wartości;
1: Kupiony – ruch przekierowywany z usług innych firm (przez pozyskanie lub w wyniku innego działania stanowiącego zachętę).
2: Bezpłatne – bezpośrednie wpisywanie adresu URL, wyszukiwanie w witrynie lub pobieranie aplikacji.

gdemsignals Ciąg znaków Blok sygnału interfejsu SCAR API z pakietu GMA SDK.
Zalecane w przypadku ruchu z pakietu GMA SDK, w innych przypadkach zabronione.
disable_gma_format int Opcjonalne, jeśli podano wartość gdemsignals. W przeciwnym razie zabronione.
0 (domyślne): gdy pole gdemsignals jest wypełnione, odpowiedź na stawkę adm jest obiektem JSON.
1: Zamiast bloku json zostanie też podany tag reklamy.

Obiekt źródłowy

Pole Typ Szczegóły
fd Liczba całkowita Podmiot odpowiedzialny za ostateczną decyzję o sprzedaży wyświetlenia
0 (Domyślnie): decyzję podejmuje giełda.
1: decyzję podejmuje źródło nadrzędne.
tid Ciąg znaków  Nieobsługiwane.
pchain Ciąg znaków  Nieobsługiwane.
schain Łańcuch dostaw Wymagany w prawie wszystkich przypadkach.

To pole jest preferowane w stosunku do podawania wartości schain za pomocą rozszerzeń żądania stawki lub rozszerzeń źródła.

ext Rozszerzenia źródła Opcjonalnie.

Obiekt rozszerzeń źródłowych

To rozszerzenie jest wysoce zalecane, ponieważ wpływa na sposób raportowania pomiarów widoczności w DV3 do klienta. Jeśli nazwa partnera OMID NIE znajduje się na liście certyfikatów IAB, musimy zgodnie z wymaganiami MRC raportować dane o widoczności oddzielnie od danych certyfikowanych przez MRC. Więcej informacji

Pole Typ Szczegóły
omidpn Ciąg znaków Identyfikator integracji pakietu OM SDK. Jest to ten sam parametr co „name” w obiekcie OMID Partner.
omidpv Ciąg znaków Wersja integracji pakietu OM SDK. Jest to ten sam parametr co „versionString” obiektu OMID Partner.
schain Łańcuch dostaw w przypadku nowych integracji należy używać pola schain w Źródle.

Obiekt Regs

Pole Typ Szczegóły
coppa Liczba całkowita 0 (domyślnie): ustawa COPPA nie ma zastosowania do tej prośby.
1: ta prośba podlega ustawie COPPA.
ext Rozszerzenia dotyczące przepisów Opcjonalnie.

Obiekt rozszerzeń Regs

Pole Typ Szczegóły
gdpr Liczba całkowita Wskazuje, czy pytanie o stawkę pochodzi z Europejskiego Obszaru Gospodarczego.
0 (domyślne): region spoza EOG.
1: region EOG.
Więcej informacji znajdziesz w artykule Rozwiązanie dla dostawców usług w zakresie uzyskiwania zgody na wykorzystanie danych zgodnie z RODO.
us_privacy Ciąg znaków Aby zaimplementować ciąg us_privacy, postępuj zgodnie ze specyfikacją techniczną podaną przez IAB Tech Lab.

Gdy w pytaniu o stawkę otrzymamy ciąg us_privacy i ciąg IAB wskazuje, że użytkownik nie zrezygnował ze zbierania danych, Display & Video 360 złoży ofertę w odpowiedzi na takie żądania. Nie będziemy przesyłać sygnału IAB do innych dostawców. Jeśli ciąg IAB wskazuje, że użytkownik zrezygnował ze zbierania danych, Google nie będzie składać ofert w przypadku takich żądań.

Obiekt Imp

Pole Typ Szczegóły
id Ciąg znaków Unikalny identyfikator tego wyświetlenia w kontekście pytania o stawkę (zwykle wartość zaczyna się od 1 i zwiększa się do n w przypadku n wyświetleń).
metric Obiekt  Nieobsługiwane.
banner Banner Wymagane w przypadku możliwości wyświetlania banerów reklamowych.
video Film Wymagane w przypadku możliwości wyświetlania reklam wideo.
audio Dźwięk Wymagany w przypadku możliwości wyświetlania reklam audio.
native Reklamy natywne Wymagane w przypadku możliwości wyświetlania reklam natywnych.
pmp Pmp Umowy na prywatnej platformie handlowej obowiązujące w przypadku tego wyświetlenia.
displaymanager Ciąg znaków Nazwa partnera zapośredniczenia reklam, technologii pakietu SDK lub odtwarzacza odpowiedzialnego za renderowanie reklamy (zwykle wideo lub mobilnej). Używany przez niektóre serwery reklamowe do dostosowywania kodu reklamy według partnera. Zalecane w przypadku filmów lub aplikacji.
displaymanagerver Ciąg znaków Wersja partnera zapośredniczenia reklam, technologii pakietu SDK lub odtwarzacza odpowiedzialnego za renderowanie reklamy (zwykle wideo lub mobilnej). Używany przez niektóre serwery reklamowe do dostosowywania kodu reklamy według partnera. Zalecane w przypadku filmów lub aplikacji.
instl Liczba całkowita 0 (domyślnie): nie jest to reklama pełnoekranowa.
1: reklama jest pełnoekranowa lub wyświetla się w formie reklamy pełnoekranowej.
tagid Ciąg znaków Identyfikator konkretnego miejsca docelowego reklamy lub tagu reklamy, który został użyty do zainicjowania aukcji. Może to być przydatne podczas rozwiązywania problemów lub optymalizacji przez kupującego.
bidfloor Liczba zmiennoprzecinkowa Minimalna stawka za to wyświetlenie wyrażona w CPM.
bidfloorcur Ciąg znaków

Waluta określona za pomocą kodów ISO-4217.

clickbrowser Liczba całkowita

Określa typ przeglądarki otwieranej po kliknięciu kreacji w aplikacji.
0 (domyślnie): osadzona
1: natywna

Pamiętaj, że kontroler widoku Safari na urządzeniach z iOS 9.x jest traktowany jako przeglądarka natywna na potrzeby tego pola.

secure Liczba całkowita Czy to wyświetlenie wymaga bezpiecznego adresu URL HTTPS czy niezabezpieczonego adresu URL HTTP.
0 (domyślne):insecure
1: secure
iframebuster Tablica ciągów znaków
exp Liczba całkowita Okres ważności stawki jest ustawiany przez DV360 bez względu na wartość przesłaną przez partnera w tym polu. Zdarzenia wyświetlenia otrzymane po upływie okresu nieaktualności wyświetlenia (zwykle 1 godzina) są odrzucane jako nieaktualne i nie są uznawane przez DV360 za podlegające rozliczeniu.
rwdd Liczba całkowita Określa, czy użytkownik otrzyma nagrodę za obejrzenie reklamy.
0 (domyślnie): brak nagrody
1: nagroda przyznana

Zazwyczaj wdrożenia reklam wideo umożliwiają użytkownikom bezpłatne przeczytanie dodatkowego artykułu z wiadomościami, otrzymanie dodatkowego życia w grze lub skorzystanie z sesji muzycznej bez reklam. Nagroda jest zwykle przyznawana po obejrzeniu reklamy wideo do końca.

Obiekt rozszerzenia Imp

Pole Typ Szczegóły
bcrid Ciąg znaków Lista identyfikatorów kreacji, które mają być blokowane.
Pole Typ Szczegóły
format Tablica format Lista obsługiwanych formatów.
w Liczba całkowita

Pola h i w zostaną scalone w polu format.

Zalecamy używanie interfejsu format.
h Liczba całkowita

Pola h i w zostaną scalone w polu format.

Zalecamy używanie interfejsu format.
wmax Liczba całkowita  Nieobsługiwane.
hmax Liczba całkowita  Nieobsługiwane.
wmin Liczba całkowita  Nieobsługiwane.
hmin Liczba całkowita  Nieobsługiwane.
btype Tablica liczb całkowitych Lista typów banerów reklamowych, które są na liście zablokowanych:

1: reklamy tekstowe HTML
2: reklamy banerowe HTML
3: reklamy JavaScript
4: reklamy IFrame

battr Tablica liczb całkowitych Obsługuje następujące wartości:

1: automatyczne odtwarzanie dźwięku
2: dźwięk inicjowany przez użytkownika
3: automatyczne rozwijanie
4: rozwijanie inicjowane kliknięciem
5: rozwijanie inicjowane najechaniem kursorem
6: automatyczne odtwarzanie wideo w banerze
7: odtwarzanie wideo w banerze inicjowane przez użytkownika
8: wyskakujące okienko(nad/pod/po wyjściu)
9: prowokacyjne lub sugestywne
10: „irytujące”, np. drżące, migające, z ekstremalną animacją, emotikonami
11: ankiety
12: tylko tekst
13: interaktywne (gry)
14: okno dialogowe lub alert w stylu Windows
15: przycisk włączania/wyłączania dźwięku
16: reklamę można pominąć
17: Flash

pos Liczba całkowita Pozycja reklamy:

0 (domyślne): nieznane
1: nad linią podziału
2: nieobsługiwane: prawdopodobnie pod linią podziału
3: pod linią podziału
4: nagłówek
5: stopka
6: pasek boczny
7: pełny ekran
mimes Tablica ciągów znaków  Nieobsługiwane.

DV360 będzie używać formatu text/html w przypadku wszystkich kreacji banerowych.

topframe Liczba całkowita 0 (domyślnie): baner jest wyświetlany w ramce iframe.
1: Nieobsługiwane: baner jest wyświetlany w górnej ramce.
expdir Tablica liczb całkowitych 1: Left
2: Right
3: Up
4: Down
5: Expandable Fullscreen
api Tablica liczb całkowitych Obsługiwane platformy interfejsów API

1: Left
2: Right
3: Up
4: Down
5: Expandable Fullscreen

id Ciąg znaków Identyfikator obiektu banera, który powinien być unikalny w przypadku wyświetlenia.

Zalecane, gdy obiekty banner są używane z obiektem wideo.

vcm Liczba całkowita

Dotyczy tylko banner używanego z obiektem wideo.

0: baner jest widoczny jednocześnie z kreacją wideo.
1: baner jest planszą końcową wyświetlaną po filmie.

Formatowanie obiektu

Pole Typ Szczegóły
w Liczba całkowita Szerokość w pikselach niezależnych od urządzenia (DIPS).
h Liczba całkowita Wysokość w pikselach niezależnych od urządzenia (DIPS).
wratio Liczba całkowita  Nieobsługiwane.
hratio Liczba całkowita  Nieobsługiwane.
wmin Liczba całkowita  Nieobsługiwane.

Obiekt wideo

Zdecydowanie zalecamy określenie miejsca docelowego reklamy wideo w pytaniu o stawkę. Brak pola miejsca docelowego jest klasyfikowany jako nieznane miejsce docelowe. Więcej informacji znajdziesz w artykule na temat kierowania na pozycję.

Pole Typ Szczegóły
mimes Tablica ciągów znaków Wymagany jest co najmniej 1 typ MIME.

video/flv lub video/x-f4v
video/mp4, video/x-mp4 lub application/mp4
video/webm lub video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg lub application/ogg
application/javascript lub application/x-javascript

minduration Liczba całkowita Minimalny czas trwania filmu w sekundach. Domyślnie nie ma minimalnego czasu trwania.
maxduration Liczba całkowita Maksymalny czas trwania filmu w sekundach. Domyślnie nie ma limitu.
protocols Tablica liczb całkowitych Wymagany jest co najmniej 1 obsługiwany protokół.

1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
9: DAAST 1.0
10: DAAST 1.0 Wrapper

w Liczba całkowita Szerokość odtwarzacza wideo w pikselach niezależnych od urządzenia (DIPS).
h Liczba całkowita Wysokość odtwarzacza wideo w pikselach niezależnych od urządzenia (DIPS).
startdelay Liczba całkowita Opóźnienie rozpoczęcia w sekundach w przypadku miejsc docelowych reklam przed filmem, w trakcie filmu lub po filmie.
placement Liczba całkowita Zdecydowanie zalecamy określenie w pytaniu o stawkę pola plcmt (lub) miejsca docelowego reklamy wideo. Brak obu tych pól spowoduje zaklasyfikowanie miejsca docelowego jako nieznanego.

0 (domyślnie): Nieznane
1: In-Stream
2: Baner
3: W artykule
4: W treści
5: Pływające

Uwaga: aby miejsce docelowe lub wyświetlenie reklamy wideo zostało uznane za In-Stream (miejsce docelowe lub typ miejsca docelowego 1), musi być ustawione na „dźwięk włączony” i prawidłowo sygnalizowane w metodzie odtwarzania (kwalifikują się wartości 1, 3, 4 i 5).
plcmt Liczba całkowita Zdecydowanie zalecamy określenie w pytaniu o stawkę pola plcmt (lub) miejsca docelowego reklamy wideo. Brak obu tych pól spowoduje zaklasyfikowanie miejsca docelowego jako nieznanego.

0 (domyślnie): Nieznany
1: In-Stream
2: Treści towarzyszące
3: Pełnoekranowa
4: Brak treści/samodzielna

Uwaga: aby miejsce docelowe lub wyświetlenie reklamy wideo zostało uznane za In-Stream (miejsce docelowe lub typ miejsca docelowego 1), musi być ustawione na „dźwięk włączony” i prawidłowo sygnalizowane w metodzie odtwarzania (kwalifikują się wartości 1, 3, 4 i 5).

Uwaga: jeśli podasz zarówno wartość plcmt, jak i placement, wartość plcmt będzie miała pierwszeństwo. Więcej informacji o migracji na plcmt znajdziesz w przewodniku IAB.

Uwaga: plcmt: Accompanying Content (2) jest traktowane jako placement: In Article (3)
plcmt: No Content/Standalone (4) jest traktowane jako placement: In feed (4)
placement: In Banner nie ma mapowania w plcmt
linearity Liczba całkowita  Nieobsługiwane.
skip Liczba całkowita Określa, czy odtwarzacz wideo zezwala na pominięcie reklamy.

0 (domyślnie): niemożliwa do pominięcia
1: możliwa do pominięcia
skipmin Liczba całkowita  Nieobsługiwane.
skipafter Liczba całkowita  Nieobsługiwane.
sequence Liczba całkowita Jeśli w tym samym pytaniu o stawkę oferowanych jest kilka wyświetleń reklamy, numer sekwencyjny umożliwi skoordynowane wyświetlanie wielu kreacji.
battr Tablica liczb całkowitych Zablokowane atrybuty kreacji.
maxextended Liczba całkowita Maksymalny czas trwania rozszerzonej reklamy wideo, jeśli rozszerzenie jest dozwolone.

0 (domyślnie): rozszerzenie jest niedozwolone
-1: rozszerzenie jest dozwolone i nie ma ograniczenia czasowego
>0: liczba sekund przedłużonego odtwarzania obsługiwana poza wartością maxduration.

minbitrate Liczba całkowita Minimalna szybkość transmisji bitów w kb/s.
maxbitrate Liczba całkowita Maksymalna szybkość transmisji bitów w kb/s.
boxingallowed Liczba całkowita Wskazuje, czy treść w formacie 4:3 może być wyświetlana w formacie 16:9

0: niedozwolone
1 (domyślnie): dozwolone
playbackmethod Tablica liczb całkowitych Metody odtwarzania, które mogą być używane. Jeśli nie określono żadnej metody, można użyć dowolnej.

0 (domyślne): nieznane
1: automatyczne odtwarzanie z włączonym dźwiękiem
2: automatyczne odtwarzanie z wyłączonym dźwiękiem
3: kliknij, aby odtworzyć
4: najechanie myszą
5: rozpoczęcie odtwarzania po wejściu w obszar widoczny z włączonym dźwiękiem
6: rozpoczęcie odtwarzania po wejściu w obszar widoczny z wyłączonym dźwiękiem

Uwaga: wszystkie wyświetlenia z domyślnie wyłączonym dźwiękiem (metoda odtwarzania 2, 6 lub 0) muszą sygnalizować miejsce docelowe typu Out-Stream 2, 3, 4 lub 5 (oRTB 2.5) albo podtyp miejsca docelowego 2, 3 lub 4.
playbackend Liczba całkowita Zdarzenie, które powoduje zakończenie odtwarzania.

1: zakończenie odtwarzania filmu lub przerwanie przez użytkownika
2: opuszczenie obszaru widocznego lub przerwanie przez użytkownika
3: po opuszczeniu obszaru widocznego film jest odtwarzany w pływającym okienku do momentu zakończenia odtwarzania lub przerwania przez użytkownika
delivery Tablica liczb całkowitych Obsługiwane metody dostarczania. Jeśli nie podasz żadnej wartości, założymy, że wszystkie są obsługiwane.

1: Streaming
2: Progressive
pos Liczba całkowita Pozycja reklamy na ekranie.

0 (domyślne): nieznane
1: nad linią podziału
2: nieobsługiwane: prawdopodobnie pod linią podziału
3: pod linią podziału
4: nagłówek
5: stopka
6: pasek boczny
7: pełny ekran
companionad Tablica Banner reklamy towarzyszące (jeśli są dostępne);
api Tablica liczb całkowitych

0 (domyślnie): Nieznany
1: VPAID 1
2: VPAID 2
3: MRAID 1
4: ORMMA
5: MRAID 2
6: MRAID 3
7: OMID 1 – wymagany do włączenia pomiarów za pomocą OMID w przypadku Widoku aktywnego.
8: SIMID 1
companiontype Tablica liczb całkowitych  Nieobsługiwane.
maxseq Liczba całkowita Maksymalna liczba reklam, które mają być zwracane w dynamicznym bloku reklamowym wideo.
poddur Tablica liczb całkowitych Maksymalna długość dynamicznego bloku reklamowego w sekundach.

Obsługiwane rozszerzenie obiektu wideo

Pole Typ Szczegóły
rewarded Liczba całkowita To pole wskazuje, czy żądania są nagradzane. Należy ją przesłać jako liczbę całkowitą.

0 (domyślnie): brak nagrody
1: nagroda

Obiekt audio

Pole Typ Szczegóły
mimes Tablica ciągów znaków Wymagany jest co najmniej 1 typ MIME.

audio/m4a, audio/mp4 lub audio/x-m4a
audio/mpeg lub audio/mp3
audio/ogg lub audio/x-ogg

minduration Liczba całkowita Minimalny czas trwania reklamy w sekundach.
maxduration Liczba całkowita Maksymalny czas trwania reklamy w sekundach.
protocols Tablica liczb całkowitych

3: VAST 3.0
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
startdelay Liczba całkowita Opóźnienie rozpoczęcia w sekundach w przypadku miejsc docelowych przed filmem, w trakcie filmu lub po filmie.

-2: Reklama po filmie
-1: Reklama w trakcie filmu
0: Reklama przed filmem
>0: Reklama w trakcie filmu

sequence Liczba całkowita  Nieobsługiwane.
battr Tablica liczb całkowitych  Nieobsługiwane.
maxextended Liczba całkowita  Nieobsługiwane.
minbitrate Liczba całkowita Minimalna szybkość transmisji bitów w kb/s.
maxbitrate Liczba całkowita Maksymalna szybkość transmisji bitów w kb/s.
delivery Tablica liczb całkowitych  Nieobsługiwane.
companionad Tablica obiektów banera dowolne miejsca na kreacje towarzyszące w formie banerów;
api Tablica liczb całkowitych Lista obsługiwanych platform API w przypadku tego wyświetlenia.

7: Omid V1

companiontype Tablica liczb całkowitych  Nieobsługiwane.
maxseq Tablica liczb całkowitych  Nieobsługiwane.
feed Liczba całkowita Typ pliku danych audio.

1: Usługa muzyczna
2: Transmisja
3: Podcast

stitched Liczba całkowita  Nieobsługiwane.
nvol Liczba całkowita  Nieobsługiwane.

Obiekt natywny

Więcej informacji znajdziesz w specyfikacjach reklam natywnych DV360.

Pole Typ Szczegóły
request Ciąg znaków Ciąg znaków zakodowany w natywnym obiekcie JSON.
ver Ciąg znaków 1.0: Nieobsługiwane
1.1: Nieobsługiwane
1.2
api Tablica liczb całkowitych Lista obsługiwanych platform API w przypadku tego wyświetlenia.

7: Omid V1

battr Tablica liczb całkowitych  Nieobsługiwane.

Obiekt PMP

Pole Typ Szczegóły
private_auction Liczba całkowita 0 (Domyślnie): wszystkie stawki są dozwolone
1: tylko transakcje
deals Tablica obiektów umowy Okazje do uwzględnienia.

Obiekt transakcji

Pole Typ Szczegóły
id Ciąg znaków Obiekt PMP nie może zawierać więcej niż 1 obiektu umowy na identyfikator.
bidfloor Liczba zmiennoprzecinkowa Minimalna stawka za to wyświetlenie w CPM.

Wymagany, jeśli at=3.

bidfloorcur Ciąg znaków Waluta określona za pomocą kodów ISO-4217.

Jeśli nie zostanie określona, domyślnie przyjmuje walutę żądania stawki.

at Liczba całkowita Jeśli nie zostanie określony, domyślnie pasuje do bid_request.at.

1: Aukcja pierwszej ceny
2: Aukcja drugiej ceny
3: Stała cena

wseat Tablica ciągów znaków Identyfikatory partnerów, którzy kwalifikują się do umowy.

Brak miejsc siedzących oznacza brak ograniczeń dotyczących miejsc siedzących.

wadomain Tablica ciągów znaków Dozwolone domeny reklamodawców, którzy mogą uczestniczyć w aukcji w ramach tej umowy.

Brak miejsc oznacza brak ograniczeń dotyczących domeny.

guar Liczba całkowita To pole wskazuje, czy umowa jest umową gwarantowaną. Należy ją przesłać jako liczbę całkowitą.

Aby DV360 akceptowało umowy gwarantowane, giełda musi być na liście dozwolonych. Aby poprosić o dodanie na tę listę, skontaktuj się z nami.

Jeśli Twoja giełda korzysta obecnie z innego mechanizmu sygnalizowania transakcji gwarantowanych w DV360, skontaktuj się z nami, aby omówić przejście na to preferowane rozszerzenie.

0 (domyślnie): niegwarantowane
1: gwarantowane

ext Rozszerzenia z ofertami Opcjonalnie.

Obsługiwane rozszerzenie obiektu umowy

Pole Typ Szczegóły
guaranteed Liczba całkowita To pole wskazuje, czy umowa jest umową gwarantowaną. Należy ją przesłać jako liczbę całkowitą.

Aby DV360 akceptowało umowy gwarantowane, giełda musi być na liście dozwolonych. Aby poprosić o dodanie na tę listę, skontaktuj się z nami.

Jeśli Twoja giełda korzysta obecnie z innego mechanizmu sygnalizowania transakcji gwarantowanych w DV360, skontaktuj się z nami, aby omówić przejście na to preferowane rozszerzenie.

0 (domyślnie): niegwarantowane
1: gwarantowane

Zamiast tego pola zalecamy użycie deal.guar.

Obiekt witryny

Pole Typ Szczegóły
id Ciąg znaków Identyfikator witryny na giełdzie.
name Ciąg znaków  Nieobsługiwane.
domain Ciąg znaków Domena witryny.

Zalecamy przesyłanie pełnego adresu URL w parametrze site.page zamiast wypełniania tylko parametru site.domain.

cat Tablica ciągów znaków  Nieobsługiwane.
sectioncat Tablica ciągów znaków  Nieobsługiwane.
pagecat Tablica ciągów znaków  Nieobsługiwane.
page Ciąg znaków Pełny adres URL, pod którym ma się wyświetlać wyświetlenie.

Na potrzeby kierowania zalecamy przesyłanie pełnego adresu URL.

ref Ciąg znaków Adres URL strony odsyłającej, który spowodował przejście na bieżącą stronę.
search Ciąg znaków  Nieobsługiwane.
mobile Liczba całkowita  Nieobsługiwane.
privacypolicy Liczba całkowita  Nieobsługiwane.
publisher Obiekt wydawcy Szczegółowe informacje o wydawcy witryny.
content Obiekt treści Szczegóły dotyczące treści w witrynie.
keywords Ciąg tekstowy (format CSV)  Nieobsługiwane.
ext Rozszerzenia witryn Rozszerzenia obiektu witryny.

Obiekt rozszerzenia witryny

Pole Typ Szczegóły
inventorypartnerdomain Ciąg znaków Używany do udostępniania zasobów reklamowych na urządzenia CTV. Więcej informacji znajdziesz w wyjaśnieniu dotyczącym plików app-ads.txt w aplikacjach na urządzenia CTV.

Obiekt aplikacji

Pole Typ Szczegóły
id Ciąg znaków Identyfikator aplikacji na giełdzie.
name Ciąg znaków Nazwy aplikacji, które na prośbę wydawców mogą być zastępowane aliasami.

Nazwy aplikacji w przypadku żądań bez pakietu SDK (głównie z urządzeń multimedialnych z internetem) mogą być podawane przez wydawcę bezpośrednio w żądaniu.

bundle Ciąg znaków Wymagane.

W przypadku iOS musi to być numeryczny identyfikator sklepu z aplikacjami. Nie akceptujemy identyfikatora pakietu w stylu odwrotnego DNS.

W przypadku aplikacji na urządzenia CTV zalecamy przekazywanie identyfikatora aplikacji zdefiniowanego przez sklep. Przestrzegaj opublikowanych niedawno wytycznych IAB dotyczących identyfikatorów przypisywanych przez sklepy operatorów OTT/CTV.

domain Ciąg znaków Domena, np. mygame.foo.com
storeurl Ciąg znaków Wymagany do weryfikacji pliku app-ads.txt i sprawdzania poprawności sklepu z aplikacjami na telewizory Smart TV.
cat Tablica ciągów znaków  Nieobsługiwane.
sectioncat Tablica ciągów znaków  Nieobsługiwane.
pagecat Tablica ciągów znaków  Nieobsługiwane.
ver Ciąg znaków  Nieobsługiwane.
privacypolicy Liczba całkowita  Nieobsługiwane.
paid Liczba całkowita  Nieobsługiwane.
publisher Obiekt wydawcy Informacje o wydawcy aplikacji.
content Obiekt treści Informacje o zawartości aplikacji.
keywords Ciąg znaków (format CSV)  Nieobsługiwane.
ext Rozszerzenia aplikacji Rozszerzenia obiektu aplikacji.

Obiekt rozszerzenia aplikacji

Pole Typ Szczegóły
inventorypartnerdomain Ciąg znaków Używany do udostępniania zasobów reklamowych na urządzenia CTV. Więcej informacji znajdziesz w wyjaśnieniu dotyczącym plików app-ads.txt w aplikacjach na urządzenia CTV.

Obiekt treści

Zalecamy przekazywanie tych atrybutów, jeśli są dostępne.

Pole Typ Szczegóły
id Ciąg znaków Identyfikator jednoznacznie określający treści.
episode Liczba całkowita Numer odcinka treści (zwykle w przypadku treści wideo).
title Ciąg znaków Zalecane w przypadku żądań dotyczących CTV, wideo i audio.
series Ciąg znaków Zalecane w przypadku żądań dotyczących CTV, wideo i audio.
season Ciąg znaków Etykieta sezonu treści.
artist Ciąg znaków Wykonawca, któremu przypisane są treści.
genre Ciąg znaków Gatunek, który najlepiej opisuje treści. DV360 zaleca podawanie tego sygnału w przypadku zapytań dotyczących CTV, wideo i audio.
DV360 obsługuje w tym polu kilka taksonomii wartości gatunków wideo:
  • Lista gatunków Google (Pobierz)
  • Kategorie IAB TV/Film/Sport (Pobierz)
  • Taksonomia gatunków wideo Gracenote firmy Nielsen
album Ciąg znaków Album, do którego należą treści, zwykle w przypadku treści audio.
isrc Ciąg znaków Kod ISRC zgodny z normą ISO-3901.
producer Obiekt producenta Szczegóły dotyczące producenta treści.
url Ciąg znaków Adres URL treści.
cat Tablica ciągów znaków Kategorie treści IAB opisujące treści.
prodq Liczba całkowita Jakość produkcji:

0 (domyślnie): nieznane
1: profesjonalne
2: półprofesjonalne
3: wygenerowane przez użytkownika

videoquality Liczba całkowita  Nieobsługiwane.
context Liczba całkowita Typ treści:

1: Film
2: Gra
3: Muzyka
4: Aplikacja
5: Tekst
6: Inne
7: Nieznane

contentrating Ciąg znaków Zalecane w przypadku treści audio i wideo/CTV, ponieważ zaczniemy podejmować decyzje na podstawie tego atrybutu.
userrating Ciąg znaków Liczba gwiazdek, polubień itp.
qagmediarating Liczba całkowita Ocena mediów zgodnie z [wytycznymi QAG](http://www.iab.net/ne_guidelines).

1: Wszyscy odbiorcy
2: 12+
3: Od 17 lat

keywords Ciąg znaków (format CSV)  Nieobsługiwane.
livestream Liczba całkowita czy treści są transmitowane na żywo;

0: nie na żywo
1: treści na żywo

sourcerelationship Liczba całkowita

0: Pośredni
1: Bezpośredni

len Liczba całkowita Długość treści w sekundach.

Zalecane w przypadku żądań dotyczących CTV/wideo i audio.

language Ciąg znaków (ISO-639-1-alpha-2) Język treści.
embeddable Liczba całkowita Wskaźnik określający, czy treści można osadzać (np.odtwarzacz wideo, który można osadzić).

0: Nie można umieścić
1: Można umieścić

data Tablica obiektów danych Dodatkowe dane.

Obiekt producenta

Pole Typ Szczegóły
id Ciąg znaków  Nieobsługiwane.
name Ciąg znaków  Nieobsługiwane.
cat Tablica ciągów znaków  Nieobsługiwane.
domain Ciąg znaków Domena najwyższego poziomu producenta.

Obiekt danych

Pole Typ Szczegóły
id Ciąg znaków Identyfikator dostawcy danych.
name Ciąg znaków Nazwa giełdy dostawcy danych.
segment Tablica obiektów Segment Rzeczywiste wartości danych.
ext Rozszerzenia o dane Rozszerzenia obiektu Data.

Obsługiwane rozszerzenia obiektu danych

Pole Typ Szczegóły
segtax Liczba całkowita Identyfikator taksonomii. Więcej informacji znajdziesz w sekcji Taksonomie segmentów.
segclass Ciąg znaków Wersja klasyfikatora, która wygenerowała identyfikatory segmentów w taksonomii.

Obiekt segmentu

Pole Typ Szczegóły
id Ciąg znaków Identyfikator segmentu danych specyficzny dla dostawcy danych.
name Ciąg znaków Nazwa segmentu danych.
value Ciąg znaków Wartość segmentu danych.

Obiekt wydawcy

Pole Typ Szczegóły
id Ciąg znaków Wymagane.
name Ciąg znaków  Nieobsługiwane.
cat Tablica ciągów znaków  Nieobsługiwane.
domain Ciąg znaków  Nieobsługiwane.

Obiekt urządzenia

Pole Typ Szczegóły
ua Ciąg znaków Wymagane.
sua Obiekt UserAgent Ustrukturyzowane informacje o kliencie użytkownika.
geo Obiekt geograficzny Lokalizacja urządzenia.
dnt Liczba całkowita Flaga „Nie śledź” ustawiona w nagłówku przeglądarki.

0: śledzenie jest nieograniczone
1: nie śledź

lmt Liczba całkowita Sygnał ograniczenia śledzenia reklam jest zatwierdzony komercyjnie.

0: śledzenie bez ograniczeń
1: śledzenie musi być ograniczone zgodnie z wytycznymi dotyczącymi reklam

ip Ciąg znaków Wymagany w przypadku adresu IPv4.

Jeśli adres IP jest skrócony, musi być zadeklarowany w device.ext.truncated_ip.

ipv6 Ciąg znaków Wymagany w przypadku protokołu IPv6.

Jeśli adres IP jest skrócony, musi być zadeklarowany w device.ext.truncated_ip.

devicetype Liczba całkowita Zalecane w przypadku wszystkich typów zasobów reklamowych. Służy do ulepszania rozpoznawania typu urządzenia.
make Ciąg znaków
model Ciąg znaków
os Ciąg znaków System operacyjny urządzenia.

ios: w przypadku żądania aplikacji identyfikuje ruch z systemu iOS.
android: Identyfikuje urządzenie z Androidem, jeśli nie można go zidentyfikować za pomocą parametrów ua lub sua.
[anything else]: używany w diagnostyce do izolowania problemów.

W tym polu nie jest rozróżniana wielkość liter.

osv Ciąg znaków  Nieobsługiwane.
hwv Ciąg znaków Wersja sprzętowa urządzenia.
h Liczba całkowita Fizyczna wysokość ekranu w pikselach.
w Liczba całkowita Fizyczna szerokość ekranu w pikselach.
ppi Liczba całkowita  Nieobsługiwane.
pxratio Liczba zmiennoprzecinkowa Stosunek pikseli fizycznych do pikseli niezależnych od urządzenia.
js Liczba całkowita  Nieobsługiwane.
geofetch Liczba całkowita  Nieobsługiwane.
flashver Ciąg znaków  Nieobsługiwane.
language Ciąg znaków (ISO-639-1-alpha-2) Język urządzenia.
carrier Ciąg znaków  Nieobsługiwane.
mccmnc Ciąg znaków  Nieobsługiwane.
connectiontype Liczba całkowita Typ połączenia sieciowego
ifa Ciąg znaków Identyfikator, którego reklamodawca może używać w formie niezaszyfrowanej.
didsha1 Ciąg znaków  Nieobsługiwane.
didmd5 Ciąg znaków  Nieobsługiwane.
dpidsha1 Ciąg znaków  Nieobsługiwane.
dpidmd5 Ciąg znaków  Nieobsługiwane.
macsha1 Ciąg znaków  Nieobsługiwane.
macmd5 Ciąg znaków  Nieobsługiwane.
ext Rozszerzenia urządzeń Rozszerzenia obiektu urządzenia.

Obsługiwane rozszerzenie obiektu urządzenia

Jeśli parametr ip zostanie zmieniony lub skrócony, zdecydowanie zalecamy wysyłanie tych rozszerzeń, aby zapobiec uznaniu ruchu za nieprawidłowy.

Pole Typ Szczegóły
truncated_ip Liczba całkowita Określ, czy adres IP w polu device.ip pytania o stawkę jest obcięty.

0: Nieobcięte
1: Obcięte

Domyślnie nie jest skracany. Jest wymagany, jeśli adres IP jest skrócony.

Jeśli nie zostanie zadeklarowany, może zostać sklasyfikowany jako nieprawidłowy ruch.

ifa_type Ciąg znaków Wskazuje pochodzenie pola device.ifa, czyli czy zostało ono dostarczone z samego urządzenia, czy wygenerowane przez wydawcę lub platformę SSP w łańcuchu dostaw.

aaid: Android TV
rida: Roku
afai: Amazon Fire
idfa: Apple tvOS
msai: Xbox/Microsoft
dpid: Ogólny identyfikator platformy urządzenia
ppid: Identyfikator podany przez wydawcę
sspid: Identyfikator podany przez platformę SSP
sessionid: Krótkotrwały identyfikator sesji (tylko w przypadku ograniczenia liczby wyświetleń)

attestation_token Ciąg znaków (kodowanie Base64) token atestu urządzenia w przypadku giełd, które obsługują ten poziom weryfikacji urządzenia.
atts Liczba całkowita (Tylko iOS) Liczba całkowita przekazywana w celu przedstawienia stanu autoryzacji śledzenia aplikacji.

0: Nie określono
1: Ograniczony
2: Odmowa
3: Autoryzowany

cdep Ciąg znaków Etykieta wycofania plików cookie innych firm w Chrome.

Zobacz testowanie ułatwione przez Chrome i  specyfikację społeczności IAB.

Obiekt UserAgent

Pole Typ Szczegóły
browsers Tablica obiektów BrandVersion Każdy obiekt BrandVersion identyfikuje przeglądarkę lub podobny komponent oprogramowania.
platform Obiekt BrandVersion Identyfikuje platformę.
mobile Liczba całkowita 0 (domyślnie): agent preferuje treści „na komputery” lub „pełne”.
1: agent preferuje treści „mobilne”.
architecture Ciąg znaków Architektura urządzenia, np. „x86” lub „arm”.
bitness Ciąg znaków Bity urządzenia, np. „64” w przypadku architektury 64-bitowej.
model Ciąg znaków Model urządzenia.
source Liczba całkowita Źródło danych użytych do utworzenia tego obiektu. Więcej informacji znajdziesz w  Liście: Źródło User-Agent. Zalecane w przypadku przekazywania obiektu UserAgent.

Obiekt BrandVersion

Pole Typ Szczegóły
brand Ciąg znaków Identyfikator marki, np. „Chrome” lub „Windows”. Wymagane.
version Tablica ciągów znaków Ciąg komponentów wersji w kolejności malejącej (główna, podrzędna, mikro itd.).

Obiekt geograficzny

Pole Typ Szczegóły
lat Liczba zmiennoprzecinkowa  Nieobsługiwane.
lon Liczba zmiennoprzecinkowa  Nieobsługiwane.
type Liczba całkowita  Nieobsługiwane.
accuracy Liczba całkowita  Nieobsługiwane.
lastfix Liczba całkowita  Nieobsługiwane.
ipservice Liczba całkowita  Nieobsługiwane.
country Ciąg znaków  Nieobsługiwane.
region Ciąg znaków  Nieobsługiwane.
regionfips104 Ciąg znaków  Nieobsługiwane.
metro Ciąg znaków  Nieobsługiwane.
city Ciąg znaków  Nieobsługiwane.
zip Ciąg znaków  Nieobsługiwane.
utcoffset Liczba całkowita  Nieobsługiwane.

Obiekt użytkownika

Pole Typ Szczegóły
id Ciąg znaków Obsługiwane, jeśli Google hostuje tabelę odpowiedników identyfikatorów.
buyeruid Ciąg znaków Obsługiwane, jeśli platforma SSP hostuje tabelę odpowiedników identyfikatorów.
yob Liczba całkowita Zalecane w przypadku kierowania demograficznego.
gender Ciąg znaków Zalecane w przypadku kierowania demograficznego.
keywords Ciąg znaków (CSV)  Nieobsługiwane.
customdata Ciąg znaków  Nieobsługiwane.
geo Obiekt geograficzny  Nieobsługiwane.
data Tablica obiektów danych Dodatkowe dane.
eids Tablica obiektów identyfikatora rozszerzonego Instancje identyfikatora rozszerzonego podawane przez giełdę.
ext Rozszerzenia dotyczące użytkowników Rozszerzenia obiektu użytkownika.

Obsługiwane rozszerzenia obiektu użytkownika

Pole Typ Szczegóły
consent Ciąg znaków (bezpieczny w internecie format Base64) Ciąg znaków zgody na wykorzystanie danych (IAB).

Zawiera metadane dotyczące informacji, na których zbieranie użytkownik wyraził zgodę, oraz firm, które mogą ich używać.

Wartość jest ciągiem binarnym zakodowanym w bezpiecznym dla sieci formacie base64 przy użyciu niestandardowego formatu binarnego.

us_privacy Ciąg znaków Czy użytkownik widział informacje o zgodności z CCPA lub podobnymi przepisami.
consented_providers_settings.consented_providers Obiekt zewnętrzny (consented_providers_settings) zawierający wewnętrzną tablicę liczb całkowitych (consented_providers). Gdy zgoda na wykorzystanie danych zgodnie z RODO jest uzyskiwana za pomocą zasad TCF, to pole zawiera listę dostawców technologii reklamowych, na których wykorzystanie danych użytkownicy wyrazili zgodę, a którzy nie uczestniczą w zasadach TCF. Zobacz specyfikację techniczną Google o nazwie „Udzielenie dodatkowej zgody”.
eids Tablica obiektów identyfikatora rozszerzonego Instancje identyfikatora rozszerzonego podawane przez giełdę.

Obiekt rozszerzonego identyfikatora

Pole Typ Szczegóły
source Ciąg znaków Dostawca identyfikatora
uids Tablica obiektów identyfikatora UID rozszerzonego rzeczywiste identyfikatory,

Obiekt rozszerzonego identyfikatora UID

Pole Typ Szczegóły
id Ciąg znaków sam identyfikator.
atype Liczba całkowita Typ klienta użytkownika powiązany z tym identyfikatorem.

Obiekt łańcucha dostaw

Pole Typ Szczegóły
complete Liczba całkowita 0 (domyślnie): łańcuch dostaw jest niekompletny.
1: łańcuch dostaw jest kompletny aż do wydawcy.
ver Ciąg znaków Wymagane.
Wartość jest sformatowana jako „major.minor”, np. wersja 1.0 to ciąg znaków „1.0”.
nodes Tablica węzłów łańcucha dostaw Wymagane.

W pełnym łańcuchu dostaw pierwszy węzeł reprezentuje początkowy system reklamowy i identyfikator sprzedawcy zaangażowane w transakcję, czyli właściciela witryny, aplikacji lub innego medium.

W niepełnym łańcuchu dostaw jest to pierwszy znany węzeł. Ostatni węzeł reprezentuje podmiot wysyłający to pytanie o stawkę.

Obiekt węzła łańcucha dostaw

Pole Typ Szczegóły
asi Ciąg znaków Kanoniczna nazwa domeny w systemie platformy SSP, giełdy, elementu pozycjonującego nagłówka itd., z którym łączą się licytujący. Może to być operacyjna domena systemu, jeśli różni się ona od nadrzędnej domeny firmowej. Ułatwi to wyszukiwanie informacji WHOIS i odwrotne sprawdzanie adresu IP w celu jednoznacznego ustalenia, kto jest właścicielem systemu delegowanego.

Powinna to być ta sama wartość, która jest używana do identyfikowania sprzedawców w pliku ads.txt, jeśli taki plik istnieje.

sid Ciąg znaków Identyfikator powiązany z kontem sprzedawcy w systemie reklamowym. Musi zawierać tę samą wartość, która jest używana w transakcjach (np. w pytaniach o stawkę OpenRTB) w polu określonym przez platformę SSP lub giełdę.

W systemie OpenRTB jest to zazwyczaj publisher.id. W obiekcie OpenDirect jest to zwykle identyfikator organizacji wydawcy.

Nie powinna przekraczać 64 znaków.

rid Ciąg znaków Identyfikator żądania OpenRTB wydany przez tego sprzedawcę.
name Ciąg znaków Nazwa firmy (osoby prawnej), która otrzymuje płatności za zasoby reklamowe sprzedawane pod danym identyfikatorem sprzedawcy.

Ta wartość jest opcjonalna i NIE powinna być uwzględniana, jeśli występuje w pliku sellers.json systemu reklamowego.

domain Ciąg znaków Nazwa domeny firmy reprezentowanej przez ten węzeł.

Ta wartość jest opcjonalna i NIE powinna być uwzględniana, jeśli znajduje się w pliku sellers.json systemu reklamowego.

hp Liczba całkowita Wskazuje, czy ten węzeł będzie uczestniczyć w przepływie płatności za zasoby reklamowe.

1: System reklamowy w polu asi płaci sprzedawcy w polu sid, który jest odpowiedzialny za zapłatę poprzedniemu węzłowi w łańcuchu.
0: ten węzeł nie jest zaangażowany w przepływ płatności za zasoby reklamowe.

W przypadku wersji 1.0 specyfikacji SupplyChain ta właściwość powinna zawsze mieć wartość 1. Jest to wyraźnie wymagane, ponieważ oczekuje się, że przyszłe wersje specyfikacji wprowadzą węzły obsługi inne niż płatności.

Wdrażający powinni zadbać o obsługę tego pola i przekazywanie go dalej podczas tworzenia obiektów SupplyChain w pytaniach o stawkę wysyłanych do systemu reklamowego niższego szczebla.

Specyfikacja odpowiedzi na stawkę

Obiekt BidResponse

Atrybut Obsługiwane Szczegóły implementacji Zawsze zaliczony
id Jeśli wystąpi błąd analizowania, zamiast identyfikatora żądania reklamy może pojawić się wartość „0”. Tak
seatbid
bidid
cur Jeśli wystąpi błąd analizowania, nie zostanie on przekazany. W przypadku prawidłowego ruchu związanego z pytaniami o stawkę zawsze podawana jest waluta. Tak
customdata
nbr Jest to uwzględniane tylko wtedy, gdy w żądaniu stawki wykryto problem. Możliwe wartości to:
2: Nieprawidłowe żądanie
12: Naruszenie autoryzacji ads.txt
16: Niekompletny łańcuch dostaw
17: Zablokowany węzeł łańcucha dostaw
Uwaga: gdy zostanie wykryte konkretne naruszenie pliku (app-)ads.txt lub łańcucha dostaw, w części odpowiedzi (1%) pojawi się jeden z kodów 12, 16 lub 17. W przypadku wszystkich innych nieprawidłowych żądań zostanie wypełniony kod 2.
Żądania zawierające NBR będą wyglądać podobnie do tego: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
ext Jeśli wystąpi problem z żądaniem stawki, pole ext może zawierać informacje, które pomogą zdiagnozować błąd (jeśli jest to obsługiwane).

Obsługiwane rozszerzenia obiektu BidResponse

Atrybut Szczegóły implementacji
błąd

Zrozumiały dla człowieka opis błędu związanego z pytaniem o stawkę. Odpowiedzi mogą obejmować:

  • Treść pytania o stawkę była pusta.
  • Pytanie o stawkę nie było w walucie, która jest na liście dozwolonych walut dla danej giełdy.
  • Pytanie o stawkę nie zawierało akceptowanego typu MIME.
errHelp link do tej strony;

Obiekt Seatbid

Atrybut Obsługiwane Szczegóły implementacji Zawsze zaliczony
stawka tak
stanowisko tak
grupa

Obiekt stawki

Atrybut Obsługiwane Szczegóły implementacji Zawsze zaliczony
id tak
impid tak
cena tak
nurl
sęk
lurl
adm
adid
adomain
grupa
iurl
cid tak
crid tak
tactic
kot
atr
api
protokół
qagmediarating
language
dealid
tydz.
godz.
wratio
hratio
exp

Obsługiwane rozszerzenia obiektu stawki

Atrybut Szczegóły implementacji
apis DV360 wyśle seatbid.bid.apis, jeśli obsługiwane są zarówno OMID, jak i MRAID. DV360 ustawi zarówno OMID_1, jak i MRAID jako tablicę liczb całkowitych.

Opcje wyświetlania reklam

W sekcji 4.3 specyfikacji OpenRTB podano 2 różne opcje wyświetlania:

  • Znaczniki wyświetlane w powiadomieniu o wygranej
  • Znacznik został przesłany w odpowiedzi na pytanie o stawkę

DV360 obsługuje obie te opcje.

  • W przypadku reklamy banerowej DV360 zawsze zwraca kod w polu adm. Markup served on win notice jest opcjonalny.
  • W przypadku reklam wideo lub audio korzystających z protokołu VAST DV360 obsługuje zwracanie kodu XML VAST w polu adm lub w odpowiedzi na powiadomienie o wygranej aukcji na podstawie wymagań partnerów wymiany.

Aby poznać zalety i wady tych 2 opcji, zapoznaj się ze specyfikacją OpenRTB.

Sprawdzone metody

Zdecydowanie zalecamy używanie identyfikatora partnera w Display & Video 360 jako identyfikatora platformy. Nie zalecamy używania identyfikatora miejsca docelowego specyficznego dla giełdy.

Upewnij się, że wydawcy mają pliki ads.txt lub aplikacje z powiązanymi plikami app-ads.txt, a w tych plikach jesteś wymieniony jako autoryzowany sprzedawca lub odsprzedawca. Więcej informacji

Zadbaj też o to, aby w pytaniach o stawkę przekazywane były spójne informacje. Na przykład app.bundle musi być zgodny z informacjami o urządzeniu mobilnym i app.storeurl.

Urządzenia CTV

Podczas przekazywania wartości device.ifa i device.lmt przestrzegaj wytycznych IAB dotyczących identyfikatorów reklamy OTT. Aby zachować zgodność z wytycznymi, musisz też wdrożyć device.ext.ifa_type. Wszystkie nasze funkcje ograniczenia liczby wyświetleń i kierowania na odbiorców w przypadku telewizji CTV będą wymagać identyfikatora IFA.

Postępuj też zgodnie z opublikowanymi niedawno wytycznymi IAB dotyczącymi identyfikatorów przypisywanych przez sklepy operatorów OTT/CTV. Określają one, w jaki sposób należy przekazywać parametr app.bundle w przypadku aplikacji na telewizory Smart TV – w dużej mierze za pomocą identyfikatora zdefiniowanego przez sklep z aplikacjami.

Pomiar w Widoku aktywnym

Widok aktywny to technologia Google służąca do pomiaru, czy wyświetlenie było widoczne i jak długo. Widok aktywny korzysta z OMID w przypadku reklam displayowych i reklam wideo. Aby włączyć pomiary za pomocą OMID, giełdy muszą dodać te pola do żądań OpenRTB, aby DV360 wiedział, że klient obsługuje OMID.

  • Wymagane: dodaj do żądań stawek platformę interfejsu API (Video.api=7 w przypadku OMSDK). Jest to obowiązkowe, aby Widok aktywny mógł przeprowadzać pomiary za pomocą OMID.
  • Zalecane: dodanie parametrów omidpn i omidpv do Source.Ext jest wysoce zalecane, ponieważ wpłynie na sposób raportowania pomiarów widoczności w DV360 klientowi. Jeśli nazwa partnera OMID nie znajduje się na liście certyfikatów IAB, musimy zgodnie z wymaganiami MRC raportować dane o widoczności oddzielnie od danych certyfikowanych przez MRC. Więcej informacji

Najczęstsze pytania

Czy DV360 obsługuje niestandardowe rozszerzenia giełdy?
Tak. Oprócz rozszerzeń wymienionych w tej specyfikacji Display & Video 360 może też obsługiwać rozszerzenia niestandardowe w zależności od konkretnego przypadku. Zalecamy określenie i przetestowanie niestandardowego rozszerzenia w okresie integracji.
Czy DV360 obsługuje reklamy wideo z nagrodą?
Tak, prześlij nam rozszerzenie reklamy wideo z nagrodą.
Wiele moich zasobów reklamowych jest oznaczonych jako „Dane demograficzne nieznane”. Jak mogę zwiększyć pokrycie demograficzne?
Wypełniaj pola user.yob i user.gender w pytaniach o stawkę wysyłanych do DV360, aby zwiększyć zasięg.
Czy DV360 ma punkty końcowe w każdym regionie?
Nie, używamy jednego punktu końcowego na całym świecie i automatycznie kierujemy żądania do najbliższego centrum danych, więc nie możemy udostępnić punktu końcowego dla konkretnego regionu.
Jakie są wymagania dotyczące żądań między serwerami?
Skontaktuj się z nami, aby poprosić o dodanie do listy dozwolonych. Należy przekazać klienta użytkownika i upewnić się, że w odpowiedzi na pobranie VAST typu s2s pliki cookie są wyłączone lub ignorowane.
Czy DV360 obsługuje OMID?
Możemy mierzyć widoczność za pomocą OMID, o ile w momencie wysłania prośby o stawkę zostanie zadeklarowane, że jest on włączony. Szczegółowe informacje na ten temat znajdziesz na stronach 24–25.
Którą wersję Native obsługujesz? Czy masz jakieś wymagania dotyczące reklam natywnych?
Obsługujemy tylko format natywny w wersji 1.2. Specyfikacja reklam natywnych.
Czy DV360 obsługuje pytania o stawkę wysyłane w formacie GZIP?
DV360 może otrzymywać skompresowane za pomocą gzipa żądania stawek i odpowiadać skompresowanymi za pomocą gzipa odpowiedziami, jeśli nagłówek Accept-Encoding wskazuje, że jest to obsługiwane.
Czy DV360 obsługuje DBURL?
Obecnie nie.
Czy DV360 obsługuje powiadomienia o wygranych i przegranych aukcjach?
Obecnie nie. Jeśli uważasz, że powinniśmy obsługiwać tę funkcję, skontaktuj się z nami i podaj więcej szczegółów.
Czy DV360 wymaga nazwy aplikacji do kierowania?
Nie, DV360 używa nazwy aplikacji jako odniesienia, ale nie jest ona wymagana do kierowania.App.bundle
Czy DV360 obsługuje wiele rozmiarów reklam wysyłanych w jednym pytaniu o stawkę?
Tak, w parametrze banner.format uwzględnimy wszystkie kwalifikujące się rozmiary kreacji w reklamie banerowej.
Czy DV360 obsługuje wiele formatów reklam w tym samym pytaniu o stawkę?
Obsługa pytań o stawkę w wielu formatach jest ograniczona, ale pracujemy nad jej ulepszeniem. Obsługujemy formaty displayowe i wideo w przypadku reklam pełnoekranowych, ale obecnie nie obsługujemy formatów displayowych i natywnych. Jeśli wysyłasz pytania o stawkę z wieloma formatami reklam, skontaktuj się z nami, aby poprosić o przeprowadzenie testu.
Czy DV360 obsługuje w tym samym żądaniu różne typy wyświetleń?
Obecnie obsługujemy tylko pełnoekranowe reklamy wideo i banerowe. Pracujemy nad reklamami natywnymi/banerowymi i wideo/banerowymi. Jeśli znasz inne kombinacje, skontaktuj się z naszym zespołem.
Czy w ramach tego samego żądania wiele platform może wysyłać wiele stawek dotyczących co najmniej 1 takiej możliwości wyświetlenia?
Tak.
Czy DV360 ma rozwiązanie lub szczególną potrzebę w zakresie ograniczania lub wyświetlania tego samego reklamodawcy w przypadku wielu takich możliwości wyświetlenia w tym samym żądaniu?
DV360 egzekwuje zasadę, że reklamodawca może licytować maksymalnie 1 wyświetlenie w przypadku każdego żądania. Oczekujemy, że platformy SSP będą grupować obiekty imp w sposób logiczny, np. wszystkie na tej samej stronie, wszystkie w tej samej aplikacji itp.
Czy DV360 obsługuje wiele wyświetleń w tym samym pytaniu o stawkę?
DV360 obsługuje obecnie obiekty audio z wieloma wyświetleniami. Musimy jednak przetestować i włączyć każdą giełdę, która chce korzystać z tej funkcji. Więcej informacji znajdziesz w specyfikacji żądania stawki. Pracujemy nad rozszerzeniem tej funkcji na inne formaty: 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Skontaktuj się z nami

Jeśli masz pytania lub problemy, skontaktuj się z naszym zespołem pomocy ds. giełdy.