wyświetlać lub pobierać pliki obsługujące protokół RTB;
Protos
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| cookie-bulk-upload.proto | Użyj tego komunikatu, aby przesłać zbiorczo dane kierowania na użytkowników. | v.24 | 27 marca 2024 r. |
| openrtb.proto | Google obsługuje protokół OpenRTB z kodowaniem JSON lub Protobuf. Ten plik proto jest niezbędny, jeśli używasz OpenRTB/Protobuf. Zawiera też dokumentację obsługiwanych pól i ich mapowania na protokół natywny Google. | 2.6 | 20 stycznia 2026 r. |
| openrtb-adx.proto | Protokół Google OpenRTB zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.203 | 20 stycznia 2026 r. |
| publisher-settings.proto | Zbiór ustawień wydawcy dotyczących sieci oferującej określanie stawek w czasie rzeczywistym. | v.14 | 5 lutego 2024 r. |
Prototypy otwartej wersji beta
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| openrtb-adx.proto | Protokół Google OpenRTB zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.211 | 20 stycznia 2026 r. |
Dane referencyjne
Słowniki (kliknij, aby pobrać plik TXT) |
|
|---|---|
| Kategorie usług reklamowych | Używany 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ą online. |
| Kategorie reklam z 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 objęte ograniczeniami, 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 są niedozwolone przez wydawcę, np. jeśli wydawca nie chce wyświetlać reklam związanych z polityką. |
| Reklamodawcy | Używany w polu advertiser_id w obiekcie SnippetStatusItem. To pole określa reklamodawcę reprezentowanego przez kreację powiązaną z fragmentem kodu. Ta lista zawiera reklamodawców z całej giełdy i nie odzwierciedla reklamodawców reprezentowanych przez żadnego kupującego. |
| Marki | Lista marek używanych w interfejsie Client Access API. |
| Atrybuty kreacji, które kupujący musi zadeklarować | Używane w polu attribute w BidResponse.
To pole opisuje atrybuty kreacji, które kupujący musi zadeklarować i które nie mogą występować w excluded_attribute w BidRequest. |
| Kody stanu wywołania | Kody stanu zwracane przez wywołanie metody performancereport. |
| Etykiety treści | Używany w polu detected_content_labels w BidRequest. |
| Kody stanu narzędzia do dopasowywania plików cookie | Używane w polu cookieMatcherStatusRate w raportach skuteczności protokołu RTB. Dostępne kody opisaliśmy w przewodniku Dopasowywanie plików cookie. |
| Kody stanu kreacji | Używane w creative_status_code zwrócił(a) zadanie w czasie rzeczywistym.
|
| Kody stanu dopasowania hostowanego | Używane w polu hostedMatchStatusRate w raportach skuteczności protokołu RTB. |
| Przyczyny braku stawki | Standardowe wartości przyczyny braku odpowiedzi na pytanie o stawkę, które należy podać w polu BidResponse.no_bid_reason w protokole licytacji Authorized Buyers. |
| Atrybuty kreacji, które można określić przed wyświetleniem | 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 jednej konfiguracji wstępnego kierowania. |
| Atrybuty kreacji, które wydawcy mogą wykluczać | Używany w polu excluded_attribute w BidRequest. To pole zawiera opis typów kreacji, które są niedozwolone 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żywany 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 ustaleniami wydawcy. Obejmuje dostawców z wycofanego pliku słownika |
| Dostawcy danych | Używany 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 identyfikatorami aplikacji, identyfikatorami kategorii i nazwami aplikacji zrozumiałymi dla użytkowników. |
| Tabele geograficzne | Tabela używana do dekodowania pola geo_criteria_id w BidRequest. Więcej informacji znajdziesz w artykule Kierowanie geograficzne. |
| Dostawcy usług zgodnych z ustawą LGPD |
Lista dostawców personalizacji reklam, którzy mogą wyświetlać reklamy w przypadku ruchu pochodzącego z regionów objętych ustawą LGPD, zawierająca ich identyfikator, nazwę czytelną dla człowieka, adres URL polityki prywatności i listę domen, które można przypisać do dostawcy. Egzekwowanie przepisów 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 sieci 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 w Mapach na nazwę czytelną dla człowieka, 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 protokole AdX i w polu BidRequest.User.UserExt.consented_providers_settings w protokole OpenRTB. W tych polach wymienieni dostawcy mają zgodę użytkowników 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 dotyczące zasad w formie pliku CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.