Google делает доступными сводные списки настроек издателя, загружая их в корзину Google Cloud Storage для конкретной учетной записи (в рамках проекта, принадлежащего Google). Вы можете загрузить их, чтобы использовать для таргетинга, который не может быть выполнен во время торгов. Поговорите со своим техническим менеджером учетной записи, чтобы включить эту функцию для вашей учетной записи.
Файлы, содержащие настройки издателя, можно загрузить программно с помощью Cloud Storage API , вручную через пользовательский интерфейс консоли разработчика Google или с помощью инструмента командной строки gsutil . Дополнительные сведения о доступе к данным, хранящимся в Google Cloud Storage , см. в документации Google Cloud Storage.
Файл сжат gzip в соответствии с RFC 1952 . Чтобы извлечь файл из командной строки, запустите gzip -d <filename> . Чтобы извлечь файл программно, вы можете использовать zlib или аналогичную библиотеку сжатия, которая поддерживает формат gzip. Результатом является сериализованный буфер протокола, аналогичный полезной нагрузке POST-запроса в BidRequest , который можно проанализировать с помощью следующего фрагмента:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
} Определение буфера протокола для PublisherSettingsList можно загрузить со страницы справочных данных . Вы также можете запросить сжатый файл publisher-settings.pb.gz у своего представителя по работе с клиентами. Он содержит определение буфера протокола, а также пример файла настроек издателя.
Порядок PublisherSettingsList может измениться в любое время. Никакой конкретный порядок или сортировка не гарантируются. Каждая запись в списке параметров издателя содержит идентификатор и несколько параметров, которые применяются к BidRequests , помеченным этим идентификатором. Вы можете добавить функцию в свои системы ставок, чтобы периодически проверять наличие нового списка настроек издателя. Когда Google получает показ, подходящий для ставок в реальном времени, Google включает в запрос ставки идентификаторы, соответствующие записям в списке настроек издателя. Ваша система ставок может использовать настройки издателя для фильтрации объявлений-кандидатов на этот показ. Чтобы иметь право на определенный показ, объявление-кандидат должно соответствовать всем записям настроек издателя, идентификаторы которых были отправлены в запросе.
Обратите внимание, что любые отсутствующие настройки издателя в файле связаны с тем, что идентификаторы не имеют связанных с ними заблокированных URL-адресов.
Файл настроек издателя разбит на несколько файлов меньшего размера, чтобы уменьшить объем данных, загружаемых за одну транзакцию. Файлы разбиты на фрагменты примерно по 5 МБ и имеют имена от publisher-settings.0.pb.gz до publisher-settings.n.pb.gz (где n – количество файлов минус один). Чтобы получить эти файлы, обратитесь к своему представителю по работе с клиентами. файлы.