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 czerwca 2026 r. |
| openrtb-adx.proto | Protokół OpenRTB od Google zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.208 | 9 czerwca 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ół OpenRTB od Google zawiera kilka rozszerzeń, które są dostępne w osobnym pliku proto. | v.217 | 16 czerwca 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 hostować reklam związanych z bankowością internetową. |
| 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 nie są dozwolone 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 przypadku pola attribute w BidResponse.
To pole opisuje atrybuty kreacji, które kupujący może 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żywane 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 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 składania ofert 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 kierowania wstępnego. |
| Atrybuty kreacji, które wydawcy mogą wykluczać | Używane w polu excluded_attribute w BidRequest. To pole opisuje typy kreacji, które są niedozwolone przez wydawcę. Mogą one 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 ustaleniami 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 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, wraz z ich identyfikatorami, nazwami czytelnymi dla człowieka, adresami URL polityki prywatności i listami 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 API określania stawek w czasie rzeczywistym.
Pobierz tematy dotyczące zasad w formie pliku CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.