Protos & dane referencyjne

Wyświetl lub pobierz pliki obsługujące protokół RTB.

Protos

Plik Opis Wersja Ostatnia aktualizacja
cookie-bulk-upload.proto Użyj tej wiadomości, by przesłać zbiorczo dane kierowania na użytkowników. v.24 27 marca 2024 r.
openrtb.proto Google obsługuje protokół OpenRTB za pomocą formatu JSON lub Protobuf kodowanie. Jest on wymagany, jeśli używasz OpenRTB/Protobuf. Dodatkowo zawiera dokumentację obsługiwanych pól i ich mapowanie na tagi Google przez protokół natywny. 2.6 1 sierpnia 2024 r.
openrtb-adx.proto Protokół OpenRTB firmy Google obejmuje kilka rozszerzeń podanych w osobnym proto. v.177 6 sierpnia 2024 r.
publisher-settings.proto Zestaw ustawień wydawcy związanych z siecią licytujących w czasie rzeczywistym. v.13 5 lutego 2024 r.
realtime-bidding.proto Protokół RTB Google Authorized Buyers. To jest wiadomość, której Google używa prosi o ofertę. BidRequest obejmuje boks reklamowy z pojedyncze wyświetlenie. v.330 6 sierpnia 2024 r.

Prototypy otwartej wersji beta

Plik Opis Wersja Ostatnia aktualizacja
openrtb-adx.proto Protokół OpenRTB firmy Google obejmuje kilka rozszerzeń podanych w osobnym proto. v.182 6 sierpnia 2024 r.
realtime-bidding.proto Protokół RTB Google Authorized Buyers. To jest wiadomość, której Google używa prosi o ofertę. BidRequest obejmuje boks reklamowy z pojedyncze wyświetlenie. v.340 6 sierpnia 2024 r.

Dane referencyjne

Słowniki (kliknij, aby pobrać plik .txt)

Kategorie produktów reklamowych Używany w polu excluded_product_category funkcji BidRequest To pole opisuje kategorie produktów i usług niedozwolonych przez wydawcę (np. jeśli wydawca nie chce wyświetlać reklam związanych z bankowością internetową.
Kategorie z ograniczeniami dotyczącymi reklam Używany w polu allowed_restricted_category funkcji BidRequest oraz pole restricted_category kolumny BidResponse allowed_restricted_category opisuje kategorie zwykle objęte ograniczeniami, ale wyraźnie zadeklarowane przez wydawcę jako dozwolone, na przykład reklamy zawierające treści związanych z alkoholem.
Reklamy o charakterze kontrowersyjnym Używany w polu excluded_sensitive_category funkcji BidRequest oraz pole category kolumny BidResponse excluded_sensitive_category opisuje kategorie o charakterze kontrowersyjnym, na które wydawca nie zezwala, Jeśli np. wydawca nie chce wyświetlać reklam związanych z polityce.
Reklamodawcy Używany w polu advertiser_id elementu SnippetStatusItem. Ten określa reklamodawcę reprezentowanego przez kreację powiązaną z we fragmencie kodu. Ta lista zawiera reklamodawców z całej giełdy i wskazuje, nie odzwierciedlają reklamodawców reprezentowanych przez żadnego kupującego.
Marki Lista marek używanych w interfejsie Client Access API.
Atrybuty kreacji możliwe do zadeklarowania przez kupującego Używana w polu attribute w tabeli BidResponse. To pole opisuje atrybuty kreacji możliwe do zadeklarowania przez kupującego, które muszą nie występują w: excluded_attribute w: BidRequest
Kody stanu objaśnień Kody stanu zwracane przez metodę performancereport .
Etykiety treści Używana w polu detected_content_labels funkcji BidRequest
Kody stanu dopasowywania plików cookie Używane w polu cookieMatcherStatusRate protokołu RTB raportów skuteczności. Dostępne kody są opisane w sekcji Dopasowywanie plików cookie Google.
Kody stanu kreacji

Używane w

creative_status_code zwrócone w czasie rzeczywistym opinie.
Kody stanu hostowanego dopasowania Używane w polu hostedMatchStatusRate protokołu RTB raportów skuteczności.
Brak powodów stawki Standardowe wartości przyczyny braku stawki do podania w polu BidResponse.no_bid_reason w polu BidResponse.no_bid_reason Protokół ustalania stawek Authorized Buyers.
Atrybuty kreacji z możliwością kierowania Używana w polu supportedCreativeAttribute w tabeli Zasób PretargetingConfig ujawniony w interfejsie API REST kupującego. To pole opisuje atrybuty kreacji, które powinny występować we wszystkich kreacjach odpowiadające jednej konfiguracji kierowania wstępnego.
Atrybuty kreacji możliwe do wykluczenia przez wydawcę Używany w polu excluded_attribute funkcji BidRequest To pole opisuje typy kreacji, które nie są dozwolone przez wydawcę. Może na przykład określić, ograniczenia decydujące o tym, czy używanie plików cookie jest dozwolone oraz czy multimedia lub tekst są dozwolone są dozwolone.
Branże wydawcy Używany w polu detected_vertical funkcji BidRequest To pole określa branże (podobne do słowa kluczowe) na stronie, na której pojawi się reklama. Google generuje przez indeksowanie strony i określenie, które branże są używane.
Dostawcy Używany w polu allowed_vendor_type funkcji BidRequest To pole zawiera listę dostawców Rich Media, takich jak Campaign Monitor i VoiceFive są dozwolone dla wyświetlanej kreacji, zgodnie z wytycznymi wydawcy.

Obejmuje dostawców wycofanej usługi Plik słownika gdn-vendors.txt.

Dostawcy danych Używany w polu SegmentData.id funkcji BidRequest To pole zawiera informacje o jednostce, która podała 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 aplikacji, kategoriami i łatwe do odczytania przez człowieka.
Tabele geograficzne Tabela użyta do zdekodowania pola geo_criteria_id argumentu BidRequest Więcej informacji znajdziesz w artykule Kierowanie geograficzne. i informacjami o nich.
Dostawcy usług w zakresie ustawy LGPD Lista dostawców personalizacji reklam, którzy mogą wyświetlać reklamy w przypadku ruchu zgodnego z ustawą LGPD; z identyfikatorem, nazwą zrozumiałą dla człowieka, adresem URL polityki prywatności i listą domen. które można przypisać dostawcy. Egzekwowanie zasad LGPD jest oznaczone na dla danego pytania o stawkę w BidRequest.adslot.regs_lgpd w protokole ustalania stawek Authorized Buyers, BidRequest.regs.ext.lgpd w protokole ustalania stawek OpenRTB.
Operatorzy komórkowi Lista operatorów komórkowych.
Urządzenia mobilne Lista urządzeń mobilnych.
Systemy operacyjne na urządzeniach mobilnych Lista systemów operacyjnych na urządzenia mobilne.
Dostawcy Mapuje identyfikatory dostawców usług personalizacji reklam na nazwy zrozumiałe dla człowieka, ustawienia prywatności adresu URL zasad oraz listy domen, które można przypisać dostawcy. Obecnie dostawcy są wykorzystywani Pole BidRequest.AdSlot.consented_providers_settings dla AdX protokołu BidRequest.User.UserExt.consented_providers_settings dla OpenRTB protokołu. W tych polach wymienieni dostawcy mają zgodę użytkownika przekazywaną przez wydawców w przypadku użytkowników z krajów Europejskiego Obszaru Gospodarczego.

Ustawienia wydawcy

Poproś o plik publisher-settings.pb.gz ze swojego konta przedstawiciel handlowy.

Tematy dotyczące zasad sprawdzania kreacji

Za pomocą tematów zasad w tym pliku możesz filtrować kreacje w okresie sprawdź w interfejsie Real-time Billing API.

Pobierz tematy zasad w pliku CSV.

Ostatnia aktualizacja: 18 kwietnia 2022 r.