Android 注意事项

Android 端无需为插件本身进行额外的宿主应用配置。安装并同步后，插件会自动注册主 Capacitor WebView，注入 Contentsquare 事件桥接器，并开放文档中说明的 JavaScript APIs。

插件在 Android 上的作用

• 注册 Capacitor WebView 至原生 Contentsquare SDK。
• 暴露 optIn, optOut, sendScreenName, sendTransaction以及动态变量 API。
• 注入与 Replay 相关的命令，例如 URL 排除、PII 脱敏和捕获的元素选择器。

验证技巧

检查原生日志

在 Android Studio 中过滤 Logcat 使用：

CSLIB

应用启动时，你应该能看到 Contentsquare 原生的 SDK 启动消息，以及 WebView bridge 的注册信息。

追踪首次会话

import { ContentsquarePlugin } from '@capgo/capacitor-contentsquare';

await ContentsquarePlugin.optIn();
await ContentsquarePlugin.sendScreenName('Home');

如果没有至少一次 screenview，Contentsquare 将不会保留该会话。

动态变量限制

• Contentsquare 将 Key 限制为 512 个字符。
• Value 必须是字符串或非负整数。
• 如果你希望在每个会话中都包含某个值，请在应用返回前台时再次发送它。

继续阅读 Android 注意事项

如果你正在使用 Android 注意事项 要规划原生插件工作，请将其与 使用 @capgo/capacitor-contentsquare 用于“使用 @capgo/capacitor-contentsquare”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。