Google 通过 Geo 对象提供地理位置信息。本文档详细介绍了 Google 如何在出价请求中填充地理定位信息,并建议了使用地理定位信息的最佳实践。
地理位置对象的填充方式
Google 仅支持描述广告将呈现的设备的位置的地理定位信息,该信息在 BidRequest.device.geo 中公开。此位置信息仅通过 IP 地理定位获取,绝不会通过 GPS 或其他来源获取。
隐私保护
为了保护用户隐私,Google 只提供足够多的用户共享的粗略地理位置,并根据需要对检测到的位置进行泛化处理。
位置表示形式
Geo 对象支持两种不同的位置表示形式:民用位置和地理坐标。
民用位置由以下字段表示:
countryregionmetrocityzip
地理坐标由以下字段表示:
latlonaccuracy
这两种表示形式包含相同的位置和准确度。例如,如果出价请求以城市级精度填充 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 & Reference Data 页面参考表格部分中可供下载的 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 提交证书的信息。