1. 适用范围和名词解释

神策网络科技（北京）有限公司（以下简称 “神策” 或 “我们”）作为官方网站及神策软件产品和服务的运营方，向您（作为使用神策软件产品的企业客户，以下简称 “客户”）提供本说明。

2. IP 地址解析说明

数据来源的 IP 信息通常从服务器（如 Nginx）日志中解析得到。在您的数据上报中，对于前端 SDK 上报的数据（例如 Android、iOS、Web、小程序等 SDK），如果未包含国家（$country）、省份（$province）或城市（$city）等属性，会自动根据数据来源的 IP 地址进行解析。这一过程涉及使用最新的 IP 库来匹配和填充上述属性，旨在为您提供更丰富的数据维度。

IP 地址的地理位置解析主要用于地域分析，协助客户更有效地制定区域化的运营计划。然而，请注意，由于 IP 地址与实际地理位置之间可能会有不定期的变化，特别是受互联网基础设施发展和 IP 分配动态性影响，同一 IP 地址可能在不同时间被分配至不同的地理位置。因此，解析结果可能会因 IP 地理位置信息的变化而存在一定偏差。

我们致力于提高系统的准确性和实时性，但受技术限制和外部因素的影响，不能保证解析结果始终绝对准确。因此，在使用这些解析结果时，建议您充分认识到可能存在的偏差，并根据具体情境酌情考虑其适用性。 

我们感谢您的理解和支持，期待继续为您提供高质量的服务。

3. 常见问题

3.1. 为什么查看国家、省份、城市这些属性会显示「保留 IP」？

这类 IP 通常都是内网 IP，如 172.xxx.xxx.xxx，这类 IP 没有对应的地理位置信息，所以会被解析成「保留 IP」。

3.2. 为什么某些事件无法查询国家、省份、城市这些信息，在自定义查询中，这些属性显示为 NULL？

只有前端 SDK（如 Android、iOS、Web、小程序等 SDK）上报的事件数据，才会进行 IP 解析；后端 SDK 一般认为是从内网上报数据，IP 地址一般也都是统一的内网地址，解析的业务意义不大。

3.3. 如果针对后端 SDK（例如 Java、Python 等 SDK）采集的事件数据，也希望能够进行 IP 解析成地理位置的动作，该如何操作？

在事件的属性中，自主添加「$ip」属性即可。

3.4. 用户表中也有国家（$country）、省份（$province）和城市（$city）这些属性，为什么没有赋值？

IP 解析成地理位置，只对事件数据生效，用户表中的相关属性，需要客户主动采集上报。