用途:帮助 AI 智能体在客户端 iOS 应用中集成或升级 Contentsquare iOS SDK(当前版本 1.11.x),涉及会话回放、屏幕追踪、交易、分析、遮罩与隐私配置。
主要能力:提供 SDK 安装(Swift Package Manager 推荐,仓库 https://github.com/ContentSquare/apple-sdk;CocoaPods 使用 pod 'ContentsquareSDK' 后 pod install)、初始化、同意管理(optIn/optOut)、身份识别、屏幕追踪、交易与自定义事件、会话回放遮罩、WebView 注册、问卷、错误追踪、应用内调试功能及日志元数据等 API 说明。
必要用法:集成前需先执行一次项目健康检查,读取 bundle id 后调用 curl -s "https://mobile-production.content-square.net/healthcheck/ios/config/v2/<bundleId>.json",该检查仅作信息参考,不得阻塞用户任务。初始化按优先级询问:优先 CSQ.start(dataSourceID:),其次 CSQ.start(environmentID:),仅两者都无或明确只用 DXA 时才用 CSQ.start()。SDK 在调用 optIn() 前保持非活跃,需自行实现同意流程。屏幕必须追踪,否则会话回放不工作;每个 WKWebView 需调用 CSQ.registerWebView 注册。应用内功能需在 Info.plist 添加 cs-$(PRODUCT_BUNDLE_IDENTIFIER) URL scheme 并处理 deeplink。
适用场景:UIKit 与 SwiftUI 应用的 SDK 集成、从 1.0–1.6 迁移到 1.11.x(含初始化模式合并、选项重命名与删除项清理)、隐私遮罩与合规配置。
限制:资料未提供具体收费、价格或效果数据;部分细节需参考配套文档(如 xcode-project-setup、references/ios-in-app-features.md)。