エンティティの詳細

Experiment Center のエンティティ（フィーチャーフラグ、バリエーション、セグメント、実験、割り当て）について説明します。

Auth0のManagement APIを使用すると、プロパティ、ライフサイクルのステータス、検証ルールなど、Experiment Center エンティティの詳細を定義できます。

Beta期間中、Experiment Center は開発用テナントでのみ利用できます。本番用テナントはサポートされていません。

​

実験

​

実験のライフサイクル

実験には 5 つの状態があります。

ステータス	意味
draft	作成済みですが、まだ実行されていません。クエリパラメータによるオーバーライドを使って安全にテストできます。
active	実行中です。バリアントの割り当てとコンテキストの挿入が、すべての認証トランザクションで有効です。
paused	一時停止中です。新規の割り当ては行われません。進行中のセッションでは、割り当て済みのバリエーションが維持されます。
completed	終了しています。新規の割り当ては行われません。手動で昇格する際の参照用に Configuration は保持されます。
archived	論理削除されています。既定のリスト表示では非表示になります。分析データは保持されます。

ライフサイクルを移行するには、Management API の /api/v2/experimentation/experiments/{id}/status エンドポイントを使用します。

completed → active への移行はできません。同じテストを再度実行する必要がある場合は、新しい実験を作成してください。

​

is_valid ゲート

実験を有効化する前に、準備完了チェックに合格する必要があります。

Experiment Center では、すべての実験に is_valid というブール値が保存され、書き込みのたびに再計算されます。これにより、設定中にすぐフィードバックを得られます。

また、Management API の /api/v2/experimentation/experiments/{id}/validate エンドポイントを使用して、準備完了状態を明示的に確認することもできます。

このエンドポイントは is_valid: true/false と、各ブロッカーを一覧にした errors 配列を返します。ステータス エンドポイント経由で有効化を試みた場合も、同じチェックが自動的に実行されます。

有効化時にチェックされる検証ルール:

• 参照されているフィーチャーフラグが active ステータスである
• 少なくとも 1 つの割り当てが存在する
• すべての割り当ての variation_id 値が、その実験のフィーチャーフラグに属している
• is_control: true を持つ割り当てがちょうど 1 つある
• 割り当ての重みの合計が 100 である (パーセンテージ戦略)
• is_fallback: true を持つ割り当てがちょうど 1 つある (セグメント戦略)
• テナント内で現在有効な他の実験が存在しない (Beta のみ)

​

割り当て

クエリパラメータによるオーバーライド

クエリパラメータを指定すると、任意の /authorize リクエストに特定の割り当てを強制できます。

Parameter	Description
experiment_id	特定の実験に登録する
variation_id	特定の バリエーション を強制する (experiment_id が必要)
segment_id	特定の セグメント を強制する (experiment_id が必要)

これは、draft を含むあらゆるステータスの実験で機能します。開発中はこれを使って、有効化する前に両方の バリエーション が正しく表示されることを確認してください。

​

フィーチャーフラグ

​

フィーチャーフラグのライフサイクル

フィーチャーフラグのライフサイクルは、次の 3 つの状態で管理されます。

ステータス	意味
draft	作成済みですが、まだ有効ではありません。有効な実験から参照することはできません。
active	使用可能な状態です。このフラグを参照する実験を有効化するには、事前にこの状態になっている必要があります。
archived	終了状態です。新しい実験からこのフラグを参照することはできません。必要に応じて新しいフラグを作成してください。

ステータスを切り替えるには、Auth0 Management API の /api/v2/experimentation/feature-flags/{id}/status エンドポイントを使用します。

有効化の条件: フィーチャーフラグは、少なくとも 2 つのバリエーションを持つまで active に移行できません。これにより、すべての有効なフラグは、本番利用される前に最低でも 1 つの control と 1 つの treatment を備えていることが保証されます。

draft → active   (requires ≥2 variations)
draft → archived
active → archived (terminal; no way back)

archived → active への移行はできません。フラグをアーカイブした後に別のテストを実行する必要がある場合は、新しい フィーチャーフラグ を作成してください。

​

バリエーション

パラメータとオーバーライド

フィーチャーフラグ のパラメータは、実験の設定項目を定義します。各パラメータには、次のものがあります。

• 名前 (例: show_passkey_prompt)
• 型: string、boolean、number、array、または object
• デフォルト値 (ベースライン)

バリエーションの overrides では、異なるパラメータだけを指定します。実行時には、Experiment Center がフラグのベースラインとバリエーションのオーバーライドをマージし、マージ後の完全な config オブジェクトを ACUL、Actions、ページテンプレートに渡します。すべてのパラメータには常に config 内で値が設定されるため、フォールバックロジックを書く必要はありません。

パラメータで使用できるのは構造化モードのみです。各パラメータは、名前付きキーと型付きの値を持ちます。

​

セグメント

​

セグメントのルール

セグメントの rules は、ルールオブジェクトの配列です。配列内の いずれか のルールに一致すると、そのリクエストはそのセグメントに一致します。

• match: すべての条件が true である必要があります (AND ロジック)
• not_match: すべての条件が true である必要があります (NOT ロジック)

各条件では、演算子 contains、starts_with、ends_with、exists を使って、属性と値を比較します。

​

使用可能な条件属性

セグメントで使用できる属性は、/authorize トランザクションの開始時に利用可能なものに限られます。

カテゴリ	属性
クライアント	client_id
接続	connection, connection_type
組織	organization_id
ドメイン	domain
デバイスとブラウザー	device_type, browser, platform, user_agent
地理情報 (IP 由来)	country, region

​

詳細情報

Experiment Center Quickstart

フィーチャーフラグ、バリエーション、実験を一通り作成する手順を確認します。

ACUL 連携

Auth0 Custom Universal Login (ACUL) の画面内で実験のコンテキストを読み取ります。