Wyświetlanie i pobieranie plików obsługujących protokół RTB.
Protos
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| cookie-bulk-upload.proto | Użyj tej wiadomości, aby zbiorczo przesłać dane kierowania na użytkowników. | v.25 | 27 marca 2024 r. |
| openrtb.proto | Google obsługuje protokół OpenRTB z kodowaniem JSON lub Protobuf. Ten proto jest niezbędny, jeśli używasz OpenRTB/Protobuf. Zawiera też dokumentację obsługiwanych pól i ich mapowania na natywny protokół Google. | 2.6 | 15 października 2026 r. |
| openrtb-adx.proto | Protokół OpenRTB Google zawiera pewne rozszerzenia, które są dostępne w osobnym pliku proto. | v.210 | 4 sierpnia 2026 r. |
| publisher-settings.proto | Zestaw ustawień wydawcy dotyczących sieci z określaniem stawek w czasie rzeczywistym. | v.14 | 5 lutego 2024 r. |
Prototypy otwartej wersji beta
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| openrtb-adx.proto | Protokół OpenRTB Google zawiera pewne rozszerzenia, które są dostępne w osobnym pliku proto. | v.220 | 16 września 2026 r. |
Dane referencyjne
Słowniki (kliknij, aby pobrać plik .txt) |
|
|---|---|
| Kategorie usług reklamowych | Używane w polu excluded_product_category w BidRequest. To pole opisuje kategorie produktów i usług, które nie są dozwolone przez wydawcę, np. jeśli wydawca nie chce wyświetlać reklam związanych z bankowością internetową. |
| Kategorie reklam objęte ograniczeniami | Używane w polu allowed_restricted_category w BidRequest i w polu restricted_category w BidResponse. Pole allowed_restricted_category opisuje kategorie, które są zwykle ograniczone, ale wydawca wyraźnie zadeklarował, że są dozwolone, 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 w polu category w BidResponse. Pole excluded_sensitive_category opisuje kategorie o charakterze kontrowersyjnym, które nie są dozwolone przez wydawcę, np. jeśli wydawca nie chce wyświetlać reklam związanych z polityką. |
| Reklamodawcy | Używane w polu advertiser_id obiektu SnippetStatusItem. To pole określa reklamodawcę reprezentowanego przez kreację powiązaną z tym fragmentem kodu. Ta lista zawiera reklamodawców z całej giełdy, a nie tylko tych, których reprezentuje dany kupujący. |
| Marki | Lista marek używana w interfejsie Client Access API. |
| Atrybuty kreacji, które może zadeklarować kupujący | Używane w polu attribute w BidResponse.
To pole opisuje atrybuty kreacji, które kupujący może zadeklarować i które nie mogą się pojawiać w excluded_attribute w BidRequest. |
| Etykiety treści | Używane w polu detected_content_labels w BidRequest. |
| Kody stanu dopasowywania plików cookie | Używane w polu cookieMatcherStatusRate raportów 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 zwróconych w opiniach w czasie rzeczywistym.
|
| Kody stanu hostowanych danych klientów na potrzeby dopasowania | Używane w polu hostedMatchStatusRate w raportach skuteczności protokołu RTB. |
| Przyczyny braku stawki | Standardowe wartości powodów braku stawki, które należy podać w polu BidResponse.no_bid_reason w protokole określania stawek Authorized Buyers. |
| Atrybuty kreacji, które można kierować wstępnie | Używane w polu supportedCreativeAttribute w zasobie PretargetingConfig udostępnianym w interfejsie API typu REST dla kupujących. To pole opisuje atrybuty kreacji, które powinny być obecne we wszystkich kreacjach odpowiadających pojedynczej 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 nie są dozwolone przez wydawcę. Mogą na przykład określać ograniczenia dotyczące tego, czy dozwolone jest używanie plików cookie lub czy dozwolone są reklamy multimedialne 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 określeniem wydawcy. Obejmuje dostawców z wycofanego pliku słownika |
| 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 zrozumiałymi dla człowieka. |
| Tabele geograficzne | Tabela używana do dekodowania pola geo_criteria_id w BidRequest. Więcej informacji znajdziesz w artykule Kierowanie geograficzne. |
| Dostawcy zgodni z ustawą LGPD |
Lista dostawców personalizacji reklam, którzy mogą wyświetlać reklamy w ruchu objętym ustawą LGPD, wraz z ich identyfikatorami, nazwami zrozumiałymi dla człowieka, adresami URL polityki prywatności i listą domen, które można przypisać do dostawcy. Egzekwowanie LGPD jest wskazywane w danym pytaniu o stawkę za pomocą pola BidRequest.adslot.regs_lgpd w protokole określania stawek Authorized Buyers i pola BidRequest.regs.ext.lgpd w protokole określania stawek OpenRTB.
|
| Operatorzy komórkowi | Lista operatorów komórkowych. |
| Urządzenia mobilne | Lista urządzeń mobilnych. |
| Systemy operacyjne na urządzeniach mobilnych | Lista mobilnych systemów operacyjnych. |
| Dostawcy | Mapuje identyfikatory dostawców personalizacji reklam na zrozumiałą dla człowieka nazwę, adres URL polityki prywatności i listę domen, które można przypisać do dostawcy.
Obecnie dostawcy są używani w polu BidRequest.AdSlot.consented_providers_settings w przypadku protokołu AdX i BidRequest.User.UserExt.consented_providers_settings w przypadku protokołu 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ś opiekuna klienta o plik publisher-settings.pb.gz.
Tematy zasad dotyczących sprawdzania kreacji
Możesz użyć tematów zasad w tym pliku, aby filtrować kreacje podczas sprawdzania w interfejsie API określania stawek w czasie rzeczywistym.
Pobierz tematy zasad jako plik CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.