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ć niuanse. W niektórych 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 są nieobsł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 HTTP 204 bez treści w przypadku braku oferty lub HTTP 200 z treścią w postaci odpowiedzi na pytanie o stawkę.
Jeśli pytanie o stawkę jest nieprawidłowo sformułowane, 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 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 tą funkcją, 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 DV360.
Wyślij nagłówek Content-Type: application/x-protobuf, aby wskazać pytanie o stawkę Protobuf, i ustaw Accept: application/x-protobuf, aby otrzymywać odpowiedzi na pytania o stawkę 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 |
site |
Obszar | 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ślna): aukcja drugiej ceny, w której reklamodawca płaci stawkę 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 z konkurencyjnymi stawkami.
|
tmax |
Liczba całkowita | Opcjonalny, domyślnie niestandardowy 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 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 tekstowa | 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ę jednej waluty na giełdę. |
wlang |
Tablica tekstowa | Nieobsługiwane. |
bcat |
Tablica tekstowa | Zablokowane kategorie reklamodawców z użyciem 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 częściowo 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 u wydawcy, które może przyjmować jedną z tych wartości : |
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 pytanie o 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świetlenia0 (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 |
ext |
Rozszerzenia źródła | Opcjonalnie. |
Obiekt rozszerzeń źródłowych
To rozszerzenie jest wysoce zalecane, ponieważ wpływa na sposób raportowania w DV3 pomiarów widoczności klientowi. Jeśli nazwa partnera OMID NIE znajduje się na liście certyfikatów IAB, zgodnie z wymaganiami MRC musimy 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 partnera OMID. |
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: 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 nie wiadomo.
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 przepisami o ochronie prywatności w USA. 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: |
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 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ć stosowane w przypadku tej transakcji. |
ext |
Rozszerzenia dotyczące przepisów | Opcjonalnie. |
Obiekt rozszerzeń dotyczących przepisów
| 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.
|
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 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 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ś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 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 literowych ISO 4217. |
clickbrowser |
Liczba całkowita |
Określa typ przeglądarki otwieranej po kliknięciu kreacji w aplikacji. 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):insecure1: 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ślnie): brak nagrody1: 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 powinny być zablokowane. |
Obiekt banera
| Pole | Typ | Szczegóły |
|---|---|---|
format |
Tablica format | Lista obsługiwanych formatów. |
w |
Liczba całkowita |
Pola format.
|
h |
Liczba całkowita |
Pola 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:
|
battr |
Tablica liczb całkowitych | Obsługiwane wartości:
|
pos |
Liczba całkowita |
Pozycja reklamy:
|
mimes |
Tablica tekstowa |
Nieobsługiwane.
DV360 będzie używać formatu tekst/html w przypadku 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: Left2: Right3: Up4: Down5: Expandable Fullscreen
|
api |
Tablica liczb całkowitych |
Obsługiwane platformy interfejsu API
|
id |
Ciąg znaków |
Identyfikator obiektu banera, który powinien być unikalny w przypadku wyświetlenia.
Zalecane, gdy obiekty |
vcm |
Liczba całkowita |
Dotyczy tylko parametru 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 o kierowaniu na pozycję.
| Pole | Typ | Szczegóły |
|---|---|---|
mimes |
Tablica tekstowa |
Wymagany jest co najmniej 1 typ MIME.
|
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ół.
|
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.
|
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.
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: 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 |
Określa, czy odtwarzacz wideo zezwala na pominięcie reklamy.
|
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 wiele 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.
|
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
|
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.
|
playbackend |
Liczba całkowita |
Zdarzenie, które powoduje zakończenie odtwarzania.
|
delivery |
Tablica liczb całkowitych | Obsługiwane metody dostawy. Jeśli nie określono żadnego, przyjmij, że wszystkie są obsługiwane.
|
pos |
Liczba całkowita |
Pozycja reklamy na ekranie.
|
companionad |
Tablica Banner | reklamy towarzyszące (jeśli są dostępne); |
api |
Tablica liczb całkowitych |
|
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ą przesłać jako liczbę całkowitą.
|
Obiekt audio
| Pole | Typ | Szczegóły |
|---|---|---|
mimes |
Tablica tekstowa |
Wymagany jest co najmniej 1 typ MIME.
|
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 |
|
startdelay |
Liczba całkowita | Opóźnienie rozpoczęcia w sekundach w przypadku reklam przed filmem, reklam w trakcie filmu lub reklam po filmie.
|
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 miejsca na kreacje towarzyszące w formie banerów; |
api |
Tablica liczb całkowitych |
Lista obsługiwanych platform API w przypadku tego wyświetlenia.
|
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.
|
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ługiwane1.1: Nieobsługiwane1.2
|
api |
Tablica liczb całkowitych |
Lista obsługiwanych platform API w przypadku tego wyświetlenia.
|
battr |
Tablica liczb całkowitych | Nieobsługiwane. |
Obiekt PMP
| Pole | Typ | Szczegóły |
|---|---|---|
private_auction |
Liczba całkowita |
0 (Domyślnie): wszystkie stawki są dozwolone1: 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.
Wymagane, jeśli |
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ę pytania o stawkę. |
at |
Liczba całkowita |
Jeśli nie zostanie podana, domyślnie przyjmuje wartość bid_request.at.
|
wseat |
Tablica tekstowa |
Identyfikatory partnerów, którzy kwalifikują się do umowy.
Brak miejsc siedzących oznacza brak ograniczeń dotyczących miejsc siedzących. |
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 Twój pakiet wymiany używa obecnie innego mechanizmu do sygnalizowania umów gwarantowanych w DV360, skontaktuj się z nami, aby omówić przejście na to preferowane rozszerzenie.
|
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 giełdy do tej listy, skontaktuj się z nami. Jeśli Twój pakiet wymiany używa obecnie innego mechanizmu do sygnalizowania umów gwarantowanych w DV360, skontaktuj się z nami, aby omówić przejście na to preferowane rozszerzenie.
Zamiast tego pola zalecamy użycie |
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 tekstowa | Nieobsługiwane. |
sectioncat |
Tablica tekstowa | Nieobsługiwane. |
pagecat |
Tablica tekstowa | Nieobsługiwane. |
page |
Ciąg znaków |
Pełny adres URL, w którym ma się wyświetlać wyświetlenie.
W celu 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 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 w sklepie z aplikacjami na telewizory Smart TV. |
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 określający treści. |
episode |
Liczba całkowita | Numer odcinka (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 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: |
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 tekstowa | Kategorie treści IAB opisujące treści. |
prodq |
Liczba całkowita |
Jakość produkcji:
|
videoquality |
Liczba całkowita | Nieobsługiwane. |
context |
Liczba całkowita |
Typ treści:
|
contentrating |
Ciąg znaków | Zalecane w przypadku reklam 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).
|
keywords |
Ciąg znaków (format CSV) | Nieobsługiwane. |
livestream |
Liczba całkowita |
czy treści są transmitowane na żywo;
|
sourcerelationship |
Liczba całkowita |
|
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 |
Wskaźnik określający, czy treści można osadzić (np.odtwarzacz wideo, który można osadzić).
|
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ó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 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 użytkowniku. |
geo |
Obiekt geograficzny | Lokalizacja urządzenia. |
dnt |
Liczba całkowita |
Flaga „Do Not Track” ustawiona w nagłówku przeglądarki.
|
lmt |
Liczba całkowita |
Sygnał ograniczenia śledzenia reklam zatwierdzony komercyjnie.
|
ip |
Ciąg znaków |
Wymagany w przypadku adresu IPv4.
Jeśli adres IP jest skrócony, musi być zadeklarowany w |
ipv6 |
Ciąg znaków |
Wymagany w przypadku protokołu IPv6.
Jeśli adres IP jest skrócony, musi być zadeklarowany w |
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.
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 na urządzenia | 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 pytania o stawkę jest obcięty.
Domyślnie nie jest skracany. Jest wymagany, jeśli adres IP jest skrócony. Jeśli pytanie o stawkę nie zostanie zadeklarowane, może zostać sklasyfikowane jako nieprawidłowy ruch. |
ifa_type |
Ciąg znaków |
Wskazuje 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.
|
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.
|
cdep |
Ciąg znaków |
Etykieta wycofania plików cookie innych firm w Chrome.
Zapoznaj się z artykułem Testowanie z użyciem 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 artykule Lista: źródło informacji o przeglądarce. 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 malejącej kolejności hierarchicznej (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. |
consent |
Ciąg znaków (bezpieczny w internecie format Base64) |
Gdy obowiązują przepisy RODO, ten atrybut zawiera strukturę danych ciągu zgody w ramach zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych.
Wartość jest bezpiecznym dla sieci ciągiem binarnym zakodowanym w formacie base64 przy użyciu formatu IAB.
W dokumentacji DV360 dotyczącej RODO znajdziesz informacje o tym, jak DV360 używa tego sygnału.
Oczekiwana jest tylko jedna z tych wartości: user.consent lub user.ext.consent.
|
eids |
Tablica obiektów identyfikatora rozszerzonego | Instancje rozszerzonego identyfikatora 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 zgody na wykorzystanie danych zgodnie z RODO, zgodnie z opisem w user.consent powyżej.
Oczekiwana jest tylko jedna z tych wartości: user.consent lub user.ext.consent.
|
eids |
Tablica obiektów identyfikatora rozszerzonego | Instancje rozszerzonego identyfikatora podawane 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, w przypadku których użytkownik wyraził zgodę na wykorzystanie danych, 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 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 „wersja główna.wersja pomocnicza”, 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. 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 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.
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 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 pytanie o stawkę
Obiekt BidResponse
| Atrybut | Obsługiwane | Szczegóły implementacji | Zawsze zaliczony |
|---|---|---|---|
| id | Jeśli wystąpi błąd analizowania, zamiast identyfikatora pytania o stawkę 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 pytaniu o stawkę wykryto problem. Możliwe wartości to:2: Nieprawidłowe żądanie12: Naruszenie autoryzacji ads.txt16: Niekompletny łańcuch dostaw17: Zablokowany węzeł łańcucha dostawUwaga: 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 podany 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 pytaniem o stawkę, 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ć:
|
| 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 | |||
| burl | |||
| lurl | |||
| adm | |||
| adid | |||
| adomain | |||
| grupa | |||
| iurl | |||
| cid | tak | ||
| crid | tak | ||
| taktyka, | |||
| 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 znajdują się 2 różne opcje wyświetlania:
- Znaczniki wyświetlane w powiadomieniu o wygranej
- Znacznik został przesłany w ramach stawki
DV360 obsługuje obie te opcje.
- W przypadku banera reklamowego 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
admlub 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 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. Dowiedz się więcej.
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 parametrów device.ifa i device.lmt postępuj zgodnie z wytycznymi IAB dotyczącymi 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 urządzenia CTV, 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 interfejs API (
Video.api=7dlaWeb Video OMSDK,Native.api=7dlaNative App OMSDK,Banner.api=7lubAudio.api=7). Jest to obowiązkowe, aby Widok aktywny mógł przeprowadzać pomiary za pomocą OMID. - Zalecane: dodanie parametrów
omidpniomidpvdoSource.Extjest 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, zgodnie z wymaganiami organizacji MRC musimy 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 wykonania dodatkowych czynności.
Natywne reklamy displayowe: DV360 dodaje w odpowiedzi na pytanie o stawkę te
eventtrackersw obiekcieadm.native:"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:
- Zainstaluj OMSDK.
- Wczytywanie OMSDK podczas renderowania reklam natywnych.
- Wykonaj kod JavaScript w
eventtrackers.urlz podanymi parametrami.
Natywne kreacje wideo: DV360 umożliwia pomiar widoczności przez dodanie standardowego rozszerzenia
AdVerificationsw 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 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 i interfejsie API Display & Video 360. 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 informację 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 przekazywany w ramach odpowiedzi na reklamę, aby giełdy lub wydawcy mogli wyrenderować ostateczną reklamę wraz z etykietą lub informacją o AI. Sygnał będzie częścią pola adm.native.ext w odpowiedzi na żądanie 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_urlmoże, ale nie musi być obecne. To pole jest obecne tylko wtedy, gdy zasadashould_disclosure_aima wartość true, a pole adresu URLnative.privacyjest puste. W takim przypadku kliknięcie etykiety AI powinno przenieść użytkownika do adresu URL podanego 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 poszczególnych przypadkach. 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ć zasięg danych demograficznych?
- Wypełniaj pola
user.yobiuser.genderw 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 w trybie 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 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.
- 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 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 wiele platform może wysyłać wiele stawek w ramach tego samego żądania dotyczącego 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ć tylko 1 wyświetlenie w przypadku każdego żądania. Oczekujemy, że platformy SSP będą grupować obiekty imp w sposób znaczący, 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 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 pytania o stawkę. 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.