Google делает доступными агрегированные списки настроек издателей, загружая их в корзину Google Cloud Storage для конкретного аккаунта (в рамках проекта, принадлежащего Google). Вы можете загрузить их и использовать для таргетинга, который невозможно выполнить во время торгов. Поговорите со своим техническим менеджером по работе с клиентами, чтобы включить эту функцию для вашей учетной записи.
Файлы, содержащие настройки издателя, можно загрузить программно с помощью API Cloud Storage , вручную через пользовательский интерфейс консоли разработчика 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 — количество файлов минус один). Чтобы получить эти файлы, обратитесь к представителю своего аккаунта. файлы.