> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# エンティティの詳細

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

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "ベータ",
    "ea": "早期アクセス"
  };
  const stageText = stageTextMap[stage] || "製品リリース段階";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>この機能は、{linkify(`${plans}プラン`, "https://auth0.com/pricing")}で利用できます。 </>}
            {contact && "参加するには、" + contact + " までお問い合わせください。 "}
            {terms && <>この機能を使用すると、Okta の{linkify("Master Subscription Agreement", "https://www.okta.com/legal")}に定める該当する無料トライアル条件に同意したものとみなされます。</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>{feature} 機能は現在、{linkify(stageText, prsLink)}です。</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Experiment Center" stage="beta" terms="true" contact="Auth0 サポート" />

Auth0 の[Management API](/ja/docs/api/management/v2)を使用すると、プロパティ、ライフサイクルの状態、検証ルールなど、Experiment Center エンティティの詳細を定義できます。

<Warning>
  ベータ期間中、Experiment Center は開発テナントでのみ利用できます。本番テナントはサポート対象ではありません。
</Warning>

<div id="experiment">
  ## 実験
</div>

<div id="experiment-lifecycle">
  ### 実験 のライフサイクル
</div>

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

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

ライフサイクルを遷移させるには、Management API の [`/api/v2/experimentation/experiments/{id}/status`](/ja/docs/api/management/v2/experimentation/update-experiment-status) エンドポイントを使用します。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  `completed → active` への遷移は許可されていません。同じテストを再度実行する必要がある場合は、新しい実験 を作成してください。
</Callout>

<div id="the-is_valid-gate">
  ### `is_valid` ゲート
</div>

実験を有効化するには、事前に準備状況チェックに合格している必要があります。

Experiment Center は、すべての実験に `is_valid` という Boolean 値を保持し、書き込みのたびに再計算します。これにより、セットアップ中にすぐフィードバックを得られます。

また、Management API の [`/api/v2/experimentation/experiments/{id}/validate`](/ja/docs/api/management/v2/experimentation/validate-experiment) エンドポイントを使用して、準備状況を明示的に確認することもできます。

このエンドポイントは `is_valid: true/false` と、すべての阻害要因を一覧表示する `errors` 配列を返します。status エンドポイントを通じて有効化を試みた場合も、同じチェックが自動的に実行されます。

**有効化時に確認される検証ルール:**

* 参照される機能フラグが `active` status である
* 少なくとも 1 つの割り当てが存在する
* すべての割り当ての `variation_id` 値が、その実験の機能フラグに属している
* `is_control: true` の割り当てがちょうど 1 つある
* 割り当ての重みの合計が 100 である (percentage strategy)
* `is_fallback: true` の割り当てがちょうど 1 つある (segment strategy)
* 現在、そのテナントで有効な他の実験が存在しない (Beta のみ)

<div id="assignment">
  ### 割り当て
</div>

**クエリーパラメーターによる上書き**

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

| パラメーター          | 説明                                       |
| --------------- | ---------------------------------------- |
| `experiment_id` | 特定の実験に登録します                              |
| `variation_id`  | 特定のバリエーションを強制します (`experiment_id` が必要です) |
| `segment_id`    | 特定のセグメントを強制します (`experiment_id` が必要です)   |

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

<div id="feature-flag">
  ## 機能フラグ
</div>

<div id="feature-flag-lifecycle">
  ### 機能フラグのライフサイクル
</div>

機能フラグには、3 つの状態からなるライフサイクルが保存されます。

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

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

**有効化の条件:** 機能フラグは、少なくとも 2 つのバリエーションを持つまで `active` に移行できません。これにより、有効なフラグには本番公開前に、少なくともコントロール 1 つとトリートメント 1 つが含まれることが保証されます。

```text wrap lines theme={null}
draft → active   (requires ≥2 variations)
draft → archived
active → archived (terminal; no way back)
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  `archived → active` への移行は許可されていません。フラグをアーカイブした後に別のテストを実行する必要がある場合は、新しい機能フラグを作成してください。
</Callout>

<div id="variation">
  ### バリエーション
</div>

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

機能フラグのパラメーターは、実験の設定範囲を定義します。各パラメーターには、次の要素があります。

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

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  パラメーターで使用できるのは**構造化モードのみ**です。各パラメーターは、名前付きのキーと型付きの値で構成されます。
</Callout>

<div id="segment">
  ## セグメント
</div>

<div id="segment-rules">
  ### セグメントルール
</div>

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

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

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

<div id="available-condition-attributes">
  ### 利用可能な条件属性
</div>

セグメントで使用できるのは、`/authorize` トランザクションの開始時点で利用可能な属性のみです。

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

<div id="learn-more">
  ## さらに詳しく
</div>

<CardGroup cols={2}>
  <Card title="Experiment Center クイックスタート" icon="gear" href="/ja/docs/customize/experiment-center/quickstart">
    機能フラグ、バリエーション、実験をエンドツーエンドで作成する手順を確認します。
  </Card>

  <Card title="ACUL 統合" icon="puzzle-piece" href="/ja/docs/customize/experiment-center/integrations/acul-integration-guide">
    Auth0 Custom Universal Login (ACUL) 画面内で実験コンテキストを読み取ります。
  </Card>
</CardGroup>