自研 IP 库与 AppsFlyer 地理位置判定不一致，该如何排查？

做海外买量或归因对接的同学，大概率遇到过这种情况：同一批设备，AppsFlyer 归因报表里的国家/城市和自研系统用 IP 库解析出来的结果对不上。比例小的时候大家相视一笑，比例大了就会影响定向、预算分配甚至反作弊判断。

先说结论：这种不一致大部分是正常现象，而不是 Bug。两个系统的数据源、更新时机、判定逻辑天然不同。真正的工作不是追求 100% 一致，而是让差异可解释、可监控。下面按"理解差异 → 定位原因 → 建立机制"三步展开。

一、先搞清楚 AppsFlyer 是怎么判定的

排查之前，先要明白对方在做什么。

1. AppsFlyer 的 IP 地理位置转换依赖第三方 IP 库。据其官方文档说明，AppsFlyer 使用 Digital Element（业界常见的 IP 地理定位数据服务商）将 IP 地址转换为地理位置信息，且映射表通常每周更新一次，并非实时查询。这意味着：某个 ISP 这周刚重新分配了 IP 段，AF 可能要下周才反映出来——"时差"是结构性的。
2. AF 官方自己也在文档中列出了位置差异的常见原因，包括：数据库抓取时点不同、ISP 变更导致 IP 与地理位置映射快速变化、不同平台使用的数据粒度或套餐不同，以及用户通过 VPN/代理上网导致解析到的是出口地址而非真实位置。
3. 判定时点问题。AF 归因记录里的 country_code 等 geo 字段，基于安装（首次打开）时设备请求的 IP。如果用户周一在 A 国点击了广告、周五到 B 国才首次激活，点击 IP 和转化 IP 天然漂移——这甚至不是数据错误，而是行为本身如此。

二、系统排查四步走

第 1 步：统一比对口径，排除"假差异"

• 确认双方时间范围、时区一致；和 AF 对账要用"按事件发生日"的活动数据口径，而不是 LTV 或 cohort 口径（后者会因归因回溯不断重述历史数据）。
• 确认你比的是同一个字段：country_code（基于 IP 的地理判定），而不是设备语言、系统地区或应用商店地区——这几个字段在 AF 报表里是分开的。

第 2 步：拿具体 IP 做"单点溯源"

从 AF 导出 installs 的 raw data，抽出不一致的记录，逐条对比：

• 用 2~3 个独立第三方源交叉查这个 IP（例如 Digital Element、MaxMind、ipinfo 等 IP 地理库各查一次），判断是哪一方的库"错了"，或者双方都错了。
• 重点查这个 IP 的 ASN 和网络类型：是住宅宽带/移动网络，还是数据中心、代理、VPN。VPN、iCloud 私密中继、蜂窝网络跨境出口、运营商级 NAT（CGNAT）都会造成漂移。这部分天然对不上，应归入"污染桶"，不要拿去评估定向命中率。

第 3 步：按差异类型分类处理

第 4 步：确认自研侧没有问题

• 检查自研库的版本和更新频率。一个几个月没更新的免费库（例如老版本 GeoLite）在争议仲裁中基本不可信。学术界对不同商业 IP 库的对照研究显示，国家层面准确率普遍很高，但城市级一致性最低时只有 26%~29%——所以城市级对不上，很可能双方都没错，只是数据源不同。
• 服务端确认取 IP 的方式正确：优先取 TCP 直连 IP；使用 CDN 或网关时谨慎解析 XFF 头，防止把出口节点 IP 当成用户 IP。

三、长期机制：接受差异、控制差异

1. 对齐基准数据源。 最接近"根治"的办法是自研侧也采用与 AF 同等级别的商业 IP 库（如 Digital Element，或 MaxMind 的商业版 GeoIP2 等），把"口径差"缩到最小。至少在国家层面，主流商业库的准确率普遍能达到 99.9% 以上，剩下的分歧会集中在城市级和网络类型上。

2. 分桶对账。 只对"住宅/移动网络且无代理标签"的正常流量评估命中率；VPN、数据中心、代理等污染桶单独统计占比。污染桶占比突然升高，往往意味着流量质量出了问题（刷量、异常渠道），这时地理差异反而是个有用的预警信号。

3. 加前置校验。 在点击/激活日志中独立记录 IP 归属地、ASN、网络类型；与 AF 结果差异超过阈值（例如 500km）的记录自动标记或降权。可疑转化还可以结合 AppsFlyer 的 Validation Rules 或 Protect360 做拦截。

4. 设容忍度 + 告警。 日常看趋势，不盯单点。建议：国家维度差异持续超过 5%~10%，或异常 IP 占比突增时，启动个案排查；其余时间接受它。

结语

一句话总结排查心法：单点差异找网络环境（VPN/代理/出口漂移），系统差异找库版本（更新频率和数据商不同），趋势性异常找流量质量。IP 地理定位本身就是概率性的，两个系统 100% 一致既不现实也不必要——把差异控制在可解释、可监控的范围内，才是工程上正确的目标。