Wyświetlanie i pobieranie plików obsługujących protokół RTB
Protos
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| cookie-bulk-upload.proto | Użyj tego komunikatu, aby zbiorczo przesłać dane kierowania na użytkowników. | v.24 | 27 marca 2024 r. |
| openrtb.proto | Google obsługuje protokół OpenRTB z kodowaniem JSON lub Protobuf kodowaniem. Ten plik proto jest wymagany, jeśli używasz protokołu OpenRTB/Protobuf. Zawiera też dokumentację obsługiwanych pól i ich mapowania na natywny protokół Google'a. | 2.6 | 20 stycznia 2026 r. |
| openrtb-adx.proto | Protokół OpenRTB Google zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.207 | 13 kwietnia 2026 r. |
| publisher-settings.proto | Zestaw ustawień wydawcy dotyczących sieci systemu licytującego w czasie rzeczywistym. | v.14 | 5 lutego 2024 r. |
Protos otwartej wersji beta
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| openrtb-adx.proto | Protokół OpenRTB Google zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.215 | 13 kwietnia 2026 r. |
Dane referencyjne
Słowniki (kliknij, aby pobrać plik .txt) |
|
|---|---|
| Kategorie produktów reklamowych | Używane w polu excluded_product_category w
BidRequest. To pole opisuje kategorie produktów i
usług, które są niedozwolone przez wydawcę, np. jeśli wydawca
nie chce hostować reklam związanych z bankowością internetową. |
| Kategorie reklam z ograniczeniami | Używane w polu allowed_restricted_category w
BidRequest i polu restricted_category w
BidResponse. Pole allowed_restricted_category
opisuje kategorie, które są zwykle objęte ograniczeniami, ale wydawca wyraźnie zezwala na ich używanie, np. reklamy zawierające treści związane z alkoholem. |
| Kategorie reklam o charakterze kontrowersyjnym | Używane w polu excluded_sensitive_category w
BidRequest i polu category w
BidResponse. Pole excluded_sensitive_category
opisuje kategorie o charakterze kontrowersyjnym, które są niedozwolone przez wydawcę, np. jeśli wydawca nie chce hostować reklam związanych z
polityką. |
| Reklamodawcy | Używane w polu advertiser_id w SnippetStatusItem. To
pole określa reklamodawcę reprezentowanego przez kreację powiązaną z
fragmentem kodu. Ta lista odzwierciedla reklamodawców w całej usłudze Ad Exchange i nie
odzwierciedla reklamodawców reprezentowanych przez żadnego kupującego. |
| Marki | Lista marek używanych w interfejsie Client Access API. |
| Atrybuty kreacji deklarowane przez kupującego | Używane w polu attribute w BidResponse.
To pole opisuje atrybuty kreacji deklarowane przez kupującego, które nie mogą występować w polu excluded_attribute w
BidRequest. |
| Kody stanu rozszerzenia | Kody stanu zwracane przez wywołanie metody performancereport
call. |
| Etykiety treści | Używane w polu detected_content_labels w
BidRequest. |
| Kody stanu dopasowania plików cookie | Używane w polu cookieMatcherStatusRate w raportach skuteczności protokołu RTB. Dostępne kody są opisane w przewodniku po dopasowywaniu plików cookie. |
| Kody stanu kreacji | Używane w creative_status_code zwracanym w czasie rzeczywistym
opiniach.
|
| Kody stanu dopasowania hostowanego | Używane w polu hostedMatchStatusRate w raportach skuteczności protokołu RTB. |
| Przyczyny braku stawki | Standardowe wartości przyczyn braku stawki, które należy podać w polu BidResponse.no_bid_reason w protokole stawek Authorized Buyers. |
| Atrybuty kreacji, które można wstępnie kierować | Używane w polu supportedCreativeAttribute w zasobie PretargetingConfig udostępnianym w interfejsie Buyer REST API. To pole
opisuje atrybuty kreacji, które mają występować we wszystkich kreacjach
odpowiadających jednej konfiguracji kierowania wstępnego. |
| Atrybuty kreacji, które wydawca może wykluczyć | Używane w polu excluded_attribute w
BidRequest. To pole opisuje typy kreacji, które
są niedozwolone przez wydawcę. Wydawca może na przykład określić
ograniczenia dotyczące tego, czy można używać plików cookie oraz czy dozwolone są reklamy graficzne lub tekstowe. |
| Dostawcy | Używane w polu allowed_vendor_type w
BidRequest. To pole zawiera listę dostawców Rich Media, takich jak
Campaign Monitor i VoiceFive, którzy są dozwoleni w przypadku wyświetlanej kreacji,
zgodnie z ustawieniami wydawcy. Obejmuje dostawców z wycofanego
|
| Dostawcy danych | Używane w polu SegmentData.id w
BidRequest. To pole zawiera informacje o podmiocie, który dostarczył
sygnały dostarczane przez wydawcę. |
Tabele referencyjne (kliknij, aby pobrać pliki CSV) |
|
| Aplikacje mobilne na Androida | Lista aplikacji mobilnych na Androida, na które można kierować reklamy, wraz z ich identyfikatorami, identyfikatorami kategorii, i nazwami. |
| Tabele geograficzne | Tabela używana do dekodowania pola geo_criteria_id w
BidRequest. Więcej informacji znajdziesz w artykule Kierowanie geograficzne. |
| Dostawcy zachowujący zgodność z ustawą LGPD |
Lista dostawców personalizacji reklam, którzy mogą wyświetlać reklamy w przypadku ruchu zgodnego z (brazylijską) ustawą LGPD, wraz z ich identyfikatorami, nazwami zrozumiałymi dla człowieka, adresami URL zasad ochrony prywatności i listami domen, które można przypisać do dostawcy. Informacje o egzekwowaniu zgodności z ustawą LGPD są podawane w
danym pytaniu o stawkę w polu BidRequest.adslot.regs_lgpd
w protokole stawek Authorized Buyers oraz w polu
BidRequest.regs.ext.lgpd w protokole stawek OpenRTB.
|
| Operatorzy komórkowi | Lista operatorów komórkowych. |
| Urządzenia mobilne | Lista urządzeń mobilnych. |
| Systemy operacyjne na urządzenia mobilne | Lista systemów operacyjnych na urządzenia mobilne. |
| Dostawcy | Mapuje identyfikatory dostawców personalizacji reklam na nazwy zrozumiałe dla człowieka, adresy URL zasad ochrony prywatności i listy domen, które można przypisać do dostawcy.
Obecnie dostawcy są używani w polu
BidRequest.AdSlot.consented_providers_settings w protokole AdX
oraz w polu
BidRequest.User.UserExt.consented_providers_settings w protokole OpenRTB. W tych polach wymienieni dostawcy mają zgodę użytkownika przekazaną przez
wydawców w przypadku użytkowników z krajów Europejskiego Obszaru Gospodarczego. |
Ustawienia wydawcy
Poproś przedstawiciela konta o przesłanie pliku publisher-settings.pb.gz.
Tematy zasad dotyczących sprawdzania kreacji
Tematy zasad w tym pliku możesz wykorzystać do filtrowania kreacji podczas sprawdzania w interfejsie Real-time Bidding API.
Pobierz tematy zasad w pliku CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.