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