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 | 31 października 2024 r. |
| openrtb-adx.proto | Protokół OpenRTB firmy Google zawiera kilka rozszerzeń podanych w osobnym proto. | v.180 | 1 listopada 2024 r. |
| publisher-settings.proto | Zbiór ustawień wydawcy dotyczących sieci z określaniem stawek w czasie rzeczywistym. | v.13 | 5 lutego 2024 r. |
| realtime-bidding.proto | protokół RTB Authorized Buyers firmy Google, Jest to wiadomość, której Google używa do wysyłania zapytań o stawkę. BidRequest obejmuje boks reklamowy z jednego wyświetlenia. |
v.331 | 1 listopada 2024 r. |
Otwarte testy beta Protos
| Plik | Opis | Wersja | Ostatnia aktualizacja |
|---|---|---|---|
| openrtb-adx.proto | Protokół OpenRTB Google zawiera niektóre rozszerzenia podane w osobnym pliku proto. | v.186 | 1 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 produktów reklamowych | Używany w polu excluded_product_category BidRequest. To pole opisuje kategorie produktów i usług, których wydawca nie zezwala na przykład na wyświetlanie 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. |
| Reklamy 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 kodu. Ta lista uwzględnia reklamodawców z całej giełdy i nie uwzględnia reklamodawców reprezentowanych przez jednego kupującego. |
| Marki | Lista marek, która jest używana 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żywane 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 | Używana w polu supportedCreativeAttribute w zasobie PretargetingConfig dostępnym w interfejsie API REST kupującego. To pole opisuje atrybuty kreacji, które powinny występować we wszystkich kreacjach odpowiadających jednej konfiguracji kierowania wstępnego. |
| Atrybuty kreacji, które wydawca może wykluczyć | Używany w polu excluded_attribute 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 wydawcy | 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 wycofanego 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 użyta do zdekodowania pola geo_criteria_id 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 LGPD, wraz z ich identyfikatorem, czytelną nazwą, adresem URL dotyczącym prywatności i listą domen, które można przypisać do danego dostawcy. Przestrzeganie RODO 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 | Mapuje identyfikatory dostawców do personalizacji reklam na nazwy zrozumiałe dla człowieka, adres URL polityki prywatności i listę domen, które można przypisać dostawcy.
Obecnie w polu BidRequest.AdSlot.consented_providers_settings w przypadku protokołu AdX są używane dostawcy, a w przypadku protokołu OpenRTB – BidRequest.User.UserExt.consented_providers_settings. 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
Wyślij prośbę o plik publisher-settings.pb.gz do przedstawiciela obsługi klienta.
Tematy zasad dotyczących sprawdzania kreacji
Tematy zasad w tym pliku możesz wykorzystać do filtrowania kreacji podczas sprawdzania w interfejsie Real-time Bidding API.
Pobierz tematy zasad w pliku CSV.Ostatnia aktualizacja: 18 kwietnia 2022 r.