《移动游戏产品的架构·商业化与发行工程》3.2 渠道 SDK 接入契约与初始化顺序
渠道 SDK 的接入顺序不是经验值。本节以《潮汐消消》6 个 SDK 与《潮汐方舟》5 个 SDK 为样本,把隐私同意、登录、支付、广告、统计、推送、分享之间的依赖写成可校验的初始化契约,给出拓扑排序、失败策略与退化能力的判定方法,并说明哪些能力允许降级、哪些必须阻塞。
category
渠道 SDK 的接入顺序不是经验值。本节以《潮汐消消》6 个 SDK 与《潮汐方舟》5 个 SDK 为样本,把隐私同意、登录、支付、广告、统计、推送、分享之间的依赖写成可校验的初始化契约,给出拓扑排序、失败策略与退化能力的判定方法,并说明哪些能力允许降级、哪些必须阻塞。
引擎扩展点不是把内部函数暴露出去,而是用四类稳定接口换取可治理的多样性。本节定义节点类型、策略、存储、观测四类扩展点与插件不能触碰的六条负边界,给出基于引擎 API 版本与 engineRange 的兼容判定、可运行注册表,并说明主次版本升级与扩展点弃用的处理顺序。
疲劳不是突然发生的:A 睡眠 6.8 小时、体检在 18 个月前、近 6 个月两次连续低落;B 睡眠 6.2 小时、近 3 个月运动 0 次;C 睡眠 7.3 小时、每周运动 3 次。本节把可观察信号做成清单,算出每周恢复赤字,并给出可执行的恢复预算。
董事会不是身份象征,而是一台有固定运行成本的决定机器。本节把席位、观察员和信息权拆成可计算的量:三席董事会一年开几次会、表决多少事项、披露多少信息,以及多一个观察员每年增加多少会议与准备成本、多让渡多少决策节奏,并折算为可复算的年度小时与美元成本。
不做清单不是拒绝客户,而是把边界变成可报价的条款。本节用 ClinicQueue 单客交付 715 美元、不做项 10 小时折 650 美元、范围内工时占比 52.4%,拆解包含项、范围外项、假设与变更单,并对照 DevTape 企业单 960 美元和 ChartKit 18 美元的交付形态。
单能力优化收口之后,三个能力串成一条工作流会带来四类新成本:跨能力调用、上下文复用、结果传递与失败传播。本节用可复算的三能力场景跑出交接税、成功概率与回本复用率,并给卷三留下三个必须回答的编排问题,并附上可运行的 TypeScript 模块。
声明式与代码编排的分界不在语言,而在谁维护、怎么测试、怎么灰度、能力上限在哪。本节用「回声」链路 A 的四节点定义给出四条判据与混合方案:结构声明化、节点代码化、边界固定化,说明如何同时保留可治理性、表达力与秒级回滚能力,以及哪些需求必须交回代码。
生态伙伴卖的不是流量,是工作流里的位置。本节拆开 Verba 的平台 35% 与伙伴 15%:20% 与 15% 的分成如何按收入加权成 22.5%,每条腿的净贡献是多少,以及隐藏的支持成本、伙伴依赖与退出条款为什么共同决定集成的真实回报。
过程可见不是把日志全打开,而是让用户看到与责任匹配的步骤。本节把步骤分成必看、可看、不必看三类,给出判定标准,并为 A Relay、B Quill、C Runner 各列一份清单;同时说明可见性不足如何变成反复确认、弃用和投诉,以及可见性过高为什么会变成阅读负担。
摘要节点的单步失败率升到 12%,整条链路成功率掉到 98.12%,错误预算已经烧掉 1.88 倍。本节给出编排事故的止血顺序:停新任务、降级节点、回滚版本、保数据,再验证恢复;把顺序写成带证据门槛的状态机,并给出一张缺项就不能结案的复盘表。附可运行的 TypeScript 模块与 21 项测试。
渠道不是越全越好。本节以《潮汐消消》9 个渠道、11 个渠道包与国内安卓 55%、iOS 30%、TapTap 8%、海外 7% 的构成为样本,把分成、审核时长与包体增量压成一张可比矩阵,给出覆盖目标下的渠道裁剪规则与包数预算,并说明国内安卓与海外商店的取舍边界。
整体 SLO 达标,节点 SLO 却可能已经红了。本节把三能力链路拆成串行、并行与人工节点,给出可用率相乘、延迟相加、并行取弱、人工单列的合成规则,并用示例样本跑出 99.0023% 的整体可用率如何掩盖 99.3% 的摘要节点,附可运行的 TypeScript 合成器与 21 项测试。
三种形态的收入归零 runway 是 11.0、7.0、17.1 个月,但单点事件才是分水岭:A 的产品消失剩 11.0 个月,B 的主业消失剩 9.9 个月,C 的大客户消失后按公式只剩 61.9 个月。本节用 TypeScript 模型逐个事件做压力测试,并给出形态切换的触发条件。
融资到账后,报表就从一次性材料变成每月产品。本节固定五个字段(现金、收入、流失、Pipeline、风险),用 LedgerLite 的月报演示口径如何与卷一保持一致,并计算每月 4 小时、一年 48 小时的维护成本,以及口径漂移带来的返工代价。
七个问题把客户的模糊需求翻译成可验收的记录。本节给出触发、流程、影响、指标、约束、决策、承诺的顺序,用 ClinicQueue 34 场发现会到 24 场演示的 70.6% 转化、DevTape 企业单 38 天周期与 ChartKit 试用 10.2% 订阅率,说明问题清单怎样嵌入不同销售模式。
免费额度不是营销预算,而是按实际用量计价的渠道成本。本节用 Verba 的 8,000 个免费账户算清 1,411.20 美元月成本、70% 额度利用率与 2,016 美元最坏情况,并给出从成本到额度、再到单价的一条真正可复算的完整定价顺序。
单次请求的日志回答不了编排层的四个问题:这次调用属于哪条工作流、上游是谁、第几次尝试、用的哪版模型与提示。本节给出一次编排 trace 的九个最小字段、节点边界的两段式采集、从事件重建节点树与关键路径的算法,并用三能力样本跑出 4 个 span、3,786 微元与 1,269ms 的确定性结果。
三个案例的形态不是偏好,而是自主度与责任位置的对应:A Relay 的建议嵌在工单页,B Quill 的草稿长在编辑器里,C Runner 的执行放在后台。本节逐案说明形态与自主度的关系,给出混合形态的三个成立条件、三种常见误配,以及一棵可运行的形态决策树与 TypeScript 实现。
检索文档里的一句话、工具返回的一段 JSON,都会在下一个节点变成「上文」。注入因此不是单节点问题,而是污点与信任级别在节点间如何传播的问题。本节把信任级别、污点集合与边界判定写成可运行模块,说明什么内容必须隔离、什么节点只能包成数据,并给出示例运行结果。
游客转正、账号迁移与账号合并是三件不同的事,混为一谈会让绑定关系、资产与风控同时失控。本节用《潮汐消消》每月 1,200 起与《潮汐方舟》每月 400 起账号合并申诉,拆开主账号选择、资产合并、风险信号与人工复核带,并给出可运行的合并计划与决策输出。