游戏客户端推送跳转：从通知栏到正确页面的状态恢复

推送点击不是简单打开游戏

运营推送常见文案是“奖励待领取”“好友邀请你组队”“世界 Boss 开启”。玩家点通知后，期待直接到对应页面。如果客户端只是启动游戏停在主界面，推送价值会大幅下降；如果盲目跳页面，又会遇到未登录、资源未下载、活动过期、角色不满足条件、路由参数被伪造等问题。

推送跳转需要一条可靠的 Deep Link 管线：解析参数、等待启动、确认登录、检查角色状态、预加载资源、验证目标可用、导航到页面，并在失败时给出合理落点。

flowchart TD
    A[点击系统通知] --> B[保存 Deep Link]
    B --> C[客户端启动/唤醒]
    C --> D{是否已登录?}
    D -->|否| E[登录完成后继续]
    D -->|是| F[校验路由参数]
    E --> F
    F --> G[检查目标状态]
    G --> H{可跳转?}
    H -->|是| I[预加载资源并导航]
    H -->|否| J[回退到安全页面并提示]

冷启动要先保存意图

玩家点击推送时，游戏可能未启动、在后台、在登录页、在战斗中。系统传来的参数应先保存成“跳转意图”，不要立即执行。等客户端完成基础初始化后，再由路由系统消费。

跳转意图应包含来源、目标类型、目标 ID、活动 ID、时间戳、签名或校验信息。它还要有过期时间。几天前的活动推送不应在今天还跳到失效页面。

如果启动过程中来了多个推送意图，优先级要明确。通常最新点击的通知优先，后台静默推送不应覆盖用户主动点击。客户端日志要记录最终消费的是哪一个意图。

登录态和角色态是两道门

Deep Link 不能假设玩家已登录。未登录时，先走登录流程；登录完成后继续跳转。多角色账号还要等玩家选角色。目标可能只对某个服务器或角色有效，参数里应带区服信息或由服务端查询。

角色状态也要检查。玩家正在战斗或剧情中，不能直接跳活动页；可以先记录待跳转，等回到大厅后提示。玩家等级不足、活动未开放、资源缺失时，也要回退到合适页面。

跳转失败不能丢掉用户意图。比如奖励推送过期，可以打开活动中心或邮件页，并提示活动已结束。比停在主界面无反馈更好。

路由参数必须校验

推送参数来自服务端，但客户端仍要校验。目标页面白名单、参数类型、活动 ID 是否存在、URL 是否安全，都要检查。不要让推送直接携带任意内部路由或外部链接。

如果支持外部营销链接拉起游戏，更要严格。外部链接只能映射到允许的 Deep Link 类型，并由服务端或签名验证。客户端不能因为一个 URL 参数就打开支付、领取或敏感设置页面。

路由也要版本兼容。旧客户端收到新活动推送，可能没有对应页面。服务端应按版本筛选推送，客户端也要能识别不支持目标并回退。

资源和页面预热

跳转到活动页、商城页或小游戏时，目标资源可能未加载。路由系统应能声明资源依赖，跳转前显示加载状态。资源下载失败时，提供重试或回退。

不要在启动早期同时做所有下载。先完成登录和主界面基础资源，再为目标页面加载必要资源。玩家点击推送是带着目的来的，加载文案要明确“正在打开奖励页面”，而不是普通 loading。

埋点要串起全链路

推送效果分析需要知道：通知展示、点击、客户端启动、登录完成、跳转成功、跳转失败原因、目标页面停留和转化。客户端至少记录点击后的每个关键阶段。否则运营只看到点击率，不知道为什么转化低。

失败原因很重要：未登录放弃、活动过期、等级不足、资源失败、版本不支持、正在战斗延后。不同原因对应不同改进方向。

小结

推送跳转是一条从系统通知到游戏内部状态的长链路。客户端把点击意图保存、登录角色门禁、参数校验、资源预热、失败回退和埋点串起来，推送才不只是把玩家叫回游戏，而是把玩家带到正确的行动点。
推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。

推送联调时要覆盖冷启动、后台唤醒、未登录、多角色、活动过期、资源缺失、旧版本和战斗中点击。每种场景都记录最终落点，才能保证 Deep Link 不会只在理想状态下可用。