@amplitude/secment-session-replay-plugin- react-inative (原始内容存档于2018-07-29) (英语)
高度分会话重放插件
安装
npm install @amplitude/segment-session-replay-plugin-react-native
依赖关系
此插件需要安装以下依赖性 :
npm install @amplitude/session-replay-react-native @segment/analytics-react-native
重要: 此插件要求 @segment/analytics-react-native-plugin-amplitude-session 用于从 Amplition 集成数据提取会话ID 的插件 。 确定将此插件添加到您的分区客户端 在此之前 添加会话重放插件 .
使用量
段会话重放插件
将分会话重放插件添加到分会话分析实例中,以便自动将分会话重放与分会话事件相集.
import { createSegmentSessionReplayPlugin } from '@amplitude/segment-session-replay-plugin-react-native';
import { createClient } from '@segment/analytics-react-native';
import { AmplitudeSessionPlugin } from '@segment/analytics-react-native-plugin-amplitude-session';
// Initialize Segment client
const segmentClient = createClient({
writeKey: 'YOUR_SEGMENT_WRITE_KEY',
});
// Configure session replay plugin
const sessionReplayConfig = {
apiKey: 'YOUR_AMPLITUDE_API_KEY',
deviceId: 'YOUR_DEVICE_ID'
};
// Add the Amplitude session plugin first (required for session ID extraction)
await segmentClient.add({ plugin: new AmplitudeSessionPlugin() });
// Add the session replay plugin to Segment
await segmentClient.add(createSegmentSessionReplayPlugin(sessionReplayConfig));
插件配置
插件接受一个 SegmentSessionReplayPluginConfig 对象: 来自
SessionReplayConfig 联 合 国 @amplitude/session-replay-react-native,加上:
| 选项 | 默认 | 说明 |
|---|---|---|
autoStart | true | 一旦插件被添加到分块客户端中,立即开始录制. |
设定 autoStart: false ,然后调用 start() 从
@amplitude/session-replay-react-native 自己说:
import { start } from '@amplitude/session-replay-react-native';
await segmentClient.add(createSegmentSessionReplayPlugin({ ...sessionReplayConfig, autoStart: false }));
// later, once you're ready to record
await start();
自动集成
自动插件 :
- 初始化会话重放: 用您的配置设置高度会话重放
- 开始记录: 开始录制一次配置, 除非
autoStart实值false - 同步会话数据: 更新每段活动的会话ID和设备ID
- 管理生命周期: 处理会话重放的开始/停止操作
事件处理
对于每个事件,插件 :
- 从事件属性或高度集成数据提取会话 ID
- 从事件上下文或匿名身份提取设备 ID
- 将两者都转发到会话重放, 这样记录会被正确归属
事件通过未修改的传递;插件不会为它们添加属性.