Protos & dane referencyjne

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

Protopy

Plik	Opis	Wersja	Ostatnia aktualizacja
plik-cookie-bulk-upload.proto	Użyj tej wiadomości, aby zbiorczo przesłać dane dotyczące kierowania na użytkowników.	v.24	27 marca 2024 r.
openrtb.proto	Google obsługuje protokół OpenRTB w kodowaniu JSON lub Protobuf. Ten protokół jest niezbędny, jeśli używasz OpenRTB/Protobuf. Zawiera również dokumentację obsługiwanych pól i ich mapowanie na natywny protokół Google.	2.6	23 marca 2024 r.
openrtb-adx.proto	Protokół Google OpenRTB zawiera niektóre rozszerzenia dostarczane w osobnym protokole.	v.171	17 kwietnia 2024 r.
publisher-settings.proto,	Zestaw ustawień wydawcy specyficznych dla sieci kreatora ofert w czasie rzeczywistym.	v.13	5 lutego 2024 r.
realtime-bidding.proto	Protokół RTB Google Authorized Buyers. To wiadomość, której Google używa podczas wysyłania pytań o stawkę. Element BidRequest uwzględnia boks reklamowy z jednego wyświetlenia.	v.324	17 kwietnia 2024 r.

Otwarta wersja beta Protos

Plik	Opis	Wersja	Ostatnia aktualizacja
openrtb-adx.proto	Protokół Google OpenRTB zawiera niektóre rozszerzenia dostarczane w osobnym protokole.	v.174	17 kwietnia 2024 r.
realtime-bidding.proto	Protokół RTB Google Authorized Buyers. To wiadomość, której Google używa podczas wysyłania pytań o stawkę. Element BidRequest uwzględnia boks reklamowy z jednego wyświetlenia.	v.331	17 kwietnia 2024 r.

Dane referencyjne

Słowniki (kliknij, aby pobrać plik .txt)
Kategorie produktów reklamowych	Używana w polu excluded_product_category elementu BidRequest. To pole opisuje kategorie produktów i usług, które nie są dozwolone przez wydawcę, np. gdy nie chce wyświetlać reklam związanych z bankowością internetową.
Kategorie z ograniczeniami reklam	Używana w polu allowed_restricted_category elementu BidRequest i polu restricted_category w BidResponse. Pole allowed_restricted_category zawiera informacje o kategoriach, które są zwykle ograniczone, ale zostały wyraźnie zadeklarowane przez wydawcę jako dozwolone, np. reklamy zawierające treści związane z alkoholem.
Reklamy o charakterze kontrowersyjnym w reklamach	Używana w polu excluded_sensitive_category elementu BidRequest i polu category w BidResponse. Pole excluded_sensitive_category zawiera informacje o kategoriach o charakterze kontrowersyjnym, które nie są dozwolone przez wydawcę, np. gdy nie chce hostować reklam związanych z polityką.
Reklamodawcy	Używana w polu advertiser_id elementu snippetStatusItem. To pole określa reklamodawcę reprezentowanego przez kreację powiązaną z fragmentem kodu. Lista obejmuje reklamodawców z całej giełdy i nie uwzględnia reklamodawców reprezentowanych przez jednego kupującego.
Marki	Lista marek używanych w interfejsie Client Access API.
Deklarowane przez kupującego atrybuty kreacji	Przeznaczone dla pola attribute w BidResponse. To pole opisuje deklarowane przez kupującego atrybuty kreacji, które nie mogą pojawiać się w elemencie excluded_attribute w tagu BidRequest.
Kody stanu objaśnień	Kody stanu zwracane przez wywołanie metody performancereport.
Etykiety treści	Używana w polu detected_content_labels BidRequest.
Kody stanu dopasowania plików cookie	Używany w polu cookieMatcherStatusRate raportów skuteczności protokołu RTB. Dostępne kody opisano w przewodniku po dopasowywaniu plików cookie.
Kody stanu kreacji	Używane w creative_status_code zwrócił(a) opinię w czasie rzeczywistym.
Kody stanu hostowanego dopasowania	Używany w polu hostedMatchStatusRate raportów skuteczności protokołu RTB.
Brak powodów ustalania stawki	Standardowe wartości przyczyny braku stawki do podania w polu BidResponse.no_bid_reason w protokole ustalania stawek Authorized Buyers.
Atrybuty kreacji możliwych do wstępnego kierowania	Używana w polu supportedCreativeAttribute w zasobie PretargetingConfig udostępnianego w interfejsie Buyer REST API. To pole zawiera opis atrybutów kreacji, które powinny występować we wszystkich kreacjach odpowiadających pojedynczej konfiguracji kierowania wstępnego.
Atrybuty kreacji, które można wykluczyć przez wydawcę	Używana w polu excluded_attribute elementu BidRequest. To pole opisuje typy kreacji, które nie są dozwolone przez wydawcę. Mogą one na przykład określać, czy dozwolone jest używanie plików cookie albo czy dozwolone są reklamy multimedialne lub reklamy tekstowe.
Branże wydawcy	Używana w polu detected_vertical elementu BidRequest. To pole określa branże (podobne do słów kluczowych) strony, na której będzie wyświetlana reklama. Google generuje to pole, skanując stronę i określając, które branże zostały użyte.
Identyfikatory sieci sprzedawców	Używana w polu seller_network_id elementu BidRequest. To pole określa sieć sprzedawcy, do której należy wydawca. Zawartość tego pliku jest w kolejności rosnącej na podstawie wartości identyfikatora sieci sprzedawcy.
Dostawcy	Używana w polu allowed_vendor_type elementu BidRequest. W tym polu znajduje się lista dostawców Rich Media, takich jak Campaign Monitor i VoiceFive, którzy są dozwoleni w przypadku wyświetlania kreacji. Obejmuje dostawców z wycofanego pliku słownika gdn-vendors.txt.
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 zrozumiałymi dla człowieka.
Tabele według danych geograficznych	Tabela używana do dekodowania pola geo_criteria_id elementu BidRequest. Więcej informacji znajdziesz w artykule Kierowanie geograficzne.
Dostawcy w związku z ustawą LGPD	Lista dostawców personalizacji reklam, którzy mogą wyświetlać reklamy w przypadku ruchu wynikającego z ustawy LGPD, wraz z ich identyfikatorem, nazwą czytelną dla człowieka, adresem URL polityki prywatności i listą domen, które można przypisać do dostawcy. Egzekwowanie zgodności z ustawą LGPD jest wskazane w polu BidRequest.adslot.regs_lgpd w protokole ustalania stawek Authorized Buyers i w polu 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	Mapy zawierają identyfikatory dostawców usług personalizacji reklam w postaci zrozumiałej dla człowieka nazwy, adresu URL polityki prywatności oraz listy domen, które można przypisać do dostawcy. Obecnie dostawcy są widoczni w polu BidRequest.AdSlot.consented_providers_settings w przypadku protokołu AdX i BidRequest.User.UserExt.consented_providers_settings dla protokołu OpenRTB. Wymienieni dostawcy mają zgodę użytkowników z krajów Europejskiego Obszaru Gospodarczego zgodnie z przekazaną przez wydawców zgodą użytkownika.

Ustawienia wydawcy

Poproś przedstawiciela konta o przesłanie pliku publisher-settings.pb.gz.

Tematy dotyczące zasad sprawdzania kreacji

Tematy zasad w tym pliku mogą służyć do filtrowania kreacji podczas sprawdzania w interfejsie Real-time interfejsu API.

Pobierz tematy dotyczące zasad jako plik CSV.

Ostatnia aktualizacja: 18 kwietnia 2022 r.