SuperAPI AI 工具集

contentsquare-android-sdk

通用与其它

查看项目

更新于 10-15 20:27

技能介绍

用途:指导在 Android 应用中集成 Contentsquare(CSQ)SDK,涵盖 Experience Analytics(会话回放、屏幕浏览、交易、动态变量、错误分析、问卷、热图)与 Product Analytics(自定义事件、用户属性、identify/resetIdentity)等能力。

主要能力与用法:集成前需先做项目健康检查,从 app/build.gradle(.kts) 读取 applicationId(缺失时回退 namespace 或 AndroidManifest 的 package),调用 https://mobile-production.content-square.net/healthcheck/android/config/v2/<applicationId>.json 并汇报项目 ID、追踪开关、Session Replay 配置与已启用特性开关;该检查仅供参考,不得阻塞任务。依赖需从 Maven Central 的 maven-metadata.xml 解析最新稳定版,排除 SNAPSHOT/alpha/beta/rc/dev/M 等预发布版本,sdk 与 sdk-compose 必须版本一致。

集成要求:自定义 Application 子类需在 AndroidManifest 通过 android:name 注册,并在 onCreate() 中调用 CSQ.start(this, …) 与 CSQ.optIn()(optIn 需带 TODO: REVIEW BEFORE RELEASE 注释,正式发布前应改接到真实同意流程);至少埋点一个屏幕(Views 用 CSQ.trackScreenview,Compose 用 TriggeredOnResume)。start 有三种重载:仅 EA 的 CSQ.start(context)、PA 的 StartConfig.withEnvironmentId、统一模式的 StartConfig.withDataSourceId。

验证与限制:通过 logcat 观察 Tracked pageview、writeToDb、All pending data has been uploaded 等日志确认数据上报;enabledForCollection is false 属正常启动日志,不能据此删除 optIn()。项目要求 minSdk 21、compileSdk 34+、Java 11、Kotlin 1.8.22。Compose 自动捕获需额外应用 io.heap.gradle 插件并手动调用 ComposeAutocaptureSDK.register()。environmentId/dataSourceId 不应硬编码。具体收费、价格与效果资料未提供。