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. O ile nie podano inaczej, postępuj też zgodnie z wytycznymi przedstawionymi w specyfikacji OpenRTB.

Niektóre pola nie są obsługiwane, ale są nadal analizowane. Te pola muszą być prawidłowo sformatowane, ale nie będą miały 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 kod HTTP 204 bez treści w przypadku braku oferty lub kod HTTP 200 z treścią w postaci odpowiedzi na pytanie o stawkę.

Jeśli żądanie stawki 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

Jeśli nie podano akceptowanego typu MIME, używany jest format domyślny.

Żą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 pytanie o stawkę jest w formacie JSON, Accept: application/json wskazuje, że odpowiedzi na pytanie o stawkę 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 żądania stawki. 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 Wymagane 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ślna): aukcja z ceną drugą, w której reklamodawca płaci kwotę nieco wyższą od stawki zaoferowanej przez licytującego, który zajął drugie miejsce.
3: cena minimalna jest podana w żądaniu i nie ma nic wspólnego ze stawkami konkurencyjnymi.
tmax Liczba całkowita Opcjonalne, domyślnie niestandardowe dla każdej integracji.
wseat Tablica tekstowa Lista dozwolonych stanowisk kupującego.
Zalecane, chyba że wszyscy reklamodawcy mogą składać oferty.
Brak ustawienia oznacza brak ograniczeń.
bseat Tablica tekstowa Lista kont 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 tekstowa

Opcjonalne, ale zdecydowanie zalecane. Domyślnie jest to jedna integracja.

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 tekstowa  Nieobsługiwane.
bcat Tablica tekstowa Zablokowane kategorie reklamodawców na podstawie kategorii treści IAB.
Nieskonfigurowana oznacza brak zablokowanych kategorii.
badv Tablica tekstowa Określ zablokowanego reklamodawcę na podstawie domeny podanej przez reklamodawcę.
Wartość „Unset” oznacza brak zablokowanych reklamodawców.
bapp Tablica tekstowa  Nieobsługiwane.
source Źródło Wymagane w przypadku schain.
regs Regs Opcjonalnie:
ext Rozszerzenia pytań 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): Nieokreślone – 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 SDK do reklam mobilnych Google, w innych przypadkach zabronione.
disable_gma_format int Opcjonalne, jeśli podano właściwość gdemsignals, w przeciwnym razie zabronione.
0 (domyślne): gdy pole gdemsignals jest wypełnione, odpowiedź na pytanie o stawkę adm jest blokiem JSON.
1: Zamiast bloba 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 niemal 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” obiektu 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 zamiast tego używaj pola schain w źródle.

Obiekt Regs

Pole Typ Szczegóły
coppa Liczba całkowita 0 (domyślnie): COPPA nie dotyczy tego żądania.
1: to żądanie podlega ustawie COPPA.
gdpr Ciąg znaków Flaga wskazująca, czy żądanie podlega przepisom RODO: 0 – nie, 1 – tak. Pominięcie oznacza, że stan jest nieznany. Więcej informacji znajdziesz w dokumentacji DV360 dotyczącej RODO. Oczekiwana jest tylko jedna z tych wartości: regs.gdpr lub regs.ext.gdpr.
us_privacy Ciąg znaków Przekazuje sygnały dotyczące prywatności konsumentów zgodnie z amerykańskimi przepisami o ochronie prywatności. Zapoznaj się ze specyfikacjami ciągu tekstowego dotyczącymi prywatności w Stanach Zjednoczonych. Gdy w pytaniu o stawkę otrzymamy ciąg tekstowy us_privacy, a ciąg tekstowy IAB wskazuje, że użytkownik zrezygnował z personalizacji, Display & Video 360 uzna to pytanie za niekwalifikujące się do określania stawek za reklamy spersonalizowane. Nie przesyłamy sygnału IAB do innych dostawców.

Oczekiwana jest tylko jedna z tych wartości: regs.us_privacy, user.us_privacy i user.ext.us_privacy.
gpp Ciąg znaków Zawiera ciąg tekstowy zgody protokołu Global Privacy Protocol. DV360 akceptuje tylko niektóre sekcje GPP, w tym amerykańską ogólnokrajową, kalifornijską i inne. Sekcje zasad TCF opracowanych przez IAB Europe nie są akceptowane. Zamiast nich używaj znaków user.consent lub user.ext.consent.
gpp_sid Tablica liczb całkowitych Tablica sekcji ciągu zgody w ramach protokołu Global Privacy Protocol, które powinny być zastosowane w tej transakcji.
ext Rozszerzenia dotyczące przepisów Opcjonalnie:

Obiekt rozszerzeń reguł

Pole Typ Szczegóły
gdpr Liczba całkowita Flaga wskazująca, czy żądanie podlega przepisom RODO, zgodnie z opisem w regs.gdpr powyżej. Oczekiwana jest tylko jedna z tych wartości: regs.gdpr lub regs.ext.gdpr.
us_privacy Ciąg znaków Zobacz regs.us_privacy dokumentację. Oczekiwana jest tylko jedna z tych wartości: regs.us_privacy, regs.ext.us_privacy i user.ext.us_privacy.

Imp object

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 Wymagane w przypadku możliwości wyświetlania reklam audio.
native Natywne Wymagane w przypadku możliwości wyświetlania reklam natywnych.
pmp Pmp Umowy na rynku prywatnym 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 reklamy 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, technologia pakietu SDK lub odtwarzacz odpowiedzialny 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świetlana 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 do debugowania 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 literowych ISO 4217.

clickbrowser Liczba całkowita

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

Pamiętaj, że w przypadku urządzeń z iOS 9.x kontroler widoku Safari jest traktowany jako przeglądarka natywna.

secure Liczba całkowita Określa, czy wyświetlenie wymaga bezpiecznego adresu URL HTTPS czy niezabezpieczonego adresu URL HTTP.
0 (domyślnie):insecure
1: secure
iframebuster Tablica tekstowa
exp Liczba całkowita Czas wygaśnięcia 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ślny): brak nagrody
1: nagroda

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 powinny zostać zablokowane.
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.

Zamiast tego zalecamy używanie zasady format.
h Liczba całkowita

Pola h i w zostaną scalone w polu format.

Zamiast tego zalecamy używanie zasady 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 zablokowanych typów banerów reklamowych:

1: reklamy tekstowe HTML
2: banery reklamowe HTML
3: reklamy JavaScript
4: reklamy IFrame

battr Tablica liczb całkowitych Obsługiwane wartości:

1: Autoodtwarzanie 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: Autoodtwarzanie filmu w banerze
7: Odtwarzanie filmu w banerze inicjowane przez użytkownika
8: Wyskakujące okienko(nad/pod/po wyjściu)
9: Prowokacyjne lub sugestywne
10: „Drażniące”, np. drżące, migające, z ekstremalną animacją, z 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ślnie): nieznane
1: część strony widoczna na ekranie
2: nieobsługiwane: prawdopodobnie część strony widoczna po przewinięciu
3: część strony widoczna po przewinięciu
4: nagłówek
5: stopka
6: pasek boczny
7: pełny ekran
mimes Tablica tekstowa  Nieobsługiwane.

DV360 będzie używać formatu tekstowego/html dla wszystkich kreacji banerowych.

topframe Liczba całkowita 0 (domyślnie): baner jest wyświetlany w elemencie iframe.
1: Nieobsługiwane: baner jest wyświetlany w górnej ramce.
expdir Tablica liczb całkowitych 1: lewo
2: prawo
3: góra
4: dół
5: rozwijany pełny ekran
api Tablica liczb całkowitych Obsługiwane platformy interfejsu API

1: lewo
2: prawo
3: góra
4: dół
5: rozwijany pełny ekran

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 elementu banner używanego z obiektem wideo.

0: baner jest widoczny jednocześnie z kreacją wideo.
1: baner jest kartą 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ę. Brakujące pole miejsca docelowego jest klasyfikowane jako nieznane miejsce docelowe. Więcej informacji znajdziesz w artykule o kierowaniu na pozycję.

Pole Typ Szczegóły
mimes Tablica tekstowa 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 podanie w pytaniu o stawkę pola plcmt (lub) miejsca docelowego reklamy wideo. Brak obu tych pól zostanie zaklasyfikowany jako nieznane miejsce docelowe.

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

Uwaga: aby miejsce docelowe lub wyświetlenie wideo zostało uznane za In-Stream (miejsce docelowe lub typ plcmt 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 podanie w pytaniu o stawkę pola plcmt (lub) miejsca docelowego reklamy wideo. Brak obu tych pól zostanie zaklasyfikowany jako nieznane miejsce docelowe.

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 wideo zostało uznane za In-Stream (miejsce docelowe lub typ plcmt 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, pierwszeństwo będzie miała wartość plcmt. Więcej informacji o migracji na plcmt znajdziesz w przewodniku IAB.

Uwaga: plcmt: Accompanying Content (2) jest traktowany jako placement: In Article (3)
plcmt: No Content/Standalone (4) jest traktowany jako placement: In feed (4)
placement: In Banner nie ma mapowania w plcmt
linearity Liczba całkowita  Nieobsługiwane.
skip Liczba całkowita Informuje, 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 kilku 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ługiwanych 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 dopuszczalne jest umieszczanie treści w formacie 4:3 w oknie 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ślnie): nieznane
1: automatyczne odtwarzanie z włączonym dźwiękiem
2: automatyczne odtwarzanie z wyłączonym dźwiękiem
3: kliknięcie w celu odtworzenia
4: najechanie kursorem myszy
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 reklama wideo 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: pełne odtworzenia filmu lub przerwanie przez użytkownika
2: opuszczenie widocznego obszaru lub przerwanie przez użytkownika
3: po opuszczeniu widocznego obszaru odtwarzanie jest kontynuowane w pływającym okienku do momentu zakończenia 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ślnie): nieznane
1: część strony widoczna na ekranie
2: nieobsługiwane: prawdopodobnie część strony widoczna po przewinięciu
3: część strony widoczna po przewinięciu
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ślna): 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 aktywnego widoku.
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 służy do określania, czy żądania są nagradzane. Należy ją wysłać jako liczbę całkowitą.

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

Obiekt audio

Pole Typ Szczegóły
mimes Tablica tekstowa 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 reklam 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 wszystkie boksy kreacji towarzyszących w formie banera;
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. Zapoznaj się z listą typów plików danych w specyfikacji AdCOM 1.0.

1: Usługa strumieniowania muzyki
2: Transmisja FM/AM (treści na żywo transmitowane bezprzewodowo, ale też dostępne w ramach strumieniowania online)
3: Podcast (oryginalne, nagrane wcześniej treści rozpowszechniane w formie odcinków w serii)
4: Radio na żądanie (nagrany fragment programu radiowego, który był pierwotnie transmitowany na żywo)
5: Radio internetowe (treści na żywo dostępne tylko w ramach strumieniowania online, a nie jako transmisja AM/FM)
6: Gra wideo (dźwięk w tle w grach wideo)
7: Zamiana tekstu na mowę (audiobooki, wtyczka do strony internetowej, która może odczytać artykuł)

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 zakodowanego natywnego obiektu 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 umowy
deals Tablica obiektów umowy oferty, które mają zostać uwzględnione;

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.

Wymagane, jeśli at=3.

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

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

at Liczba całkowita Jeśli nie zostanie podany, domyślnie dopasowuje bid_request.at.

1: Pierwsza cena
2: Druga cena
3: Stała cena

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

Brak stanowisk oznacza brak ograniczeń dotyczących stanowisk.

wadomain Tablica tekstowa Dozwolone domeny reklamodawców, którzy mogą składać stawki w ramach tej umowy.

Brak miejsc oznacza brak ograniczeń 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 giełdy do tej listy, skontaktuj się z nami.

Jeśli Twoja giełda używa obecnie innego mechanizmu do 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 okazjami 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 giełdy do tej listy, skontaktuj się z nami.

Jeśli Twoja giełda używa obecnie innego mechanizmu do 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 wysyłanie pełnego adresu URL w parametrze site.page zamiast wypełniania tylko parametru site.domain.

cat Tablica tekstowa  Nieobsługiwane.
sectioncat Tablica tekstowa  Nieobsługiwane.
pagecat Tablica tekstowa  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ąpione aliasami.

Nazwy aplikacji w przypadku żądań bez pakietu SDK (głównie na urządzenia CTV) 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 przypisanych do aplikacji 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 urządzenia CTV.
cat Tablica tekstowa  Nieobsługiwane.
sectioncat Tablica tekstowa  Nieobsługiwane.
pagecat Tablica tekstowa  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 identyfikują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, reklam wideo i audio.
series Ciąg znaków Zalecane w przypadku żądań dotyczących CTV, reklam wideo i audio.
season Ciąg znaków Etykieta sezonu treści.
artist Ciąg znaków Wykonawca, któremu przypisano 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, filmów i audio.
DV360 obsługuje w tym polu kilka taksonomii wartości gatunków wideo:
  • Lista gatunków Google (Pobierz)
  • Lista gatunków audio w Google (pobierz)
  • Kategorie IAB TV/Movie/Sports (pobierz)
  • Taksonomia gatunków wideo Gracenote firmy Nielsen
album Ciąg znaków Album, do którego należą treści, zwykle w przypadku 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 tekstowa Kategorie treści IAB opisujące treści.
prodq Liczba całkowita Jakość produkcji:

0 (Domyślnie): Nieznane
1: Profesjonalne
2: Półprofesjonalne
3: Treści użytkowników

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

1: Wideo
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: Dla dorosłych

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: Zakup pośredni
1: Zakup bezpośredni

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

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

language Ciąg znaków (ISO-639-1-alpha-2) Język treści.
embeddable Liczba całkowita Informacja o tym, czy treści można osadzić (np.osadzony odtwarzacz wideo).

0: nie można umieścić na stronie
1: można umieścić na stronie

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 tekstowa  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óry wygenerował 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 tekstowa  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 „Do Not Track” 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 nie jest ograniczone
1: śledzenie musi być ograniczone zgodnie z wytycznymi handlowymi

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 iOS.
android: identyfikuje urządzenie z Androidem, jeśli nie można go zidentyfikować za pomocą symboli ua lub sua.
[anything else]: Używane w diagnostyce do izolowania problemów.

W tym polu wielkość liter nie ma znaczenia.

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 tekście otwartym.
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 ruch.

Pole Typ Szczegóły
truncated_ip Liczba całkowita Określ, czy adres IP w polu device.ip żądania stawki jest obcięty.

0: nieobcięte
1: obcięte

Domyślnie nie jest skracany i 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 Wskaż pochodzenie pola device.ifa, czyli czy zostało ono podane przez samo urządzenie, 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 oparty na urządzeniu 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: Z ograniczonym dostępem
2: Odmowa
3: Autoryzacja

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

Zobacz testy przeprowadzane w 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 Określa 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  List: User-Agent Source. 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 tekstowa Ciąg komponentów wersji w kolejności malejącej (główny, podrzędny, 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 rozszerzonych identyfikatorów udostępniane przez giełdę.
ext Rozszerzenia dotyczące użytkowników Rozszerzenia obiektu użytkownika.

Obsługiwane rozszerzenia obiektu użytkownika

Pole Typ Szczegóły
eids Tablica obiektów identyfikatora rozszerzonego Instancje rozszerzonych identyfikatorów udostępniane przez giełdę.
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 wykorzystywanie danych użytkownik wyraził zgodę, a którzy nie uczestniczą w zasadach TCF. Zobacz specyfikację techniczną Google o nazwie „Udzielenie dodatkowej zgody”.
us_privacy Ciąg znaków Zobacz regs.us_privacy dokumentację. Oczekiwana jest tylko jedna z tych wartości: regs.us_privacy, regs.ext.us_privacy i user.ext.us_privacy.

Obiekt rozszerzonego identyfikatora

Pole Typ Szczegóły
source Ciąg znaków Dostawca identyfikatora
uids Tablica obiektów identyfikatora UID rozszerzonego identyfikatora 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 biorące udział w transakcji, czyli właściciela witryny, aplikacji lub innego medium.

W niekompletnym łańcuchu dostaw reprezentuje 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 przypadku OpenDirect jest to zwykle identyfikator organizacji wydawcy.

Powinien mieć maksymalnie 64 znaki.

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 znajduje się 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 obiektu 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 płatności.

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

Specyfikacja odpowiedzi na pytanie o stawkę

Obiekt BidResponse

Atrybut Obsługiwane Szczegóły implementacji Zawsze zaliczone
id Jeśli wystąpi błąd analizowania, zamiast identyfikatora żądania stawki może pojawić się wartość „0”. Tak
seatbid
bidid
cur Jeśli wystąpi błąd analizowania, nie jest on przekazywany. 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 znaleziono problem. Możliwe wartości to:
2: Nieprawidłowe żądanie
12: Naruszenie związane z autoryzacją w pliku ads.txt
16: Niekompletny łańcuch dostaw
17: Zablokowany węzeł łańcucha dostaw
Uwaga: w przypadku wykrycia konkretnego naruszenia pliku (app-)ads.txt lub łańcucha dostaw w ułamku (1%) odpowiedzi zostanie podany 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 obejmują:

  • Treść pytania o stawkę była pusta.
  • Pytanie o stawkę nie zostało wysłane w walucie, która jest na liście dozwolonych walut w przypadku 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 zaliczone
stawka tak
stanowisko tak
grupa

Obiekt stawki

Atrybut Obsługiwane Szczegóły implementacji Zawsze zaliczone
id tak
impid tak
cena tak
nurl
burl
lurl
adm
adid
adomain
grupa
iurl
cid tak
crid tak
metoda,
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 przekazany w stawce

DV360 obsługuje obie opcje.

  • W przypadku banerów reklamowych 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 pliku XML VAST w polu adm lub w odpowiedzi na powiadomienie o wygranej aukcji na podstawie wymagań partnerów wymiany.

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

Sprawdzone metody

Zdecydowanie zalecamy używanie identyfikatora partnera w Display & Video 360 jako identyfikatora platformy. Nie zalecamy używania identyfikatora konta na konkretnej giełdzie.

Upewnij się, że wydawcy mają powiązane pliki ads.txt lub aplikacje z 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 ograniczania 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 przypisanych do sklepów OTT/CTV. Określają one, jak należy przekazywać parametr app.bundle w przypadku aplikacji na urządzenia CTV, w dużej mierze przy użyciu 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ć w żądaniach OpenRTB te pola, aby DV360 wiedział, że klient obsługuje OMID.

  • Wymagane: dodaj do żądań stawek platformę interfejsu API (Video.api=7 dla Web Video OMSDK, Native.api=7 dla Native App OMSDK, Banner.api=7 lub Audio.api=7). Jest to obowiązkowe, aby Widok aktywny mógł przeprowadzać pomiary za pomocą OMID.
  • Zalecane: dodanie omidpn i omidpv do Source.Ext jest zdecydowanie 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
Pomiar w Widoku aktywnym w przypadku reklam natywnych

Aby włączyć pomiary Widoku aktywnego w przypadku reklam natywnych, DV360 wymaga od wydawców i giełd podjęcia dodatkowych działań.

  • Natywne reklamy displayowe: DV360 dodaje w odpowiedzi na pytanie o stawkę w obiekcie adm.native ten kod: eventtrackers.

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

    Giełdy powinny przekazywać wydawcom dodatkowe narzędzia do śledzenia zdarzeń, a wydawcy powinni wykonać te czynności:

    1. Zainstaluj OMSDK.
    2. Wczytywanie OMSDK podczas renderowania reklam natywnych.
    3. Wykonaj kod JavaScript w eventtrackers.url z podanymi parametrami.

  • Natywne reklamy wideo: DV360 umożliwia pomiar widoczności przez dodanie standardowego rozszerzenia AdVerifications w pliku XML VAST:

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

    Wydawcy, którzy obsługują już pomiar widoczności reklam wideo, nie muszą podejmować żadnych dodatkowych działań. W przeciwnym razie wydawcy muszą obsłużyć nowe rozszerzenie w odtwarzaczu wideo lub je zignorować.

Rozporządzenie UE w sprawie AI w przypadku natywnych reklam w usługach podmiotów zewnętrznych

Aby umożliwić reklamodawcom przestrzeganie nowych przepisów dotyczących przejrzystości. Przepisy dotyczące AI w Unii Europejskiej, Indiach i stanie Nowy Jork wymagają, aby reklamy zawierające określone komponenty wygenerowane przez AI lub edytowane za pomocą AI zawierały informacje powiadamiające konsumentów o tym, że reklamy te powstały przy użyciu sztucznej inteligencji. Od lipca 2026 r. Display & Video 360 (DV360) umożliwi reklamodawcom dodawanie etykiety informującej, że kreacja została wygenerowana lub zmodyfikowana przy użyciu AI. Ma to pomóc reklamodawcom w przestrzeganiu nowych przepisów dotyczących przejrzystości AI.

Reklamodawcy mogą dodawać te etykiety bezpośrednio do kreacji lub korzystać z ustawienia etykietowania opartego na AI w interfejsie Display & Video 360 i interfejsie API. Dowiedz się więcej o używaniu ustawień etykiet treści wygenerowanych przez AI do oznaczania reklam.

W przypadku reklam wyświetlanych przez Google wybrana strategia zgodności wykorzystuje minimalną etykietę AI przed kliknięciem i ujawnianie informacji po kliknięciu w panelu About This Ad (ATA).

W przypadku formatów reklam natywnych na platformach zewnętrznych Google nie ma wpływu na ostateczny sposób renderowania reklamy. W takich przypadkach sygnał potwierdzający będzie propagowany w ramach odpowiedzi na reklamę, aby giełdy lub wydawcy mogli wyrenderować ostateczną reklamę wraz z etykietą AI lub oświadczeniem. Sygnał będzie częścią pola adm.native.ext w odpowiedzi reklamy natywnej. Nowe pole adm.native.ext ma format:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }
  • should_disclosure_ai (true lub false) wskazuje, czy reklama końcowa musi zawierać etykietę AI.
  • Pole ai_disclosure_url może być obecne lub nie. To pole jest obecne tylko wtedy, gdy pole should_disclosure_ai ma wartość true, a pole adresu URL native.privacy jest puste. W takim przypadku kliknięcie etykiety AI powinno przekierowywać użytkownika na adres URL podany w tym polu. W innym przypadku kliknięcie etykiety AI powinno przekierować użytkownika do standardowego pola adresu URLnative.privacy.

Sygnały te powinny być przekazywane wydawcom, aby mogli oni renderować reklamę z etykietą AI.

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 żądaniach stawek 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 podać 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ć ciąg klienta użytkownika i upewnić się, że w odpowiedzi na pobranie VAST w ramach komunikacji s2s pliki cookie są wyłączone lub ignorowane.
Czy DV360 obsługuje OMID?
Możemy mierzyć widoczność za pomocą OMID, o ile w momencie wysyłania pytania o stawkę zadeklarowano, że OMID jest włączony. Szczegółowe informacje na ten temat znajdziesz na stronach 24–25.
Którą wersję reklam natywnych obsługujesz? Czy masz jakieś wymagania dotyczące reklam natywnych?
Obsługujemy tylko format natywny w wersji 1.2. Specyfikacja reklamy natywnej
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 utraconych żądaniach?
Tak, DV360 wypełnia pole bid.lurl w odpowiedziach na pytanie o stawkę. Jeśli stawka przegra, platforma wymiany może wysłać ping na ten adres URL z podaniem przyczyny, która zostanie wyświetlona reklamodawcom. Dzięki tym informacjom reklamodawcy mogą dowiedzieć się, jak uniknąć strat w przyszłości.
Czy DV360 wymaga podania wartości App.name na potrzeby kierowania reklam?
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.
Czy DV360 obsługuje wiele formatów 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 prośby o stawkę w wielu formatach, 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 reklamy pełnoekranowe w formie filmu lub banera. Pracujemy nad reklamami natywnymi/banerowymi i wideo/banerowymi. Jeśli znasz inne kombinacje, skontaktuj się z naszym zespołem.
Czy wiele kont może wysyłać wiele stawek w ramach tego samego żądania dotyczącego co najmniej 1 takiej możliwości realizacji 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 realizacji 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 lub w tej samej aplikacji.
Czy DV360 obsługuje wiele wyświetleń w tym samym pytaniu o stawkę?
DV360 obsługuje obecnie wiele obiektów audio wyświetleń. 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. wymiany.