用途:在 JS/TS 应用中接入 AnalyticsCLI 分析,埋点引导、付费墙、购买、问卷等事件,并在当前 @analyticscli/sdk 版本线内升级与验证。技能包版本 1.6.11,目标包 @analyticscli/sdk,支持范围 >=0.1.1 <0.2.0。
主要能力:提供初始化(init、initFromEnv、initBrowserFromEnv、initReactNativeFromEnv)、身份追踪(identify、setUser、clearUser)、屏幕与事件追踪、引导流程专用 API(createOnboardingTracker、trackOnboardingEvent、trackOnboardingSurveyResponse 及 step 辅助方法)、付费墙追踪器 createPaywallTracker,以及反馈提交 submitFeedback。
使用方式:在应用启动处仅初始化一次,推荐 init({ ... }) 并显式设置 identityTrackingMode: 'consent_gated';快速演示可用 init('<YOUR_APP_KEY>')。环境变量使用可公开的发布键名(如 ANALYTICSCLI_PUBLISHABLE_API_KEY),不要使用 WRITE_KEY 类名称。platform 仅用 web/ios/android/mac/windows 或省略,React Native/Expo 直接传 Platform.OS。付费墙每个稳定上下文复用一个 tracker,购买生命周期映射到 purchaseStarted 与唯一终态事件。引导步骤默认用 onboarding:step_view,问卷用 trackOnboardingSurveyResponse。
适用场景:Web、TypeScript、React Native、Expo 应用的分析接入与升级,付费墙/购买/引导漏斗埋点,与 analyticscli CLI 联合验证。
限制:identify/setUser 仅在完全追踪开启时生效;EU/EEA/UK 流量默认保持 consent_gated;不要传 endpoint 或添加 endpoint 环境变量;不要生成大型事件翻译层、重复屏幕追踪或旧事件别名;反馈需真实反馈端点与公开键,delivery: 'analytics_only' 不产生仪表盘反馈记录。错误恢复顺序为先重取技能并升级 SDK,再更新 CLI,重跑最小复现,仍失败则用 analyticscli feedback submit 提交脱敏反馈。具体仪表盘取值位置、价格与平台支持等资料未提供。