ターゲットを絞ったセッションのキャプチャ
ターゲット リプレイ キャプチャ (TRC) は、すべてのセッションをキャプチャしたり、ランダム サンプリングに依存したりするのではなく、イベント、イベントプロパティ、ユーザープロパティ、ページ URL など、定義した基準に一致するセッションにセッションリプレイ クォータを集中させます。特定の行動や値の高いセグメントを観察する必要がある場合はTRCを使用します。幅広いセッションカバレッジのみが必要な場合は、代わりにグローバルサンプルレートを設定してください。
TRCを設定するには、プロジェクトのセッションリプレイ設定にある_サンプリング_コントロールに条件を追加します。各条件は、イベント、イベント プロパティ、ユーザー プロパティ、またはページ URL と一致することができ、条件を OR ロジックと組み合わせることができます。 セッションリプレイ SDK は、リモート設定サービスからターゲット設定を取得し、実行時にそれらを評価して、セッションをキャプチャするかどうかを決定します。
主な機能
TRCは、Amplitudeがセッションをキャプチャするかどうかを決定するために使用する基準を定義し、セッションリプレイ割り当て量をより効率的に管理するのに役立ちます。
カスタムキャプチャ基準
以下に基づいてリプレイをキャプチャするルールを定義します。
- 特定のイベント:たとえば、
Checkout Startedなど。 - イベントプロパティ:たとえば、
plan = Proなど。 - ユーザープロパティ:たとえば、
country = USなど。 - ページURL:たとえば、
/checkoutのセッション、またはパターンに一致する任意のURLのセッションのみをキャプチャします。 - 組み合わせ:これらの基準を
ORロジックと組み合わせます。
構成とクォータ管理
TRCをセッションリプレイ設定ページから管理するには、_サンプリング_コントロールに条件を追加します。各プロジェクトのターゲット設定条件を追加、編集、削除できます。 UIは、履歴トラフィックに基づいて、各条件で使用されるクォータを推定します。Amplitudeがどのセッションをキャプチャするか、および各条件が使用するクォータ量を制御するために、さまざまな条件に対して異なるサンプルレートを設定できます。
ユースケース
- エラーが発生したり、重要なポイントで脱落したりしたユーザーのみを対象にリプレイをキャプチャします。
- 価値の高いユーザーセグメントや重要なプロダクトフローに重点を置く。
- チェックアウトやオンボーディングなど、特定のページやフローに関するセッションをキャプチャします。
- 不要なリプレイキャプチャを回避することで、ノイズとコストを削減できます。
ターゲット リプレイ キャプチャの設定
セッションリプレイの設定を管理するための権限と、条件タイプをサポートするSDKが必要です。 条件を設定する前に、SDKサポートマトリクスを確認してください。
TRCの条件は、セッションリプレイ設定UIでデフォルトのサンプルレートを設定するまで有効になりません。デフォルトのサンプルレートを設定するまで、セッションリプレイはSDKで設定されたサンプルレートと設定を使用します。
プロジェクトごとにTRCを設定します:
- [設定]> [組織設定]> [セッションリプレイ設定] に移動します。詳細については、セッションリプレイ設定ページを参照してください。
- 設定したいプロジェクトを選択します。
- _「サンプリング」_セクションで、**「条件を追加」**を選択して、新しいターゲット設定条件を作成します。
- 条件に対するターゲット設定基準を定義します。
複数の条件を追加し、それらを OR ロジックと組み合わせます。 各条件には以下が含まれます:
- イベントタイプ。
- イベントプロパティ。
- ユーザープロパティ。
- ページのURL(ウェブのみ)。
イベントベースおよびプロパティベースのターゲティング条件が機能するためには、セッション中にイベント、イベントプロパティ、ユーザープロパティをキャプチャしてAmplitudeに送信する必要があります。 ページ URL 条件はユーザーの現在の URL を直接評価するため、一致するイベントは必要ありません。
ページURLターゲティング
ページ URL ターゲティングは、ユーザーが特定のページまたは URL パターンにアクセスした場合にのみ、リプレイをキャプチャします。 この機能は、Webセッションリプレイ用のベータ版です。
最小プラグインバージョンおよびスタンドアロンバージョンのSDKサポート状況を確認してください。
ページURL条件を追加するには:
- _「サンプリング」_セクションで、**「条件を追加」**を選択し、条件エディタを開きます。
- ページ URL 条件を追加します。
- 演算子を選択し、URLまたはパターンを入力します。
- 条件のサンプルレートを設定して保存します。
サポートされている演算子:
| 演算子 | 一致するタイミング |
|---|---|
| is | 現在のページの URL は入力した値と正確に一致しています。 |
| is not | 現在のページの URL は入力した値と正確に一致しません。 |
| contains | 現在のページの URL には、入力したテキストが含まれています。 |
| does not contain | 現在のページの URL には、入力したテキストが含まれていません。 |
| glob match | 現在のページの URL が glob パターンと一致しています。 たとえば、https://example.com/checkout/* は任意のチェックアウト サブパスと一致します。 |
ページ URL ターゲティングを使用すると、すべてのセッションをキャプチャすることなく、チェックアウト、オンボーディング、アカウント設定などの価値の高いフローにリプレイキャプチャを集中できます。
ページURLターゲティングの評価方法
URLの評価とキャプチャ開始の動作については、「評価のタイミング」を参照してください。
SDK サポート
TRCは、ウェブおよびiOSのセッションリプレイSDKと連携します。Androidのサポートは近日公開予定です。
ウェブ
| 条件タイプ | ブラウザプラグイン | ブラウザスタンドアロンSDK |
|---|---|---|
| イベント、イベントプロパティ、ユーザープロパティ | @amplitude/plugin-session-replay-browser@1.22.0 またはそれ以上、Amplitude Browser 分析 SDKを使用 | サポートされていない |
| ページのURL。 | @amplitude/plugin-session-replay-browser@1.26.2またはそれ以上 | @amplitude/session-replay-browser@1.32.2またはそれ以上 |
イベントベースとプロパティベースのターゲティングには、セッションリプレイ Browser SDKプラグインとAmplitude ブラウザアナリティクス SDKが必要です。スタンドアロンSDKはページURLターゲティングのみをサポートしています。
iOS
| 条件タイプ | iOSプラグイン | iOSスタンドアロンSDK |
|---|---|---|
| イベント、イベントプロパティ、ユーザープロパティ | AmplitudeSessionReplay 0.15.0以上、iOS Swift SDKを使用した | AmplitudeSessionReplay 0.15.0以上。アプリはイベントとユーザープロパティを渡します。 |
| ページのURL。 | 該当なし | 該当なし |
セッションリプレイ iOSプラグインは、追加のコードなしで、各イベントとユーザーのプロパティに対して条件を評価します。スタンドアロンSDKを使用すると、アプリは各イベントとユーザーのプロパティをセッションリプレイに渡します。
Segmentプラグイン、セッションリプレイiOSミドルウェア、Flutter、React Nativeは、まだTRC条件を評価していません。プロジェクトにターゲティング条件がある場合、セッションリプレイはプロジェクトのサンプルレートでのみこれらの統合からセッションをキャプチャします。
評価のタイミング
ウェブでは、SDKはセッション開始時にターゲット設定を取得します。 イベント、プロパティ、およびユーザーベースの各条件では、一致するイベントが後で発生した場合も含めて、セッション全体でその設定を使用します。ターゲット設定ルールの更新は、新しいセッションにのみ適用されます。
SDKはページURLの条件を現在のブラウザURLと照合して評価し、単一ページのアプリのナビゲーションなど、URLが変更された場合に再評価します。 セッションがターゲット設定条件を満たすと、キャプチャはセッションの残りの期間中継続されます。
iOSでは、SDKは初期化時と新しいセッション開始時にターゲティング設定を取得します。 設定が到着した時点、セッションの開始時点、各イベント発生時、およびユーザーのプロパティが変更された時点で条件を評価します。設定の更新は、キャプチャが開始されていないセッションに適用されるため、変更は通常、次のセッションから有効になります。 iOSプラグインを使用すると、ユーザープロパティの条件は、現在のアプリの起動期間中にアプリが設定したプロパティidentifyを使用します。アプリが再起動した後、アプリがユーザーを識別すると、セッションリプレイは再びそれらを使用します。
キャプチャのタイミング
キャプチャは、ターゲティング条件がトリガーされたときに開始されます。イベントベースの条件の場合、一致するイベントが発生したときにキャプチャが開始されます。 ページURL条件の場合、URLが一致するとキャプチャが開始されます。 TRCにはルックバック期間はありません。リプレイには条件がトリガーされる前のアクティビティが含まれません。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.