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.
ウェブ実験ページ
Web 実験では、「ページ」でバリアントを特定の URL に限定できるため、サイトの関連性のない部分に影響を与えることなく、ターゲットとするページでテストを実行できます。
ページは、ウェブ実験があなたのサイトに適用される条件を定義します。これには以下のものが含まれます:
- ユニークな名前
- URLターゲティング条件。
- ページトリガー
- 実験のプレビューに役立つビジュアルエディタの URL です。
ページを作成する
新しいWeb実験を作成する際は、以下の方法でページを指定してください。
- 手動URL入力: ページを定義するために特定のURLを入力します。
- 保存済みページをインポートする: 前の実験のページを選択します。
ページを追加したら、実験の設定を続行するか、ビジュアルエディタに直接移動してください。
ページを更新するか、別のページを作成する
任意の Web 実験用に別のページを更新または作成できます。
- _「実験」_に移動し、希望する Web 実験を選択します。
- Web 実験の 設定 > ページ に移動します。
- ページ名の変更、ビジュアルエディタURLの更新、ページトリガーの設定、ページターゲット設定ルールの更新を行います。
- ページを選択して、別のページを追加します:
- カスタムを選択して、2 番目のページのページ詳細情報を開きます。
- ページに名前を付け、ビジュアルエディタの URL、トリガタイプ、トリガルールを入力します。
- 変更を保存 を選択します。
ページターゲティングルール
- 一致する URL
- 説明:ページの URL を照合し、クエリパラメータやハッシュフラグメントを無視します。
- 例:
https://example.com/pricing- ✅ https://example.com/pricing#details
- ❌https://example.com/pricing/enterprise
- URL が完全に一致する
- 説明: ページ全体の URL と正確に一致します。
- 例:
https://example.com/pricing?utm_source=facebook- ❌https://example.com/pricing
- ❌ https://example.com/pricing?utm_source=tiktok
- URL がパターンに一致する
- 説明: ワイルドカード (
*) を含むページ全体の URL を照合します。 - 例:
https://example.com/blog/*- ✅ https://example.com/blog/my-first-post
- ✅ https://example.com/blog/my-second-post#get-started
- 説明: ワイルドカード (
- URLに含まれるもの
- 説明:ページ全体の URL と一致します。URL には特定のサブストリングが含まれています。
- 例:
/blog/my-first- ✅ https://example.com/blog/my-first-post
- ❌ https://example.com/blog/my-second-post
- URL の先頭文字は
- 説明: URL が正確なサブストリングで始まるページ全体の URL と一致します。
- 例:
https://example.com/blog- ✅ https://example.com/blog/my-first-post
- ❌ https://example.com/pricing
- URL の末尾は
- 説明: ページ全体の URL と一致させます。URL の末尾は正確なサブストリングです。
- 例:
/blog/my-first-post- ✅ https://example.com/blog/my-first-post
- ❌ https://example.com/blog/my-first-post#get-started
- URL が正規表現に一致する
- 説明: ページ全体の URL を定義した正規表現と照合します。
- 例:
ページトリガー
この機能は早期アクセス段階であり、今後も進化していく可能性があります。 このドキュメントには最新の更新情報が反映されていない場合があります。
ページトリガーは、実験がページの条件を評価して、ウェブページ上で実験が有効になるかどうかを判断するタイミングを定義します。 ページターゲティングルールは実験がどこで行われるかを決定し、ページトリガーはバリアントアクションがいつ適用されるかを決定します。
新しい実験を作成する場合、デフォルトのトリガータイプは「即時」です。 即時トリガーは、URL が変更されるたびにページの状態を評価します。これには初期ページの読み込みも含まれます。 ユーザーの行動、ページイベント、またはカスタム条件に基づいて実験を開始するために他のトリガータイプを設定します。
トリガーの種類
- 今すぐ
- 説明: URL またはルートが変更された場合に評価します。
- パラメータ: なし
- イベントの追跡時
- 説明:
- 特定のAmplitudeアナリティクスイベントが発生したタイミングを評価します。
- 統合されたスクリプトタグを使用して分析と Web 実験を一緒にロードしていない場合は、Web 実験クライアントが追跡イベント通知を受信できるように
window.amplitude.add(window.webExperiment.plugin())を呼び出してください。
- パラメータ
- イベント名
- 特定のイベントプロパティ値と一致させるためのオプションのプロパティフィルタ。
- 制限事項: プロパティフィルタは、SDK がイベントを追跡した時点で生のイベントペイロードに存在するプロパティにのみ一致します。 Amplitudeがサーバー側で計算または強化するプロパティは、クライアント側のイベントオブジェクトでは使用できません。また、フィルター条件を満たすことはできません。 これには、派生プロパティ、検索プロパティ、配列拡張プロパティなどが含まれます (例:
products.label)。 トラッキングメソッドを呼び出す際に、インストルメンテーションが明示的に設定したプロパティのみを使用してください。
- 説明:
- 要素が表示されるとき
- 説明: CSSセレクターに一致する要素がDOM内に現れた場合に評価されます。
- パラメータ: 要素のCSSセレクターです。
- 要素が表示されるとき
- 説明: 要素がビューポートで表示されるようになった時点を評価します。
- パラメータ
- 要素の CSS セレクター。
- 要素のどの程度を表示する必要があるかを定義する、オプションの可視化比率 (0 ~ 100) です。
- ページ滞在時間後
- 説明: ユーザーがフォーカスしているページに最低限の連続時間を費やした後に評価されます。
- パラメーター:秒単位の期間。
- ユーザーが終了した場合
- 説明: カーソルがビューポートの上部に向かって上方向に移動したタイミングを評価します。
- パラメータ: ユーザーがページ上で過ごす必要がある最小時間(秒単位)をオプションで指定します。この時間は終了インテントがトリガーされるまでに必要です。
- スクロールしたとき
- 説明: ユーザーが特定の要素またはスクロール率までスクロールしたタイミングを評価します。
- パラメータ
- エレメントモード: CSSセレクターとビューポートの下部からのピクセルオフセット。正の値は要素がビューに入る前にトリガーされ、負の値は要素が部分的に表示された後にトリガーされます。
- パーセントモード: スクロールされたページのパーセンテージ (0 ~ 100) です。
- ユーザーが操作する場合
- 説明: 指定された要素のクリック、ホバー、またはフォーカスを当てたときに評価します。
- パラメータ
- 要素の CSS セレクター。
- インタラクションの種類(クリック、ホバー、フォーカス)。
- オプションの時間しきい値(ミリ秒単位)。 ホバーとフォーカスを行う場合、ユーザーはトリガーが起動するまでこの期間インタラクションを維持する必要があります。 クリックの場合、この遅延後にトリガーが起動します。
- マニュアル
- 説明: 開発者が
window.webExperiment.toggleManualPageObject(name, active)を呼び出したときに評価します。 名前識別子とtrueを渡してページオブジェクトを有効にするか、falseを渡して無効にします。 - パラメータ: ページ設定で設定された手動トリガーキーと一致する名前識別子です。
- 説明: 開発者が
トリガの評価
トリガが起動すると、この実験ではページのターゲティング条件が評価されます。条件が一致した場合、ページはアクティブになります。 トリガーは条件を無視しません。この実験は、トリガーとターゲット設定ルールの両方が一致した場合にのみ有効になります。
バリアントのページ範囲を管理する
各バリアントの範囲を特定のページに設定することで、バリアントの変更内容が意図した場所にのみ適用されます。 ページのスコープ設定はすべてのバリアントタイプに適用されます。
ビジュアルエディタ
ビジュアルエディタを使用してテキスト編集やスタイル更新などの変更を加えると、それらの変更はプレビューセッション中に選択したページに関連付けられます。 各変更について、その変更が適用されるページを指定します。
ビジュアルエディタでのページスコープにより、次のことが可能です。
- 特定のページに更新や変更を割り当てます。
- すべてのビューに同じ変更を適用することは避けてください。
- 実験セットアップ全体でより良い分離と明確さを維持できます。
ページスコープを検証
ページ間の競合や意図しない編集を避けるため、変更のたびにページスコープを確認してください。
カスタムコード
カスタムコードまたはURLリダイレクトをバリアントとして追加する場合、バリアントが適用されるページを明示的に定義してください。
ページのスコープ設定を使用すると、アクティブなページに応じて異なる動作を持つカスタムコードを含む単一の実験を作成できます。
URLリダイレクト
URLリダイレクトバリアントの設定でページを選択します。リダイレクトを特定のページまたはページセットにスコープ設定することで、Amplitudeは指定されたページがアクティブな場合にのみユーザーをリダイレクトします。
技術的な詳細
- この実験では、バケット化後にページが評価されるため、ページのバリアントは実験の対象となるユーザーにのみ影響します。
- Amplitudeは、実験内の他のページと競合するページを非アクティブ化します。
既知の制限事項
On Event Trackedプロパティフィルターは、トラッキング時にSDKから送信された未処理のイベントプロパティにのみ一致します。派生プロパティ、検索プロパティ、配列拡張プロパティなどのサーバー側プロパティは、トリガー評価時には使用できないため、フィルター条件として使用することはできません。- ページは以下では利用できません:
- 機能フラグ。
- 実験用テンプレート。
- 管理 API。
- あなたがテンプレートやフラグに変換する実験。
- ページを削除したりアーカイブしたりすることはできません。
- Amplitudeにはユニバーサル検索や実験テーブルビューのページは含まれません。
- ページがアラートや通知に表示されない。
これは役に立ちましたか?