该对象封装了指定地理位置的多种方式。当从属于 Device 对象时,它表示设备的位置,也可理解为用户的当前位置;当从属于 User 对象时,它表示用户常驻地(home base,即不一定是其当前位置)。lat/lon 属性只有在其精度符合 type 属性所刻画的精度时才应传递;例如,邮编等地理区域的质心不应被传递。译稿校对中ENThis object encapsulates various methods for specifying a geographic location. When subordinate to a Device object, it indicates the location of the device which can also be interpreted as the user’s current location. When subordinate to a User object, it indicates the location of the user’s home base (i.e., not necessarily their current location). The lat/lon attributes should only be passed if they conform to the accuracy depicted in the type attribute. For example, the centroid of a geographic region such as postal code should not be passed.
| Attribute | Type | Description |
|---|---|---|
| lat | float | 纬度,取值范围 -90.0 至 +90.0,负值表示南纬。译稿校对中ENLatitude from -90.0 to +90.0, where negative is south. |
| lon | float | 经度,取值范围 -180.0 至 +180.0,负值表示西经。译稿校对中ENLongitude from -180.0 to +180.0, where negative is west. |
| type | integer | 位置数据来源;在传递 lat/lon 时建议一并传递。参见 AdCOM 1.0 列表:位置类型(List: Location Types)。译稿校对中ENSource of location data; recommended when passing lat/lon. Refer to List: Location Types in AdCOM 1.0.枚举 Location Types · 3 个值1GPS/Location Services 2IP Address 3User Provided (e.g., registration data) |
| accuracy | integer | 估计的定位精度,单位为米;当 lat/lon 已指定且源自设备定位服务(即 type = 1)时建议传递。注意:此为设备上报的精度,确切含义请参阅对应操作系统的文档(如 Android、iOS)。译稿校对中ENEstimated location accuracy in meters; recommended when lat/lon are specified and derived from a device’s location services (i.e., type = 1). Note that this is the accuracy as reported from the device. Consult OS specific documentation (e.g., Android, iOS) for exact interpretation. |
| lastfix | integer | 自本次定位确立(geolocation fix)以来经过的秒数。注意:设备可能跨多次读取缓存位置数据;理想情况下,该取值应自实际定位时刻起算。译稿校对中ENNumber of seconds since this geolocation fix was established. Note that devices may cache location data across multiple fetches. Ideally, this value should be from the time the actual fix was taken. |
| ipservice | integer | 如适用(即 type = 2),用于根据 IP 地址判定地理位置的服务或提供方。参见 AdCOM 1.0 列表:IP 定位服务(List: IP Location Services)。译稿校对中ENService or provider used to determine geolocation from IP address if applicable (i.e., type = 2). Refer to List: IP Location Services in AdCOM 1.0.枚举 IP Location Services · 6 个值1ip2location 2Neustar (Quova) 3MaxMind 4NetAcuity (Digital Element) 51151Degrees (High Confidence) 51251Degrees (Medium Confidence) |
| country | string | 国家代码,采用 ISO-3166-1-alpha-3 编码。译稿校对中ENCountry code using ISO-3166-1-alpha-3. |
| region | string | 地区代码,采用 ISO-3166-2 编码;如为美国,则使用两位字母的州代码。译稿校对中ENRegion code using ISO-3166-2; 2-letter state code if USA. |
| regionfips104 | string | 国家下属地区,采用 FIPS 10-4 表示法。OpenRTB 仍支持该属性,但 FIPS 10-4 标准已于 2008 年被 NIST 废止。译稿校对中ENRegion of a country using FIPS 10-4 notation. While OpenRTB supports this attribute, it was withdrawn by NIST in 2008. |
| metro | string | Google 都市圈代码(metro code);与尼尔森 DMA 类似但不完全相同。代码表链接参见附录 A。译稿校对中ENGoogle metro code; similar to but not exactly Nielsen DMAs. See Appendix A for a link to the codes. |
| city | string | 城市,采用联合国贸易与运输地点代码(United Nations Code for Trade & Transport Locations)。代码表链接参见附录 A。译稿校对中ENCity using United Nations Code for Trade & Transport Locations. See Appendix A for a link to the codes. |
| zip | string | 邮政编码(ZIP 或 postal code)。译稿校对中ENZIP or postal code. |
| utcoffset | integer | 当地时间相对 UTC 的偏移量,以分钟数正负值(+/-)表示。译稿校对中ENLocal time as the number +/- of minutes from UTC. |
| ext | object | 供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Geo 的挂载语义:挂在 Device 下表示设备位置(可近似理解为用户当前位置);挂在 User 下表示用户常驻地(home base)。业内文档一般保留英文对象名 Geo。译稿校对中
lat/lon 与 type 的一致性:经纬度只有在其精度符合 type 所声明的来源时才应传递;地理区域的质心(如邮编区质心)并非设备或 IP 级定位结果,不得冒充传递——这是合规与反作弊审计中的常见核查点。译稿校对中
隐私合规提示:精确经纬度属敏感个人数据;GDPR/CCPA 适用流量下,位置传递需有合法基础(同意或正当利益),且精度传递应遵循最小必要原则(如降级到城市级)。译稿校对中
lastfix 的新鲜度价值:设备可能在多次读取间缓存位置数据,lastfix 理想情况下应自实际定位时刻起算;竞价方可据此评估位置数据的新鲜度。译稿校对中
regionfips104 的退出建议:FIPS 10-4 已被废止,仅为向后兼容保留;新接入方应使用 region(ISO-3166-2)。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中