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 | 2 października 2025 r. |
| openrtb-adx.proto | Protokół Google OpenRTB zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.198 | 20 października 2025 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.205 | 20 października 2025 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 objaśnień | 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 wydawca może wykluczyć | Używany w polu excluded_attribute w BidRequest. To pole opisuje typy 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 w formacie czytelnym 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 zachowujący zgodność 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, wraz z ich identyfikatorami, nazwami czytelnymi dla człowieka, adresami URL zasad ochrony prywatności i listami domen, które można przypisać do dostawcy. Wymagania LGPD są 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 Real-time Bidding API.
Pobierz tematy dotyczące zasad w formie pliku CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.