flutter-product-analytics

Flutter 产品分析

埋点应记录决策，而不是组件。先明确产品问题和稳定的事件契约，然后保留项目现有的分析提供方、同意管理平台、状态管理、导航和数据架构，除非明确要求迁移。

不要仅因为选择了此技能就添加服务商、创建仪表板、启用数据收集，或更改线上数据保留和同意配置。

预检

阅读 pubspec.yaml、SDK 约束、现有分析适配器及其初始化方式、环境、同意和隐私控制、事件定义、身份生命周期、导航跟踪、离线缓冲、后端转换、测试、相关仪表板或架构，以及发布配置。添加事件前，先明确问题、决策、负责人、目标群体和成功标准。

每个事件都需要明确语义触发条件、稳定名称、范围受限且类型明确的属性、身份和同意策略、投递预期及验证计划。应在领域事件发生时发送一次，而不是同时通过组件 build、意外重建、路由观察器和按钮回调发送。

提出或修复事件时，应直接说明契约，而不是询问或推给适配器处理：附加的是哪种身份（匿名或已认证，以及登录或账户切换时如何处理）、关闭同意后是丢弃还是排队、投递语义（例如使用去重键实现至少一次投递），以及重试和进程重启的规则。若项目中没有说明，请选择保守的默认值，将其标注为假设，并指出谁可以更改。

按需加载参考资料

• 定义名称、属性、语义触发条件、漏斗、收入事件、架构演进或防止重复时，请阅读事件契约与负责人。
• 涉及匿名和已认证身份、账户切换、选择加入或退出、删除、敏感数据、广告归因和离线缓冲时，请阅读身份、同意与隐私。
• 涉及 DebugView 或实时调试工具、后端检查、环境、漏斗验证、实验曝光和发布证据时，请阅读验证与实验。

职责边界

• flutter-observability 负责运行错误、日志、跟踪、发布上下文和事件诊断。产品分析负责用户行为、漏斗、归因、转化和实验。
• flutter-in-app-purchases 负责已验证的交易和权益；分析可以观察其结果，但绝不能授予访问权限或定义购买事实。
• flutter-navigation 负责路由正确性；分析负责映射有意义的屏幕或旅程语义，不应将导航与服务商耦合。
• flutter-authentication 负责会话状态；分析应遵循明确的身份和账户生命周期。
• flutter-persistence 负责存储机制；此技能定义符合用户同意要求的有限缓冲和事件删除要求。
• flutter-security 负责广泛的隐私与威胁审查。

验证

以确定性方式测试与提供商无关的适配器和语义事件生成器。覆盖仅发送一次、属性验证、同意状态转换、匿名身份到已认证身份的转换、注销和账户切换、离线队列边界、重试导致的重复、环境隔离以及提供商故障。

使用获授权的非生产分析项目或调试界面，确认事件仅到达一次，且名称、属性、身份、时间戳、同意状态和环境均符合预期。如果任务涉及下游架构、漏斗或实验使用方，也要进行验证。SDK 调用成功或控制台日志不能作为端到端分析证据。

如果无法访问获授权的提供商或仪表板，请明确记录：由于未观察到，提供商数据接收以及每个下游仪表板、漏斗或实验边界均未验证。不要将这一证据缺口笼统归为“待处理”状态。

来源

• Flutter 的 Google Analytics 事件
• Google Analytics DebugView
• Apple 用户隐私与数据使用
• Google Play 用户数据政策