Rudderstack用のセッションリプレイラッパー

Amplitudeでは、RudderstackとAmplitudeのセッションリプレイを連携させるためのラッパーを提供しています。

ラッパーをインストールする

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

npm install @amplitude/session-replay-browser --save

Rudderstackを使用したセッションリプレイの初期化

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

import * as sessionReplay from "@amplitude/session-replay-browser";
amplitude.init(AMPLITUDE_API_KEY, user_id, config).promise.then(() => {
  window.rudderAnalytics.ready(function () {
    const rudderAnonymousId = rudderAnalytics.getAnonymousId();
    sessionReplay.init(AMPLITUDE_API_KEY, {
      deviceId: rudderAnonymousId,
      sessionId: rudderAnalytics.getSessionId(),
      sampleRate: 0.1, // 10% of sessions will be captured
    }).promise;
    sessionReplay.set(rudderAnalytics.getSessionId());
  });
});

AmplitudeがリプレイをRudderstackイベントにリンクする方法

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

必須フィールドのマッピング

Amplitudeは、Rudderstack Anonymous IDをAmplitude Device IDに、Rudderstack Session IDをAmplitude Session IDにマッピングします。 デバイスIDに別のフィールドを使用する場合は、Amplitude サポートまでお問い合わせください。

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

トラブルシューティング

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