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

# Guide de démarrage rapide du centre d’expérimentation

> Découvrez comment créer un indicateur de fonctionnalité, ajouter des variantes, créer une expérience, l’activer et consulter des données d’expérience enrichies dans les logs du locataire.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une étape du cycle de publication";
  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 {linkify(`${plans} forfaits`, "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="beta" terms="true" contact="assistance Auth0" />

<Warning>
  Pendant la version bêta, Experiment Center fonctionne uniquement avec les locataires de développement. Les locataires de production ne sont pas pris en charge.
</Warning>

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

Pour commencer à utiliser Experiment Center, vous devez disposer des éléments suivants :

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

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

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

<div id="1-create-and-activate-the-feature-flag">
  ## 1. Créez et activez l’indicateur de fonctionnalité
</div>

Un indicateur de fonctionnalité définit ce que vous testez et les variations possibles.

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  * La réponse inclut une valeur `feature_flag_id` ; vous en aurez besoin dans les étapes suivantes.
  * L’indicateur de fonctionnalité est initialement au statut `draft`.
</Callout>

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

L’indicateur de fonctionnalité doit comporter au moins deux variations avant de pouvoir être activé : un témoin et une variante.

<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 indicateur de fonctionnalité donné.

Pour ajouter une variation témoin, effectuez un appel `POST` au point de terminaison [`/api/v2/experimentation/feature-flags/{feature_flag_id}/variations`](/fr-CA/docs/api/management/v2/experimentation/create-variation).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  La réponse comprend 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`](/fr-CA/docs/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 l’indicateur de fonctionnalité
</div>

Maintenant que vous avez deux variations, activez l’indicateur de fonctionnalité. Une expérience ne peut pas être activée tant que l’indicateur de fonctionnalité auquel elle fait référence n’a pas le statut `active`.

Pour faire passer le statut de l’indicateur de fonctionnalité à `active`, effectuez un appel `POST` au point de terminaison [`/api/v2/experimentation/feature-flags/{feature_flag_id}/status`](/fr-CA/docs/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 une simple répartition en pourcentage sur l’ensemble du trafic.

Pour créer un segment, effectuez un appel `POST` au 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 inclut une valeur `segment_id`. Les segments s’appliquent uniquement lorsque vous utilisez la stratégie d’allocation [`segment`](/fr-CA/docs/api/management/v2/experimentation/create-experiment#body-allocation-strategy) 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 fait référence à votre indicateur de fonctionnalité 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`](/fr-CA/docs/api/management/v2/experimentation/create-experiment#body-allocations).

Cet exemple utilise une répartition de 90/10 au moyen de l’objet `allocations` : 90 % des utilisateurs reçoivent la version témoin, 10 % le traitement. Il s’agit d’un point de départ courant 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 commence avec le statut `draft` et `is_valid: false`. C’est normal; la vérification complète de l’état de préparation se fait à 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 au moment de l’activation.

Pour valider l’expérience, effectuez un appel `POST` au point de terminaison [`/api/v2/experimentation/experiments/{experiment_id}/validate`](/fr-CA/docs/api/management/v2/experimentation/validate-experiment).

La réponse inclut la valeur `is_valid`, qui indique si l’expérience est prête à être activée.

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

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

Pour faire passer le statut de l’expérience à `active`, envoyez une requête `POST` au point de terminaison [`/api/v2/experimentation/experiments/{experiment_id}/status`](/fr-CA/docs/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 locataire.** 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 dans votre locataire de test. Par exemple, ouvrez un navigateur et accédez à votre URL `/authorize` sans aucun paramètre de substitution.

Terminez le flux de connexion. Experiment Center détermine 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 logs 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 Log streaming : si vous transférez déjà les logs du locataire vers un outil d’analytique (Datadog, Splunk, Segment, etc.), les métadonnées enrichies de l’expérience transitent automatiquement par le même flux.

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

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

  1. Vos événements d’authentification dans les logs du locataire 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 de paramètres de requête
  3. Le même appareil ou utilisateur obtient systématiquement le même `variation_id` dans plusieurs événements d’authentification (affectation déterministe)
</Check>

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

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