Skip to content

全国统一 20:00 发推送,新疆用户还在下班路上:按 IP 归属地给各省排发送时段(Node.js 实现) ​

有个做资讯 App 的团队跟我聊过一件事:他们的晚间推送统一定在 20:00,全国一批发出去。数据上看不出大问题,直到有人把打开率按省份拆开——新疆、西藏的用户明显低一截,而这两个地方的卸载和关闭通知比例偏高。运营一开始怀疑是内容偏好,换了几轮选题也没起色。

真正的原因简单得有点好笑:北京时间 20:00,对乌鲁木齐的人来说是傍晚 18 点。 那边上下班本来就晚,20 点很多人还在通勤、还没吃晚饭,手机在口袋里震一下,看一眼标题就划掉了。而等到北京时间 22:40,乌鲁木齐是当地 20:40,正是刷手机的时候,广东的用户已经准备睡了。

一条推送发出去的时刻是绝对的,用户的「体感时间」是相对的。全国统一时间,本质上是拿东部沿海的作息给全国定闹钟。

一、这件事不需要算时区,需要一张作息偏移表 ​

先说个容易走偏的方向:很多人一听「按地区发推送」,第一反应是算时区。国内用户全是 UTC+8,时区完全一样,算出来没有任何区别。

真正的差异是作息。新疆官方使用北京时间,但当地生活节奏普遍比东部晚约两小时——上班晚、吃饭晚、睡觉晚。西藏也有类似情况,只是幅度小一些。这种差异不是时区问题,是生活习惯问题,任何时区库都算不出来。

所以方案就变成了:用 IP 归属地拿到省份,再查一张「省份 → 作息偏移」的表,把北京时间换算成「当地时间」,最后判断当下在不在发送窗口里。

三个参数就够:

  • 偏移表:新疆 +2 小时、西藏 +1.5 小时,其余先给 0 或半小时;
  • 发送窗口:按当地时间给两个,上午 10:00–12:00、晚上 19:00–21:30;
  • 静默时段:当地时间 22:00 到次日 8:00,一律不发。

注意偏移表是经验值,不是标准。它应该由你自己的打开率数据校准:把「推送时刻—打开率」按省份画出来,峰值在哪就把窗口挪到哪。一开始拍脑袋给个数没问题,但别把它当真理写死在代码里,做成配置。

二、海外用户才需要真时区 ​

国内走偏移表,海外用户就得老老实实算时区了。这里有个取舍:

IP 归属地接口给的是国家、省市、经纬度,没有 timezone 字段。用经度除以 15 粗算时区,对美国、俄罗斯、澳大利亚这种跨时区大国会错得离谱——洛杉矶和纽约差 3 小时,同一个国家。所以海外的正确做法是按 country_code 查一张国家时区表,经度粗算只当兜底。

好在国内业务的海外用户占比通常不高,先按国家表 + 经度兜底跑起来,比为了 3% 的用户接一套完整时区库划算。

三、Node.js 实现 ​

结构:查归属地(带缓存)→ 换算当地时间 → 判断窗口 → 给出「发送 / 暂缓 + 原因」。发送本身交给你的推送通道,这段只负责「该不该现在发」。

javascript
// push-window.mjs —— 按 IP 归属地给推送排发送时段
import fs from 'node:fs';

const API = 'https://ip9.com.cn/get';
const CACHE_FILE = '.ipgeo-cache.json';
const TTL = 30 * 86400 * 1000;
const cache = fs.existsSync(CACHE_FILE)
  ? JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'))
  : {};

// 省份作息偏移(小时):经验值,上线后用自己的打开率数据校准
const PROV_SHIFT = { 新疆: 2, 西藏: 1.5, 青海: 1, 甘肃: 0.5, 宁夏: 0.5, 内蒙古: 0.5 };

// 全国通用的两个黄金时段(按当地时间,单位:分钟)
const WINDOWS = [[10 * 60, 12 * 60], [19 * 60, 21 * 60 + 30]];
const QUIET_START = 22 * 60;   // 22:00 之后不推
const QUIET_END = 8 * 60;      // 8:00 之前不推

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function lookup(ip, retry = 1) {
  const hit = cache[ip];
  if (hit && Date.now() - hit.ts < TTL) return { ...hit, cached: true };

  const url = `${API}?ip=${encodeURIComponent(ip)}`;
  let res;
  try {
    res = await fetch(url, {
      headers: { 'User-Agent': 'ip9-push-window/1.0' },
      signal: AbortSignal.timeout(5000),
    });
  } catch (e) {
    return { ok: false, reason: 'network' };
  }
  if (res.status === 429 && retry > 0) {
    await sleep(2000);
    return lookup(ip, retry - 1);
  }
  if (res.status === 400) return { ok: false, reason: 'bad_ip' };
  if (!res.ok) return { ok: false, reason: `http_${res.status}` };

  const body = await res.json();
  if (body.ret !== 200 || !body.data) return { ok: false, reason: `ret_${body.ret}` };

  const d = body.data;
  const geo = {
    ok: true,
    ts: Date.now(),
    ip: d.ip,
    country: d.country || '',
    countryCode: (d.country_code || '').toLowerCase(),
    prov: d.prov || '',
    city: d.city || '',
    lng: Number(d.lng) || 0,
  };
  cache[ip] = geo;
  return geo;
}

/** 返回该用户此刻的「当地时间」分钟数 */
function localMinutes(geo, now = new Date()) {
  if (geo.countryCode && geo.countryCode !== 'cn') {
    // 海外只按经度粗算,跨时区大国会错,正式环境改成按国家查表
    const offset = Math.round(geo.lng / 15);
    return ((now.getUTCHours() * 60 + now.getUTCMinutes() + offset * 60) % 1440 + 1440) % 1440;
  }
  const shift = (PROV_SHIFT[geo.prov] ?? 0) * 60;
  const bj = now.getUTCHours() * 60 + now.getUTCMinutes() + 8 * 60;
  return ((bj - shift) % 1440 + 1440) % 1440;
}

function decide(geo, now = new Date()) {
  // 内网/保留地址:ret=200 但 prov 为空、country_code 也为空,同样算「属地未知」
  const known = geo.ok && (geo.prov || (geo.countryCode && geo.countryCode !== 'cn'));

  if (!known) {
    const bj = ((now.getUTCHours() * 60 + now.getUTCMinutes() + 8 * 60) % 1440 + 1440) % 1440;
    const send = WINDOWS.some(([s, e]) => bj >= s && bj < e);
    return {
      send,
      local: bj,
      reason: send ? '属地未知,按全国默认时段发送' : '属地未知,按全国默认时段暂缓',
    };
  }

  const local = localMinutes(geo, now);
  const inWindow = WINDOWS.some(([s, e]) => local >= s && local < e);
  if (inWindow) return { send: true, local, reason: '命中时段' };

  const quiet = local >= QUIET_START || local < QUIET_END;
  const next = WINDOWS.map(([s]) => (s - local + 1440) % 1440).sort((a, b) => a - b)[0];
  return {
    send: false,
    local,
    reason: quiet ? `静默时段,${next} 分钟后再排` : `${next} 分钟后进入下一时段`,
  };
}

const fmt = (m) => `${String(Math.floor(m / 60)).padStart(2, '0')}:${String(m % 60).padStart(2, '0')}`;

async function main() {
  const file = process.argv[2] || 'pending.json';
  const pending = JSON.parse(fs.readFileSync(file, 'utf8'));
  const now = process.argv[3] ? new Date(process.argv[3]) : new Date();
  const result = { sent: [], held: [], failed: [] };

  for (const msg of pending) {
    const geo = await lookup(msg.ip);
    const d = decide(geo, now);
    const row = { user: msg.user, ip: msg.ip, prov: geo.prov || '-', city: geo.city || '-', local: fmt(d.local ?? 0) };

    if (!geo.ok) result.failed.push({ ...row, reason: geo.reason });
    else if (d.send) result.sent.push(row);
    else result.held.push({ ...row, reason: d.reason });

    console.log(
      `${String(msg.user).padEnd(10)} ${msg.ip.padEnd(16)} ${(geo.prov || '-').padEnd(5)}` +
      `${(geo.city || '-').padEnd(7)} 当地 ${fmt(d.local ?? 0)}  ${d.send ? '发送' : '暂缓'}  ${d.reason}`
    );

    if (!geo.cached) await sleep(1050);   // 免费版 60 次/分钟
  }

  fs.writeFileSync(CACHE_FILE, JSON.stringify(cache));
  console.log(`\n发送 ${result.sent.length} 条,暂缓 ${result.held.length} 条,属地未知 ${result.failed.length} 条`);
}

main();

拿四条真实 IP,模拟两个时刻看效果。北京时间 22:40(UTC 14:40)跑一遍:

u2001  61.128.96.1    新疆  乌鲁木齐  当地 20:40  发送  命中时段
u2002  202.96.128.86  广东  广州      当地 22:40  暂缓  静默时段,680 分钟后再排
u2003  192.168.1.1    -     -         当地 22:40  暂缓  属地未知,按全国默认时段暂缓
u2004  8.8.8.8        -     -         当地 07:40  暂缓  静默时段,140 分钟后再排

发送 1 条,暂缓 3 条,属地未知 0 条

这就是整件事想要的效果:同一个时刻,新疆用户收到的是「晚上八点半」的推送,广东用户被拦在静默时段外,海外用户按当地 07:40 也拦住了。如果按老办法全国一起发,这三类人会在同一秒被同一个推送打扰。

四、几个实现上的坑 ​

ret=200 不等于有归属地。 内网地址、100.64/10 这类保留地址,接口返回 200,但 prov、city 是空串。代码里如果只判 ok,这批用户会被当成「北京时间偏移 0」,跟着全国一起发。所以 decide() 里额外判断了「有没有省级信息」,没有就走降级路径。

属地未知的用户,不能用「不发」来兜底。 降级策略我选的是「按全国默认时段发」,而不是直接丢弃。原因很实际:内网 IP、代理、企业出口都会让归属地查不出来,如果这些用户永远收不到推送,等于给一部分人静默关掉了通知。

限速要卡在循环里,不要卡在函数里。 await sleep(1050) 放在每次真实请求之后,约 57 次/分钟,刚好在免费版 60 次/分钟以内。批量补发的时候特别容易忘——几百条消息一口气打出去,前 60 条成功,后面全是 429,然后你会以为接口挂了。

缓存按 IP 存,TTL 给 30 天。 同一个用户每天都在同一批 IP 段上,缓存命中率会非常高,实际接口调用量只有「新 IP 数」那么多。TTL 别设太短,IP 段归属地是以月为单位变的。

静默时段是硬约束,窗口是可调参数。 窗口可以按业务改(比如电商大促想加一个 12:30 的场次),静默时段不要动。半夜推送带来的卸载,远比多一次曝光值钱。

五、接进真实发送队列 ​

上面这段只是个判断器。真跑起来,通常是这么接:

  1. 消息进库时带上用户 ID 和目标 IP,状态置为 pending;
  2. 定时任务每 5 分钟扫一批 pending,逐条跑 decide();
  3. 命中窗口的调推送通道发出去,状态改 sent,记下发送时刻;
  4. 暂缓的把 next_at 写成下一次窗口的起点,状态仍是 pending,下一轮自然会被捡起来;
  5. 超过 24 小时还没发出去的(比如用户一直在静默时段、或者属地一直查不到),按业务规则过期处理,别无限堆在队列里。

有几个细节值得提前定好:

幂等。 同一条消息被两个 worker 同时捡到,会发两次。用「状态 + 版本号」或者数据库行锁把领取动作做成原子的,比事后去重便宜。

窗口边界别扎堆。 所有暂缓的消息都会在窗口开启的那一分钟集中到点,如果队列没有平滑,推送通道会在 19:00 整收到一个尖峰。按分钟把 next_at 打散,或者发送侧做漏桶,都能缓解。

别用「用户上次活跃时间」替代 IP。 这两个数据回答的是不同问题:活跃时间说明他什么时候可能看手机,IP 归属地说的是他在哪个作息时区。前者会被加班、熬夜污染,后者稳定得多。

偏移表要能被运营改。 写死在代码里,下次想给东北冬天单独提前一小时,就得发版。放配置中心或者数据库,改完下一轮扫描就生效。

六、合规上的两句提醒 ​

IP 是个人信息,为了排推送时段而长期存原始 IP,没必要。查完就把 prov、city 落到用户画像上,原始 IP 按留存期删掉或者哈希,隐私政策里写明「我们会根据访问 IP 判断大致所在城市,用于内容本地化与消息发送时段优化」。

另外,别把「作息偏移」做成对用户的画像标签。它的用途是「不打扰」,不是「判断这个人是哪的人、消费能力如何」。用途写清楚,边界守住,这类数据用起来才踏实。

总结 ​

这件事的成本比想象中低:一张偏移表、一个判断函数、一个每 5 分钟跑的定时任务。收益却很直接——同样一条推送,新疆用户终于在自己方便的时段收到,广东用户不会在睡前被震一下,海外用户不会在凌晨被吵醒。

代码里的归属地查询走的是 https://ip9.com.cn/get?ip=<ip>,不传 ip 参数时返回请求方自己的归属地,免费版 60 次/分钟,配上 30 天缓存后,一个日活几万的 App 完全够用。字段和返回样例可以在 https://www.ip9.com.cn 上直接看。真到了每天几百万条推送、要给每个用户实时判断的程度,再考虑 VIP 版的额度(18 万次/分钟)——不过说实话,推送时段这种「一天只需要判断一次」的场景,缓存做对了,免费版很难被打满。