Appearance
全国统一 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 的场次),静默时段不要动。半夜推送带来的卸载,远比多一次曝光值钱。
五、接进真实发送队列
上面这段只是个判断器。真跑起来,通常是这么接:
- 消息进库时带上用户 ID 和目标 IP,状态置为
pending; - 定时任务每 5 分钟扫一批
pending,逐条跑decide(); - 命中窗口的调推送通道发出去,状态改
sent,记下发送时刻; - 暂缓的把
next_at写成下一次窗口的起点,状态仍是pending,下一轮自然会被捡起来; - 超过 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 万次/分钟)——不过说实话,推送时段这种「一天只需要判断一次」的场景,缓存做对了,免费版很难被打满。