> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content.md).

# Activation du contenu adaptatif

Choisissez une méthode d’authentification pour transmettre les données utilisateur à GitBook.

Pour commencer à personnaliser l'expérience de documentation de vos lecteurs, vous devrez activer le contenu adaptatif et décider comment les données de vos visiteurs sont transmises à GitBook. Cela permet au contenu de votre site de s'adapter dynamiquement en fonction de la personne qui le consulte.

### Activer le contenu adaptatif

Avant de pouvoir transmettre les données utilisateur à GitBook, vous devrez configurer votre site pour utiliser le contenu adaptatif.

Rendez-vous dans les [paramètres du site](/docs/documentation/fr/gerer-votre-site/site-settings.md), et activez **Contenu adaptatif** dans les paramètres d'audience de votre site. Une fois activé, vous obtiendrez une « clé de signature du jeton visiteur » générée, dont vous aurez besoin pour poursuivre la configuration du contenu adaptatif.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F5EeWAo5Ij6CKrp69uMl5%2F26_01_06_enable_adaptive_content%402x.png?alt=media&amp;token=4a1e8558-4b91-4f8b-8581-63d570a2c330" alt="A GitBook screenshot showing the enable adaptive content toggle"><figcaption><p>Activer le contenu adaptatif dans les paramètres de votre site</p></figcaption></figure>

### Définissez le schéma de votre visiteur

Après avoir activé le contenu adaptatif, vous devrez définir un schéma pour les types de revendications que vous attendez de GitBook lorsqu’un utilisateur visite votre site.

Le schéma du visiteur doit refléter la structure de ces revendications lorsqu’elles sont envoyées à GitBook.

Par exemple, si vous pensez qu’un visiteur peut potentiellement être un utilisateur bêta dans votre produit, vous définiriez un schéma de visiteur similaire à :

```json
{
  "type": "object",
  "properties": {
    "isBetaUser": {
      "type": "boolean",
      "description": "Indique si le visiteur est un utilisateur bêta."
    }
  },
  "additionalProperties": false
}
```

Cela vous aidera également à utiliser la saisie semi-automatique lors de la configuration de vos revendications dans l' [éditeur de conditions](/docs/documentation/fr/publier/adaptive-content/adapting-your-content.md#working-with-the-condition-editor). Les schémas de visiteurs ne prennent en charge que les types suivants :

{% tabs %}
{% tab title="Chaînes de caractères" %}
Lisez les revendications transmises sous forme de chaînes de caractères.

GitBook accepte les chaînes dynamiques, ce qui signifie que vous pouvez transmettre dynamiquement des données de type chaîne — comme le nom d’un utilisateur, des jetons développeur, et plus encore.

Les chaînes peuvent également contenir une **énumération facultative** clé, qui vous permet de restreindre les données reçues par GitBook à l’une des valeurs définies.

```json
{
  "type": "object",
  "properties": {
    "language": {
          "type": "string",
          "description": "La langue du visiteur",
          // Propriété d'énumération facultative
          "enum": [
            "en",
            "fr",
            "it"
          ]
  },
  "additionalProperties": false
}
```

{% hint style="warning" %}
Les chaînes dynamiques (chaînes définies sans clé d’énumération) ne sont acceptées que pour les [expressions en ligne](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md#use-variables-in-your-content). Les expressions conditionnelles pour la visibilité des éléments (pages, sections, blocs) ne fonctionnent qu’avec des chaînes définies avec des clés d’énumération.
{% endhint %}
{% endtab %}

{% tab title="Booléens" %}
Lisez les revendications transmises sous forme de booléens.

```json
{
  "type": "object",
  "properties": {
    "isBetaUser": {
      "type": "boolean",
      "description": "Indique si le visiteur est un utilisateur bêta."
    },
  },
  "additionalProperties": false
}
```

{% endtab %}

{% tab title="Objets" %}
Imbriquez les revendications dans un objet pour regrouper des valeurs similaires.

```json
{
  // Revendications de niveau supérieur
  "type": "object",
  "properties": {
    // Revendications imbriquées
    "access": {
      "type": "object",
      "description": "Accès de l’utilisateur à la fonctionnalité du produit",
      "properties": {
        "isAlphaUser": {
          "type": "boolean",
          "description": "Indique si le visiteur est un utilisateur Alpha."
        },
        "isBetaUser": {
          "type": "boolean",
          "description": "Indique si le visiteur est un utilisateur bêta."
        },
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
```

{% endtab %}
{% endtabs %}

### Définissez une revendication non signée

Les revendications non signées sont un type spécifique de revendication qui identifie les revendications susceptibles de ne pas être signées par une application cliente. Il est nécessaire de définir les revendications de votre schéma de visiteur comme `non signées` si vous transmettez des revendications via des paramètres d’URL, des cookies non signés et des indicateurs de fonctionnalité.

Si vous avez l’intention de travailler avec des revendications non signées, vous devrez déclarer dans le schéma les revendications attendues sous une propriété « unsigned », en plus de vos revendications signées.

```json
{
  "type": "object",
  "properties": {
    "isBetaUser": {
      "type": "boolean",
      "description": "Indique si le visiteur est un utilisateur bêta."
    },
    // Ajouter des revendications non signées
    "unsigned": {
      "type": "object",
      "description": "Revendications non signées du visiteur du site.",
      "properties": {
        "language": {
          "type": "string",
          "description": "La langue du visiteur",
          // Propriété d'énumération facultative
          "enum": [
            "en",
            "fr",
            "it"
          ]
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
```

### Transmettez les données du visiteur à GitBook

GitBook propose différentes façons de transmettre les données des visiteurs pour adapter le contenu de votre site. Après avoir défini votre schéma, vous devrez décider comment vous souhaitez transmettre les données de vos visiteurs à GitBook.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-cookie">:cookie:</i></td><td><strong>Cookies</strong></td><td>Transmettez les données des visiteurs à votre documentation via un cookie public ou signé.</td><td><a href="/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/cookies.md">Cookies</a></td></tr><tr><td><i class="fa-link">:link:</i></td><td><strong>URL</strong></td><td>Transmettez les données des visiteurs à votre documentation via des paramètres de requête URL.</td><td><a href="/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/url.md">URL</a></td></tr><tr><td><i class="fa-flag">:flag:</i></td><td><strong>Indicateurs de fonctionnalité</strong></td><td>Transmettez les données des visiteurs à votre documentation via un fournisseur d’indicateurs de fonctionnalité.</td><td><a href="/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/feature-flags.md">Indicateurs de fonctionnalité</a></td></tr><tr><td><i class="fa-lock">:lock:</i></td><td><strong>Accès authentifié</strong></td><td>Transmettez les données des visiteurs à votre documentation via un fournisseur d’authentification.</td><td><a href="/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/authenticated-access.md">Accès authentifié</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.