实时出价工具发布商设置

Google 通过将汇总的发布商设置列表上传到特定 Google Cloud Storage 存储分区（在 Google 拥有的项目下），提供这些名单。您可以下载这些凭据以用于在出价时无法定位的定位条件。请与您的技术支持客户经理联系，为您的帐号启用此功能。

您可以使用 Cloud Storage API 以编程方式下载包含发布商设置的文件，也可以通过 Google Developers Console 界面手动下载，或者使用 gsutil 命令行工具来下载。如需详细了解如何访问存储在 Google Cloud Storage 中的数据，请参阅 Google Cloud Storage 文档。

相应文件已按照 RFC 1952 进行 gzip 压缩。如需从命令行提取文件，请运行 gzip -d <filename>。如需以编程方式提取文件，您可以使用 zlib 或支持 gzip 格式的类似压缩库。结果会生成序列化协议缓冲区，类似于 BidRequest 中 POST 请求的载荷，并可使用以下代码段对其进行解析：

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 会在出价请求中添加与发布商设置列表中的条目对应的标识符。您的出价系统可以使用发布商设置来过滤相应展示的候选广告。为了符合指定的展示条件，候选广告必须符合发布商针对请求中发送的标识符的所有设置条目。

请注意，文件中的任何发布商设置都因标识符没有与之相关联的屏蔽网址而存在。

发布商设置文件会拆分成多个较小的文件，以减少必须在单个事务中下载的数据量。这些文件会拆分为大约 5 MB 的块和名称，格式为 publisher-settings.0.pb.gz 到 publisher-settings.n.pb.gz（其中 n 是文件数减 1）。如需获取这些文件，请与您的客户代表联系。