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.325 | 25 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.332 | 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 |
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.