Google udostępnia zbiorcze listy ustawień wydawców, przesyłając je do zasobnika Google Cloud Storage konkretnego konta (w projekcie należącym do Google). Możesz je pobrać do kierowania, którego nie można ustawić podczas ustalania stawek. Aby włączyć tę funkcję na swoim koncie, skontaktuj się z technicznym menedżerem konta.
Pliki z ustawieniami wydawców można pobierać automatycznie za pomocą interfejsu Cloud Storage API, ręcznie za pomocą interfejsu Google Developer Console lub narzędzia wiersza poleceń gsutil. Więcej informacji o dostępie do danych przechowywanych w Google Cloud Storage znajdziesz w dokumentacji Google Cloud Storage.
Plik jest skompresowany za pomocą programu gzip zgodnie ze standardem RFC 1952. Aby wyodrębnić plik z wiersza polecenia, uruchom polecenie gzip -d <filename>. Aby automatycznie wyodrębnić plik, możesz użyć zlib lub podobnej biblioteki kompresji, która obsługuje format gzip. W efekcie otrzymujemy zbuforowany protokół protokołu podobny do ładunku żądania POST w elemencie BidRequest, który można przeanalizować za pomocą tego fragmentu kodu:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
Definicja bufora protokołu PublisherSettingsList można pobrać ze strony z danymi referencyjnymi. Możesz też poprosić o pomoc skompresowanego pliku publisher-settings.pb.gz. Zawiera ona definicję bufora protokołu oraz przykładowy plik ustawień wydawcy.
Kolejność elementów PublisherSettingsList może się zmienić w każdej chwili.
Nie ma gwarancji co do kolejności ani sortowania. Każdy wpis na liście ustawień wydawcy zawiera identyfikator oraz kilka ustawień, które dotyczą tagu BidRequests oznaczonego tym identyfikatorem. Możesz dodać do systemów ustalania stawek funkcję, aby okresowo sprawdzać nową listę ustawień wydawcy.
Gdy Google otrzyma wyświetlenie, które kwalifikuje się do określania stawek w czasie rzeczywistym, uwzględnia w pytaniu o stawkę identyfikatory odpowiadające wpisom na liście ustawień wydawcy. System ustalania stawek może używać ustawień wydawcy do filtrowania reklam kandydujących do tego wyświetlenia. Aby reklama kwalifikowała się do określonego wyświetlenia, reklama kandydująca musi być zgodna ze wszystkimi ustawieniami wydawcy, w przypadku których w żądaniu wysłano identyfikatory.
Pamiętaj, że brakujące ustawienia wydawcy w pliku pochodzą z identyfikatorów, z którymi nie są powiązane zablokowane adresy URL.
Plik ustawień wydawcy jest podzielony na kilka mniejszych plików, aby zmniejszyć ilość danych, które trzeba pobrać w ramach jednej transakcji. Pliki są podzielone na około 5 MB danych i nazwy jako publisher-settings.0.pb.gz do publisher-settings.n.pb.gz (gdzie n to liczba plików pomniejszona o 1). Aby uzyskać te pliki, skontaktuj się z opiekunem konta.