ターゲットを絞ったリプレイキャプチャ

ターゲットリプレイキャプチャ (TRC) は、すべてのセッションをキャプチャしたり、ランダムサンプリングに依存したりするのではなく、イベント、イベントプロパティ、ユーザープロパティ、ページ URL など、定義した基準に一致するセッションにセッションリプレイクォータを集中させます。特定の行動や価値の高いセグメントを観察する必要がある場合は TRC を使用します。幅広いセッションカバレッジのみが必要な場合は、代わりにグローバルサンプルレートを調整してください。

TRCを設定するには、プロジェクトのセッションリプレイ設定にあるサンプリングコントロールに条件を追加します。各条件は、イベント、イベントプロパティ、ユーザープロパティ、またはページ URL と一致することができ、条件を OR ロジックと組み合わせることができます。セッションリプレイ SDK は、リモート設定サービスからターゲット設定を取得し、実行時にそれらを評価して、セッションをキャプチャするかどうかを決定します。

主な機能

TRCは、Amplitudeがセッションをキャプチャするかどうかを決定するために使用する基準を定義し、セッションリプレイ割り当て量をより効率的に管理するのに役立ちます。

カスタムキャプチャ基準

以下に基づいてリプレイをキャプチャするルールを定義します。

特定のイベント：たとえば、Checkout Startedなど。
イベントプロパティ：たとえば、plan = Proなど。
ユーザープロパティ：たとえば、country = USなど。
ページURL：たとえば、/checkoutのセッション、またはパターンに一致する任意のURLのセッションのみをキャプチャします。
組み合わせ：これらの基準をORロジックと組み合わせます。

構成とクォータ管理

TRCをセッションリプレイ設定ページから管理するには、サンプリングコントロールに条件を追加します。各プロジェクトのターゲット設定条件を追加、編集、削除できます。 UIは、履歴トラフィックに基づいて、各条件で使用されるクォータを推定します。Amplitudeがどのセッションをキャプチャするか、および各条件が使用するクォータ量を制御するために、さまざまな条件に対して異なるサンプルレートを設定できます。

ユースケース

エラーが発生したり、重要なポイントで脱落したりしたユーザーのみを対象にリプレイをキャプチャします。
価値の高いユーザーセグメントや重要なプロダクトフローに重点を置く。
チェックアウトやオンボーディングなど、特定のページやフローに関するセッションをキャプチャします。
不要なリプレイキャプチャを回避することで、ノイズとコストを削減できます。

ターゲットリプレイキャプチャの設定

TRCを使用するには、Session Replay Browser SDKプラグインのバージョン@amplitude/plugin-session-replay-browser@1.22.0以上と、セッションリプレイ設定を管理するための権限が必要です。URLの照合には、プラグインバージョン1.26.2以上またはスタンドアロンSDK @amplitude/session-replay-browser@1.32.2以上が必要です。プラグインをインストールしていない場合は、まずインストールしてください。

プロジェクトごとにTRCを設定します:

[設定]> [組織設定]> [セッションリプレイ設定] に移動します。詳細については、セッションリプレイ設定ページを参照してください。
設定したいプロジェクトを選択します。
*「サンプリング」*セクションで、**「条件を追加」**を選択して、新しいターゲット設定条件を作成します。
条件に対するターゲット設定基準を定義します。

複数の条件を追加し、それらを OR ロジックと組み合わせます。各条件には以下が含まれます：

イベントタイプ。
イベントプロパティ。
ユーザープロパティ。
ページのURL。

イベントベースおよびプロパティベースのターゲティング条件が機能するためには、セッション中にイベント、イベントプロパティ、ユーザープロパティをキャプチャしてAmplitudeに送信する必要があります。ページ URL 条件はユーザーの現在の URL を直接評価するため、一致するイベントは必要ありません。

ページURLターゲティング

ページ URL ターゲティングは、ユーザーが特定のページまたは URL パターンにアクセスした場合にのみ、リプレイをキャプチャします。この機能は、Webセッションリプレイ用のベータ版です。

ページ URL ターゲティングには、次のいずれかの SDK バージョンが必要です。

プラグイン：@amplitude/plugin-session-replay-browser@1.26.2またはそれ以上。
スタンドアロンSDK：@amplitude/session-replay-browser@1.32.2またはそれ以上。

ページURL条件を追加するには：

*「サンプリング」*セクションで、**「条件を追加」**を選択し、条件エディタを開きます。
ページ URL 条件を追加します。
演算子を選択し、URLまたはパターンを入力します。
条件のサンプルレートを設定して保存します。

サポートされている演算子：

演算子	一致するタイミング
is	現在のページの URL は入力した値と正確に一致しています。
is not	現在のページの URL は入力した値と正確に一致しません。
contains	現在のページの URL には、入力したテキストが含まれています。
does not contain	現在のページの URL には、入力したテキストが含まれていません。
glob match	現在のページの URL が glob パターンと一致しています。たとえば、`https://example.com/checkout/*` は任意のチェックアウトサブパスと一致します。

ページ URL ターゲティングを使用すると、すべてのセッションをキャプチャすることなく、チェックアウト、オンボーディング、アカウント設定などの価値の高いフローにリプレイキャプチャを集中できます。

ページURLターゲティングの評価方法

セッションリプレイSDKは、ユーザーの現在のブラウザURLと照らしてページURLの条件を評価します。単一ページのアプリケーションでは、URL が変更された場合に SDK はターゲティングを再評価します。セッションがターゲット設定条件を満たすと、キャプチャはセッションの残りの期間中継続されます。

ページ URL の条件の場合、ユーザーの URL が条件と一致するとリプレイキャプチャが開始されます。リプレイには、URL が一致する前のアクティビティは含まれません。

SDK サポート

TRCを使用するには、Amplitude Browser 分析 SDKとセッションリプレイ Browser SDKプラグインバージョン@amplitude/plugin-session-replay-browser@1.22.0以上が必要です。Amplitude BrowserアナリティクスSDKとセッションリプレイプラグインの両方をセットアップに統合して、TRCを使用してください。

URLマッチングをサポートするには、次のいずれかの要件が必要です。

プラグイン：@amplitude/plugin-session-replay-browser@1.26.2またはそれ以上。
スタンドアロンSDK：@amplitude/session-replay-browser@1.32.2またはそれ以上。

スタンドアロンSDKの制限

スタンドアロンSDKはページURLターゲティングのみをサポートしています。イベントベース、プロパティベース、ユーザーベースの TRC 条件には、セッションリプレイ Browser SDK プラグインと Amplitude Browser 分析 SDK が必要です。

評価のタイミング

SDK はセッション開始時にターゲット設定を取得します。イベントベース、プロパティベース、およびユーザーベースの条件の場合、SDK はセッション全体でその設定を使用します。一致するイベントがセッションの後半で発生した場合、SDKはそのイベントをセッション開始時にアクティブだった設定と照合して評価します。ターゲット設定ルールの更新は、新しいセッションにのみ適用されます。

ページ URL の条件についても、SDK は単一ページのアプリのナビゲーション中など、セッション中に URL が変更された場合にも再評価します。

キャプチャのタイミング

セッションリプレイのキャプチャは、ターゲット設定条件がトリガーされた後にのみ開始されます。TRC には「振り返り」期間はありません。リプレイでは、条件がトリガーされる前のアクティビティはキャプチャされません。イベントベースの条件の場合、一致するイベントが発生したときにキャプチャが開始されます。ページ URL 条件の場合、ユーザーの URL が一致するとキャプチャが開始されます。

これは役に立ちましたか？