Protos & dane referencyjne

wyświetlać i pobierać pliki obsługujące protokół RTB;

Protos

Plik	Opis	Wersja	Ostatnia aktualizacja
cookie-bulk-upload.proto	Użyj tego komunikatu, aby zbiorczo przesłać dane kierowania na użytkowników.	v.24	27 marca 2024 r.
openrtb.proto	Google obsługuje protokół OpenRTB za pomocą kodowania JSON lub Protobuf. Ten protokół jest wymagany, jeśli używasz OpenRTB/Protobuf. Zawiera też dokumentację obsługiwanych pól i ich mapowania na natywny protokół Google.	2.6	18 listopada 2024 r.
openrtb-adx.proto	Protokół OpenRTB Google zawiera niektóre rozszerzenia podane w osobnym pliku proto.	v.181	1 listopada 2024 r.
publisher-settings.proto	Zbiór ustawień wydawcy dotyczących sieci z określaniem stawek w czasie rzeczywistym.	v.14	5 lutego 2024 r.
realtime-bidding.proto	protokół RTB Authorized Buyers firmy Google, To wiadomość, której Google używa do żądania stawek. BidRequest obejmuje boks reklamowy z jednego wyświetlenia.	v.331	1 listopada 2024 r.

Open Beta Protos

Plik	Opis	Wersja	Ostatnia aktualizacja
openrtb-adx.proto	Protokół OpenRTB Google zawiera niektóre rozszerzenia podane w osobnym pliku proto.	v.187	6 listopada 2024 r.
realtime-bidding.proto	protokół RTB Authorized Buyers firmy Google, To wiadomość, której Google używa do żądania stawek. BidRequest obejmuje boks reklamowy z jednego wyświetlenia.	v.342	31 października 2024 r.

Dane referencyjne

słowniki (kliknij, aby pobrać plik .txt);
Kategorie reklam	Używany w polu excluded_product_category w dokumentie BidRequest. To pole opisuje kategorie produktów i usług niedozwolonych przez wydawcę, na przykład gdy wydawca nie chce wyświetlać reklam związanych z bankowością internetową.
Kategorie reklam z ograniczeniami	Używane w polu allowed_restricted_category w dokumentie BidRequest i w polu restricted_category w dokumentie BidResponse. Pole allowed_restricted_categoryopisuje kategorie, które zwykle podlegają ograniczeniom, ale zostały wyraźnie zadeklarowane przez wydawcę jako dozwolone, np. reklamy zawierające treści związane z alkoholem.
Kategorie reklam o charakterze kontrowersyjnym	Używane w polu excluded_sensitive_category w dokumentie BidRequest i w polu category w dokumentie BidResponse. Pole excluded_sensitive_categoryopisuje kategorie o charakterze kontrowersyjnym, które nie są dozwolone przez wydawcę, na przykład jeśli wydawca nie chce wyświetlać reklam związanych z polityką.
Reklamodawcy	Używany w polu advertiser_id obiektu SnippetStatusItem. To pole określa reklamodawcę reprezentowanego przez kreację powiązaną z fragmentem. Ta lista zawiera reklamodawców z całej giełdy i nie odzwierciedla reklamodawców reprezentowanych przez jednego kupującego.
Marki	Lista marek używanych w interfejsie API dostępu klienta.
Atrybuty kreacji deklarowane przez kupującego	Służy do pola attribute w BidResponse. To pole opisuje atrybuty deklarowane przez kupującego w kreacji, które nie mogą się pojawiać w polu excluded_attribute w sekcji BidRequest.
Kody stanu rozszerzeń objaśnień	Kody stanu zwracane przez wywołanie metody performancereport.
Etykiety treści	Używany w polu detected_content_labels w BidRequest.
Kody stanu dopasowywania plików cookie	Używane w polu cookieMatcherStatusRate w raportach skuteczności protokołu RTB. Dostępne kody opisane są w przewodniku Dopasowywanie plików cookie.
Kody stanu kreacji	Używane w creative_status_code zwrócił(a) informacje zwrotne w czasie rzeczywistym.
Kody stanu hostowanego dopasowania	Używane w polu hostedMatchStatusRate w raportach skuteczności protokołu RTB.
Brak przyczyn braku stawek	Standardowe wartości przyczyny braku stawki, które należy podać w polu BidResponse.no_bid_reason w protokole stawek programu Authorized Buyers.
Atrybuty kreacji, które można uwzględnić w precyzyjnym kierowaniu	Służy do określania pola supportedCreativeAttribute w zasobie PretargetingConfig udostępnianym w interfejsie API typu REST dla kupujących. To pole opisuje atrybuty kreacji, które powinny występować 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 dokumentie BidRequest. To pole opisuje typy kreacji, które wydawca uznaje za niedozwolone. Mogą one na przykład określać ograniczenia dotyczące używania plików cookie lub wyświetlania reklam multimedialnych lub tekstowych.
Branże wydawców	Używany w polu detected_vertical w dokumentie BidRequest. To pole określa branże (podobnie jak słowa kluczowe) strony, na której będzie wyświetlana reklama. Google generuje to pole, indeksując stronę i określając, które branże są używane.
Dostawcy	Używany w polu allowed_vendor_type w dokumentie BidRequest. To pole zawiera listę dostawców Rich Media, takich jak Campaign Monitor i VoiceFive, którzy są dozwoleni do wyświetlania kreacji zgodnie z określeniami wydawcy. Obejmuje dostawców z używanego w danej chwili pliku słownikagdn-vendors.txt.
Dostawcy danych	Używany w polu SegmentData.id w dokumentie 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 docelowych aplikacji mobilnych na Androida z ich identyfikatorami, identyfikatorami kategorii oraz czytelnymi nazwami.
Tabele geograficzne	Tabela służąca do dekodowania pola geo_criteria_id w tabelce BidRequest. Więcej informacji znajdziesz w sekcji Kierowanie geograficzne.
Dostawcy w ramach ustawy LGPD	Lista dostawców technologii personalizacji reklam, którzy mogą wyświetlać reklamy w ramach ruchu zgodnego z wymaganiami ustawy o ochronie danych osobowych w Polsce, wraz z ich identyfikatorem, czytelną nazwą, adresem URL dotyczącym prywatności i listą domen, które można przypisać do dostawcy. Egzekwowanie LGPD jest wskazywane w danym żądaniu stawki za pomocą pola BidRequest.adslot.regs_lgpd w protokole ofert Authorized Buyers i pola BidRequest.regs.ext.lgpd w protokole ofert OpenRTB.
Operatorzy komórkowi	Lista operatorów sieci komórkowych.
Urządzenia mobilne	Lista urządzeń mobilnych.
Systemy operacyjne na urządzeniach mobilnych	Lista systemów operacyjnych na urządzenia mobilne
Dostawcy	Dopasowuje identyfikatory dostawców personalizacji reklam do czytelnej nazwy, adresu URL polityki prywatności i listy domen, które można przypisać do dostawcy. Obecnie dostawcy są używani w polu BidRequest.AdSlot.consented_providers_settings w przypadku protokołu AdX i BidRequest.User.UserExt.consented_providers_settings w przypadku protokołu OpenRTB. W tych polach wymienione firmy mają zgodę użytkowników przekazaną przez wydawców w przypadku użytkowników z krajów Europejskiego Obszaru Gospodarczego.

Ustawienia wydawcy

Poproś o plik publisher-settings.pb.gz przedstawiciela swojego konta.

Tematy zasad dotyczących sprawdzania kreacji

Tematy zasad w tym pliku możesz wykorzystać do filtrowania kreacji podczas weryfikacji w interfejsie Real-time Bidding API.

Pobierz tematy dotyczące zasad w pliku CSV.

Ostatnia aktualizacja: 18 kwietnia 2022 r.