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łownika |
| 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.