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.
ウェブ実験のターゲティング
ウェブ実験はページとオーディエンスの両方を対象としています。 Amplitudeは最初にページターゲティングを評価し、次にオーディエンスターゲティングを評価します。 どちらのターゲット設定方法も、ページが最初に読み込まれたときにブラウザでローカルに評価されます。
Web Experiments では Pages を使用して、実験バリアントをウェブサイト上のどこに適用するかを制御します。ページは、特定のURLと一致するターゲティング条件や実験をプレビューするためのビジュアルエディタURLなど、Web実験をいつ適用するかを定義します。
ターゲティング対象ユーザー
デフォルトでは、新しいWeb実験はすべてのユーザーを対象としています。オーディエンスターゲティングを使用すると、実験の対象となる特定のユーザーをターゲットにすることができます。 ターゲットオーディエンス以外のユーザーはデフォルトの体験を受け取るため、分析には含まれません。
いずれかのセグメントが一致した場合、Amplitudeはロールアウトとバリアント分布に基づいてそのユーザーをバリアントにバケット付けします。 セグメントが一致するためには、ユーザーが設定したすべての条件を満たしている必要があります。
ブラウザのプロパティ(ローカル)
ブラウザのプロパティはクライアント側で利用可能であり、ネットワークリクエストを必要としないため、Amplitudeは低レイテンシーでプロパティを評価します。
| パラメータ | 概要 |
|---|---|
| 新規ユーザー | 指定された日付以降にAmplitudeが最初に認識する新しいユーザー。 Web実験SDKが初めてユーザーを認識したとき、SDKは日付をローカルストレージに保存し、日付を更新しません。この規則は、すべてのユーザーが新規ユーザーである場合、スクリプトの初期インストール直後に意図したとおりに機能しない場合があります。新規ユーザールールは、チャートやコホートでの新規ユーザークエリとは異なります。 |
| 再利用ユーザー | Amplitudeが特定の日付より前に最初に確認したリピートユーザー。 新規ユーザーの場合と同様のローカルな考慮事項が適用されます。 |
| 参照元URL | 特定のリファラーからサイトに到達したユーザーをマッチングします。 詳細については、MDN の document.referrer を参照してください。 |
| ランディングページURL | SDKは、SDKのロード時にランディングページのURLをセッションストレージに設定します。 |
| URLクエリパラメータ(永続化されません) | 評価時点でのページ上の現在のクエリパラメータ。 このルールは、UTMパラメータのターゲット設定に使用してください。 |
| URL クエリ パラメータ (永続的) | ナビゲーションやリロードの間でもバリアントの割り当てを維持するためにAmplitudeがローカルに保存するクエリパラメータ。 このルールは、最初のページ訪問以降も一貫したUTMベースのターゲティングが必要な場合に使用します。 |
| デバイスカテゴリ | デバイスタイプ別にユーザーをターゲットにします。Desktop、Mobile、またはTablet。 |
| ユーザーエージェント | ユーザーエージェントに基づくターゲット。ボットをターゲットに設定するのに役立ちます。 たとえば、ユーザーエージェントに Googlebot が含まれているすべてのユーザーを除外します。 |
| クッキー | 評価時のウィンドウに表示されたクッキー。 |
| 言語 | ユーザーのブラウザで使用されている言語です。 |
| ブラウザ | ユーザーのブラウザ: Safari、Chrome、Firefox、Edge、Opera。 |
| フリーフォームのプロパティ | IntegrationPluginが設定するカスタム ユーザープロパティ。 |
リアルタイムの行動ターゲティング(ローカル)
リアルタイムの行動ターゲティングは早期アクセス中です。 動作とAPIは一般提供前に変更される可能性があります。
リアルタイムの行動ターゲティングを使用すると、現在および以前のセッション中にユーザーが実行したアクションに基づいてユーザーをターゲットにすることができます。 Amplitudeは、ユーザーがAmplitudeイベントを実行する際に、ネットワークリクエストなしでこれらの条件をリアルタイムで評価します。
ユーザーが資格を得るタイミング:ある行動条件が満たされた瞬間(たとえば、5回目の記事閲覧後)、ユーザーは資格を得て、Amplitudeはユーザーを実験に振り分けます。
仕組み:Web Experiment SDKは、ブラウザで発生したAmplitudeイベントを監視し、行動シグナルをlocalStorageに保存し、ターゲット設定条件をリアルタイムで評価します。
SDKは、イベントがターゲティング条件に現れ、かつ実験がオンになっている場合にのみ、リアルタイムの行動ターゲティング用にイベントを保持します。実験を開始する前に過去の振り返りは行われないため、有効な評価期間は、設定した時間枠または実験が実行されている時間のいずれか短い方です。
サイトが Cookie の同意に関するスクリプトをゲートしている場合、訪問者が同意を与えるまで行動信号はメモリに残ります。クッキーと同意管理を参照してください。
統合されたスクリプトタグを使用して分析と Web 実験を一緒にロードしていない場合は、window.amplitude.add(window.webExperiment.plugin()) を呼び出して、Web 実験クライアントが追跡イベント通知を受信できるようにしてください。
サポートされる条件
リアルタイムの行動ターゲティングは、イベントベースの条件をサポートします:
- イベント数: イベントを特定の回数実行したユーザーを対象とします。
- 時間枠: 現在のセッション期間内または特定の期間 (過去 X 時間または日数) にわたる動作を評価します。
- プロパティフィルタリング: 複数のプロパティ条件を AND ロジックで組み合わせます (例: "where
category = 'electronics'ANDitem_value > 200")。 - クロスページトラッキング: 行動シグナルはページナビゲーションやブラウザセッション全体にわたって持続します。
ターゲット設定ルールの例
| ユースケース | ターゲット設定ルール |
|---|---|
| エンゲージメントの高い読者 | ユーザーはこのセッションで page_view 5 回数以上実行しました。 |
| 記事読者 | ユーザーは、このセッションで page_type = 'article' が 5 回数以上となる page_view を実行しました。 |
| 頻繁な訪問者 | ユーザーが過去 30 日間に page_view を 10 回以上実行しました。 |
| 高級電子機器を購入するユーザー | ユーザーadd_to_cartがcategory = 'electronics'実行し、かつこのセッションで item_value > 2001 回数以上実行しました。 |
リアルタイム行動ターゲティングとコホート
| 機能 | リアルタイムの行動ターゲティング | コホートターゲティング |
|---|---|---|
| 稼働場所 | クライアント側(ブラウザ) | Amplitudeサーバー |
| ユーザーが資格を得た時点 | イベントが発生するとすぐに、 | コホートのタイプ(同期、コホートターゲティング)に応じて約1分または1時間。 |
| ネットワーク要求が必要です | いいえ | はい |
| セッション中の動作をターゲットに設定可能 | はい | いいえ |
| 時間枠 | 短い。現在のセッション、または過去X時間または日間のローリングウィンドウをサポートします。 | もっと長く 特定の間隔とローリングウィンドウをサポートします。最大12か月間。 |
| 最適な用途 | セッション中の意図信号(カートへの追加数、ページビュー数、エンゲージメントの深さ) | 履歴動作、複雑なクエリ、長いルックバック・ウィンドウ |
リアルタイムの行動ターゲティングを使用するのは、次のような場合です:
- ユーザーが数日または数週間前に行った行動だけでなく、このセッションで行った行動にも反応します。たとえば、このセッションで誰かがプロダクトページを3つ表示した後に割引を表示するとします。
- コホートに同期されていないが現在のセッション期間中に意図を示している匿名ユーザーなど、コホートにまだ存在しない行動をターゲットにします。
- 実験は、カート放棄、ページビューの繰り返し、スクロール深度など、意図の高い瞬間に関連付けられて実行されます。これらの場合、ターゲット設定条件と実験は同じセッションで解決する必要があります。
- コホートの更新やリモートのメンバーシップチェックを待つことなく、ユーザーがしきい値を超えた瞬間に資格情報が更新される必要があります。
代わりにコホートを使用するのは、次の場合です。
- 過去90日間に3回以上購入したユーザーや、厳選された解約リスクのあるコホートのユーザーなど、安定した属性や長期的な行動パターンをターゲットにします。
- 実験が開始される前の行動をターゲットにします。 リアルタイム行動ターゲティングは、実験を開始した後にのみイベントを保持します。
- 数週間を超える履歴データに対して、複雑なサーバー側クエリを実行する必要があります。
ユーザープロパティ(リモート)
Amplitude ID の解決、IP のジオロケーション、プロパティの正規化、行動コホート、履歴ユーザープロパティに基づいて高度なターゲティングを実行できます。 ユーザープロパティをターゲットに設定すると、Amplitudeがネットワークリクエストを行う必要があるため、ページ表示の待ち時間が長くなる可能性があります。
| パラメータ | 概要 |
|---|---|
| エンリッチメントされたユーザープロパティ | ユーザーエンリッチメントによって解決されるプロパティ。 |
| Amplitudeユーザープロパティ | Amplitudeアナリティクスのユーザー履歴データ。 |
| 実験ユーザープロパティ | 他の実験でユーザーに割り当てられたバリアント。 |
| ユーザーコホート | Amplitudeで定義したユーザーのセットです。 |
ページ表示の遅延
アクティブなウェブ実験がページをターゲットにしている場合、少なくとも 1 つの実験がそのページをターゲットにしていて「アンチフリッカー」がオンになっている場合、Amplitude はアンチフリッカーオーバーレイを挿入します。 オーバーレイは、ページの読み込み時にページを覆う空白要素です。 Amplitude は、リモートプロパティを評価した後、または 1 秒間のタイムアウト後にオーバーレイを削除します。
バケッティング
バケット設定とは、ロールアウトと配布に基づいてユーザーに表示されるバリアントを指します。 ロールアウトは、実験に参加するユーザーの割合です。 分布は、ユーザーがロールアウトに参加している場合にユーザーが経験するバリアントを定義します。 Web 実験はデフォルトでバリアントを均等に配布します。Amplitudeはこの配布を推奨しています。
バケット設定は、ユーザーが同じIDを持っている場合に一貫性を保ちます。ほとんどの実験はデバイスIDごとにバケットに分類されるため、Web実験はユーザーが新しいデバイスやブラウザでアクセスしたり、プライベートブラウジングを使用したりした場合に、ユーザーを別のバケットに配置する場合があります。
ロールアウトを増やしても、すでにロールアウトに参加しているユーザーは再バケットに入ることはありません。 たとえば、実験がユーザーの10%にロールアウトされ、そのロールアウトを50%に増やした場合、元の10%のユーザーはバリアントを変更しません。均等分布を 20% -> control, 80% -> treatment に変更すると、コントロール内で開始したユーザーは処理にジャンプします。
クロスサブドメイン ID
2026 年 7 月 13 日以降に作成された実験では、クロスサブドメイン ID を持つユーザーをバケットに収容するため、ユーザーは同じドメインのサブドメイン間で同じバリアントを保持しますwww.example.com。shop.example.comAmplitudeは実験作成時にこれを修正します。実験を編集したり再開したりしてもこの設定は変わりません。
相互排除、ホールドアウト グループ、および依存関係
Web実験の相互排除グループ、ホールドアウトグループ、フラグ依存関係は早期アクセスです。動作とAPIは一般提供前に変更される可能性があります。
ウェブ実験は、相互排除グループ、ホールドアウトグループ、およびフラグ依存関係をサポートしています。
- 相互排除: 実験を相互排他グループに追加することで、ユーザーが別の実験と並んでその実験を確認できないようにすることができます。相互排除グループには、ウェブ実験と機能実験を組み合わせて含めることができます。
- ホールドアウトグループ: ホールドアウトグループに実験を追加して、ユーザーの割合を保留することによる長期的な影響を測定します。 ホールドアウトグループには、ウェブ実験と機能実験を組み合わせて含めることができます。
- フラグ依存関係: フラグ依存関係を使用すると、ある実験を別の実験の結果に基づいてゲートできます。たとえば、ユーザーが実験 A のトリートメントバリアントに属している場合にのみ実験 B を評価できます。ウェブ実験はフラグ依存関係をサポートしていますが、ウェブ実験は他のウェブ実験にのみ依存できます。機能フラグや機能実験には依存しません。
これは役に立ちましたか?