SuperAPI AI 工具集

contentsquare-react-native-sdk

前端与建站

查看项目

更新于 10-16 02:32

技能介绍

用途:在客户端 React Native 应用中集成或升级 Contentsquare SDK,涵盖会话回放(Session Replay)、屏幕跟踪、交易事件、数据分析、遮罩与隐私同意管理。

主要能力:提供生命周期控制(start、stop、pauseTracking、resumeTracking);三种启动配置 StartConfig.withDataSourceId、withEnvironmentId、dxa;隐私开关 optIn/optOut;身份 identify、resetIdentity、sendUserIdentifier;屏幕跟踪 trackScreenview;交易 trackTransaction;自定义事件与属性;Session Replay 的 startSessionReplay/stopSessionReplay 与 onMetadataChange 元数据;日志调试;全局与组件级遮罩 CSQMask、withCSQMask;以及与 React Navigation 和 WebView 的集成。

使用方式:安装依赖 @contentsquare/react-native-bridge ^6.0.1,然后运行 npm install 或 yarn install;iOS 需 cd ios && pod install && cd ..,Android 在 npm install 后无需额外设置。使用 CSQ 与 StartConfig 启动 SDK,屏幕必须被跟踪否则 Session Replay 无法工作;WebView 需用 CSQWebView 包裹。使用该技能时,若给出 data source ID 则走 v3 健康检查接口,仅有 environment ID 或没有 ID 则按 bundle id 走 v2;bundle id 分别从 android/app/build.gradle(.kts) 的 applicationId 与 ios 项目中的 PRODUCT_BUNDLE_IDENTIFIER 解析。

适用场景:需要接入 Contentsquare 移动端分析的 React Native 项目,尤其是需要会话回放、屏幕与交易跟踪、隐私遮罩与同意流程的场景。

限制:不得在无用户同意流程时调用 optIn();不要编造 data source ID;健康检查为信息性步骤,不得阻塞用户任务;allow* 属性只影响 Product Analytics 事件数据,只有 isSessionReplayMasked 影响 Session Replay 视觉遮罩;stopSessionReplay() 为终态,同一 SDK 生命周期内无法重启;其他细节暂未提供。