セグメント用セッションリプレイプラグイン

Amplitudeは、セグメントとAmplitudeのセッションリプレイを1行で連携できるようにするプラグインを提供しています。

プラグインをインストールする

npmまたはYarnを使用してパッケージをインストールしてください。パッケージにはAmplitude Session Replay SDKが含まれています。

npm install @amplitude/segment-session-replay-plugin --save

用途

sessionReplayOptionsの詳細については、Session Replay Standalone SDKの設定セクションを参照してください。

import { AnalyticsBrowser } from "@segment/analytics-next";
import { createSegmentActionsPlugin } from "@amplitude/segment-session-replay-plugin";
export const segmentAnalytics = AnalyticsBrowser.load({
  writeKey: SEGMENT_API_KEY,
});
const segmentActionsPlugin = createSegmentActionsPlugin({
  segmentInstance: segmentAnalytics,
  amplitudeApiKey: AMPLITUDE_API_KEY,
  sessionReplayOptions: {
    logLevel: 4,
    sampleRate: 1,
    debugMode: true,
  },
});
segmentAnalytics.register(segmentActionsPlugin);

セグメントプラグインアーキテクチャ

Amplitudeは、セッションリプレイがセッションをキャプチャするときに[Amplitude] Replay Capturedイベントを自動的に作成します。プラグインはこのイベントを直接Amplitudeに送信し、リプレイとアナリティクスデータをリンクします。 このイベントがAmplitudeに表示されない場合は、Amplitudeサポートにお問い合わせください。

ユーザーIDとデバイスIDのマッピング

Segmentのドキュメントに従って、このプラグインはSegmentユーザーIDをAmplitudeデバイスIDにマッピングします。リプレイキャプチャ用のデバイスIDを見つけるために、プラグインはuserIdが設定されているかどうかを確認し、設定されていない場合はanonymousIdを使用します。

セッションリプレイIDは<deviceId>/<sessionId>という形式を使用します。セッションリプレイは区切り文字として/を使用するため、値に/を含めることはできません。使用できる文字：a-z A-Z 0-9 _ - . | @ : =。セグメントのuserIdとanonymousIdの値はUUIDであり、常にこれらの要件に準拠しています。追加のキャラクターが必要な場合は、Amplitudeサポートまでお問い合わせください。

トラブルシューティング

トラブルシューティング情報については、「セッションリプレイ Standalone SDK | トラブルシューティング」を参照してください。