Google 通过 Geo
对象提供地理定位信息,这在 OpenRTB 和 Google 协议中都是通用的。本文档更详细地介绍了 Google 如何在出价请求中填充地理位置,并就其使用最佳做法提供了建议。
如何填充地理位置对象
Google 只会通过 IP 地理定位获取设备位置信息,绝不会通过 GPS 或其他来源获取。虽然 OpenRTB 规范支持为用户指定不同的地理位置(例如,家庭住址)和设备(投放广告时所在的设备所在的位置),但 Google 只支持后者。因此,Google 的 OpenRTB 实现仅会填充 BidRequest.device.geo
,而已弃用的 Google RTB 协议仅支持引用设备位置的 BidRequest.geo
字段。
隐私保护
为了保护用户隐私,Google 仅提供由足够数量的用户分享的粗略地理定位,并会根据需要对检测到的位置进行泛化。
位置表示法
Geo
对象支持两种不同的位置表示法:民用位置和地理坐标。
民用地点由以下字段表示:
country
region
metro
city
zip
地理坐标由以下字段表示:
lat
lon
accuracy
在 Google 和 OpenRTB 协议中,这两种表示法包含相同的位置和准确性。例如,如果出价请求以城市级精确度填充 Geo
,则 lat
和 lon
字段将包含已识别城市中心点的纬度和经度,而 accuracy
将是与该城市具有相同面积的圆形的半径。Google 还会将 lat
和 lon
字段的精度限制为 0.01 度。
地理位置定位最佳做法
对于需要自定义地理定位数据的出价方,建议使用大致的 lat
、lon
和 accuracy
字段来执行空间地理定位查询。我们不建议使用 ip
字段进行地理定位,因为 Google 仅以截断形式共享 IP 地址;在地理定位中使用截断的 IP 地址可能会导致结果不太准确。
地理位置表格(已弃用)
已弃用的 Google 实时出价协议的 BidRequest.geo_criteria_id
字段以数字标识符表示地理位置,该标识符会映射到 geo-table.csv(可在“原型和参考数据”页面的“参考表格”部分中下载)中的地理位置。此字段和对应的表现已弃用。您可以使用 Geo
字段获取类似的地理定位信息。
例如,如果出价请求的 Geo
填充了城市级精确度,则 geo_criteria_id
将包含相应城市的代码。您可以使用该 ID 在地理位置表格中查找记录。
Columns
- 条件 ID
- 永久分配的具有唯一性的 ID。在 API 中,这些条件的类型为
Location
。 - 名称
- 地理位置定位最准确的英语名称。
- 规范名称
- 结构化的完全限定英文名称,由目标自己的名称及其父级和国家/地区的名称组成。此字段仅用于区分类似的定位名称,不支持 LocationCriterionService(请改用地理位置名称或条件 ID)。
- 父级 ID
- 父级的条件 ID。包含此字段是为了提供旧版支持,此 ID 在不同数据集之间可能不一致。规范名称是构造层次结构的首选方法。
- 地区代码
- 目标州或省/自治区/直辖市的 ISO 3166-2 区域代码(如果存在)。
- 国家/地区代码
- 与目标相关联的 ISO-3166-1 alpha-2 国家/地区代码。
- 目标类型
允许的值:
- 机场
- 行政区
- 自治区
- 自治市/镇/区
- 行政区
- 城市
- 城区
- 国会选区
- 国家/地区
- 郡
- 省
- 区
- 特定媒体市场区域
- 省份
- Metro
- 市
- 国家公园
- 街区
- 民族自治区
- 其他
- 邮政编码
- 县
- 省
- 区域
- 状态
- 地区
- 电视收视地区
- 联邦属地
- 大学
不可定位的地理位置
根据中华人民共和国的广告法规和法律,要在中国境内为某些类别的产品做广告,您可能需要提供证书和许可。在您的帐号激活之前,您不需要提交证书。在您的帐号启用后,您就会收到有关如何向 Google 提交证书的信息。