> ## 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.

# Quickstart d’Experiment Center

> Apprenez à créer un feature flag, à ajouter des variations, à créer une expérience, à l’activer et à consulter des données enrichies sur l’expérience dans le log du tenant.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une phase de lancement du produit";
  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 && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Pour y participer, communiquez avec " + contact + ". "}
            {terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.</strong>
            </span>

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

<ReleaseStageNotice feature="Auth0 Experiment Center" stage="bêta" terms="true" contact="Auth0 Support" />

<Warning>
  Pendant la période bêta, Experiment Center est offert uniquement pour les tenants de développement. Les tenants de production ne sont pas pris en charge.
</Warning>

<div id="prerequisites">
  ## Prérequis
</div>

Pour commencer à utiliser Experiment Center, vous avez besoin de :

* **Un tenant Auth0 [de développement](/docs/fr-ca/get-started/tenant-settings#environment-tag)**

* **Une application [machine à machine](/docs/fr-ca/get-started/apis/create-m2m-app-test#create-machine-to-machine-applications-for-testing)** avec les scopes Management API suivants :

  ```text wrap lines theme={null}
  read:experimentation
  create:experimentation
  update:experimentation
  delete:experimentation
  ```

<div id="1-create-and-activate-the-feature-flag">
  ## 1. Créer et activer le feature flag
</div>

Un feature flag définit ce que vous testez et les variations possibles.

Pour créer un feature flag, envoyez une requête `POST` au point de terminaison [`/api/v2/experimentation/feature-flags`](/docs/fr-ca/api/management/v2/experimentation/create-feature-flag).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  * La réponse comprend une valeur `feature_flag_id` ; vous en aurez besoin dans les étapes suivantes.
  * Le feature flag est d’abord à l’état `draft`.
</Callout>

<div id="add-two-variations">
  ### Ajouter deux variations
</div>

Le feature flag doit comporter au moins deux variations avant de pouvoir être activé : un témoin et un traitement.

<div id="create-the-control-variation">
  #### Créer la variation témoin
</div>

Vous pouvez créer une variation témoin à l’aide du paramètre `overrides` pour un feature flag précis.

Pour ajouter une variation témoin, faites une requête `POST` vers le point de terminaison [`/api/v2/experimentation/feature-flags/{feature_flag_id}/variations`](/docs/fr-ca/api/management/v2/experimentation/create-variation).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  La réponse inclut une valeur `variation_id` pour la variation témoin. Vous en aurez besoin lors de la configuration des allocations.
</Callout>

<div id="create-the-treatment-variation">
  #### Créer la variation de traitement
</div>

La variation de traitement remplace les paramètres que vous souhaitez modifier.

Pour ajouter la variation de traitement, effectuez une requête `POST` vers le point de terminaison [`/api/v2/experimentation/feature-flags/{feature_flag_id}/variations`](/docs/fr-ca/api/management/v2/experimentation/create-variation) et configurez l’objet `overrides`.

```json Example theme={null}
    "overrides": {
      "show_passkey_prompt": { "value": true },
      "prompt_style": { "value": "modal" }
    }
```

<div id="activate-the-feature-flag">
  ### Activer le feature flag
</div>

Maintenant que vous avez deux variations, activez le feature flag. Une expérience ne peut pas être activée tant que le feature flag auquel elle est associée n’a pas le statut `active`.

Pour faire passer le statut du feature flag à `active`, effectuez une requête `POST` vers le point de terminaison [`/api/v2/experimentation/feature-flags/{feature_flag_id}/status`](/docs/fr-ca/api/management/v2/experimentation/update-feature-flag-status).

<div id="2-create-a-segment-optional">
  ## 2. Créer un segment (facultatif)
</div>

Si vous voulez cibler un trafic précis, créez un segment. Ignorez cette étape si vous voulez simplement répartir un pourcentage sur l’ensemble du trafic.

Pour créer un segment, effectuez une requête `POST` vers le point de terminaison [`/api/v2/experimentation/segments`](https://auth0.com/docs/api/management/v2/experimentation/create-segment).

Cet exemple crée un segment qui cible les utilisateurs mobiles aux États-Unis :

```json Example theme={null}
    "name": "mobile-us-users",
    "description": "Mobile users from the United States",
    "rules": [
      {
        "match_type": "all",
        "conditions": [
          { "attribute": "device_type", "operator": "equals", "value": "mobile" },
          { "attribute": "country", "operator": "equals", "value": "US" }
        ]
      }
    ]
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  La réponse contient une valeur `segment_id`. Les segments ne s’appliquent que lorsque vous utilisez la [stratégie d’allocation](/docs/fr-ca/api/management/v2/experimentation/create-experiment#body-allocation-strategy) `segment` dans l’expérience.
</Callout>

<div id="3-create-and-activate-an-experiment">
  ## 3. Créer et activer une expérience
</div>

Créez une expérience qui renvoie à votre feature flag et définit la façon de répartir le trafic.

Pour créer une expérience, envoyez une requête `POST` au point de terminaison [`/api/v2/experimentation/experiments`](/docs/fr-ca/api/management/v2/experimentation/create-experiment#body-allocations).

Cet exemple utilise une répartition 90/10 au moyen de l’objet `allocations` : 90 % des utilisateurs reçoivent le groupe témoin et 10 % reçoivent le traitement. Il s’agit d’un point de départ typique pour un déploiement prudent.

```json Example theme={null}
    "allocations": [
      {
        "variation_id": "var_Id",
        "weight": 90,
        "is_control": true
      },
      {
        "variation_id": "var_Id",
        "weight": 10,
        "is_control": false
      }
    ]

```

L’expérience démarre avec le statut `draft` et `is_valid: false`. C’est normal : la vérification complète de l’état de préparation s’effectue à l’étape suivante.

<div id="validate-the-experiment">
  ### Valider l’expérience
</div>

Avant de l’activer, assurez-vous que l’expérience est prête. Le point de terminaison `/validate` renvoie les mêmes vérifications que celles effectuées lors de l’activation.

Pour confirmer l’expérience, effectuez une requête `POST` au point de terminaison [`/api/v2/experimentation/experiments/{experiment_id}/validate`](/docs/fr-ca/api/management/v2/experimentation/validate-experiment).

La réponse inclut la valeur `is_valid` pour indiquer si vous êtes prêt à l’activer.

<div id="activate-the-experiment">
  ### Activer l’expérience
</div>

Lorsque l’expérience est valide et que vous avez testé les deux variations, activez-la.

Pour faire passer le statut de l’expérience à `active`, envoyez une requête `POST` à l’point de terminaison [`/api/v2/experimentation/experiments/{experiment_id}/status`](/docs/fr-ca/api/management/v2/experimentation/update-experiment-status).

La valeur `started_at` de l’expérience est définie lors de la première activation et ne change pas si vous la mettez en pause, puis la réactivez.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  **Une seule expérience active par tenant.** Si une autre expérience est déjà active, l’activation renvoie `400 experiment_active_limit_exceeded`. Mettez d’abord l’autre expérience en pause ou terminez-la.
</Callout>

<div id="4-trigger-an-auth-event-and-observe-results">
  ## 4. Déclenchez un événement d’authentification et observez les résultats
</div>

Déclenchez une connexion de test à partir de votre tenant de test. Par exemple, ouvrez un navigateur et accédez à votre URL `/authorize` sans aucun paramètre de remplacement.

Terminez le flux de connexion. Experiment Center résout l’expérience active, attribue une variation à l’aide d’un hachage déterministe, injecte le contexte de l’expérience et enrichit l’événement d’authentification qui en résulte.

<div id="verify-enriched-logs">
  ### Vérifier les journaux enrichis
</div>

Vous pouvez consulter les logs Auth0 pour les événements d’expérience :

* Accédez à Auth0 [**Dashboard > Monitoring > Logs**](https://manage.auth0.com/dashboard/#/logs).

* Utilisez la diffusion des journaux : si vous diffusez déjà les logs du tenant vers un outil d’analytique (Datadog, Splunk, Segment, etc.), les métadonnées d’expérience enrichies transitent automatiquement par le même flux.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  L’événement comprend des métadonnées d’expérience dans l’objet `details.experiment`. Le champ `variation_id` vous indique à quelle variation l’utilisateur a été attribué.
</Callout>

<Check>
  Vous avez mené avec succès votre première expérience lorsque :

  1. Vos événements d’authentification dans les logs du tenant incluent `details.experiment` avec `experiment_id` et `variation_id`
  2. Les deux variations produisent le comportement attendu lorsqu’elles sont testées avec des surcharges par paramètres de requête
  3. Le même appareil ou utilisateur obtient toujours le même `variation_id` dans plusieurs événements d’authentification (attribution déterministe)
</Check>

<div id="learn-more">
  ## En savoir plus
</div>

* Consultez le [guide d’intégration ACUL](/docs/fr-ca/customize/experiment-center/integrations/acul-integration-guide) pour découvrir comment adapter le code de votre composant ACUL en fonction du contexte de l’expérience.
* Consultez le [guide d’intégration Actions](/docs/fr-ca/customize/experiment-center/integrations/actions-integration-guide) pour utiliser `event.experiment` dans les déclencheurs post-login et d’enregistrement.