> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md).

# Champs personnalisés pour Advocate expliqués

Vous pouvez utiliser *champs personnalisés* pour envoyer à impact.com des éléments de données supplémentaires sur les participants à votre programme de parrainage. Ces informations peuvent être utilisées dans vos [règles du programme](/brand/fr/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) pour déterminer quand les objectifs et les actions sont déclenchés. Vous pouvez également segmenter vos participants en fonction des valeurs des champs personnalisés.

Les types de champs personnalisés que vous envoyez sont flexibles. Par exemple, vous pouvez souhaiter inclure des informations sur un participant :

* Date de naissance
* Langue
* Lieu
* Type d’abonnement
* Statut d’adhésion

Les champs personnalisés peuvent être envoyés à impact.com lorsque vous téléversez un fichier d'importation d'utilisateurs ou via UTT, l’API, le SDK ou une autre méthode d’intégration.

#### Caractéristiques des champs

Tous les champs personnalisés que vous envoyez doivent respecter quelques exigences concernant les noms et les valeurs des champs.

{% tabs %}
{% tab title="Noms" %}

* Jusqu’à 64 caractères.
* Seuls les caractères alphanumériques, les tirets et les underscores sont acceptés (les lettres doivent être non accentuées).
* Sensible à la casse, par ex., `customFieldName` est considéré comme distinct de `customfieldname`.
  {% endtab %}

{% tab title="Valeurs" %}

* Prend en charge `chaîne`, `nombre`, `Booléen`, et `types null`.
* Valeur de chaîne maximale de 1024 caractères.
* Les dates doivent être formatées sous forme d'horodatage UNIX en millisecondes.
* Un maximum de 100 champs peut être ajouté/mis à jour par requête.
* Définir un champ personnalisé pour un utilisateur à `null` supprimera le champ pour cet utilisateur.
  {% endtab %}
  {% endtabs %}

#### Envoyer des informations de champ personnalisé à impact.com

Vous pouvez inclure des champs personnalisés chaque fois que vous créez, mettez à jour ou upsertez des utilisateurs, quelle que soit la méthode par laquelle vous envoyez les données.

{% tabs %}
{% tab title="Importations de fichiers" %}
Vous pouvez inclure des champs personnalisés lors de l'importation de nouveaux utilisateurs ou de la mise à jour en masse d'utilisateurs existants. Consultez [Importer des participants Advocate en masse](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md) pour obtenir les instructions.

Vous trouverez ci-dessous deux fichiers d'exemple que vous pouvez utiliser pour guider votre importation.

* Importations de données utilisateur : [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* Importations de données d'événements : [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
  {% endtab %}

{% tab title="API et SDK" %}
Les champs personnalisés peuvent être inclus lors de l'utilisation des [méthodes GraphQL](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/graphql-api) ou [points de terminaison de l'API REST](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/advocate-rest-api) qui créent, mettent à jour ou réalisent un upsert des utilisateurs. Ils peuvent également être inclus lors de l'utilisation de [UTT](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/advocate-installation-scripts) ou de nos [options mobiles](https://integrations.impact.com/integration-guides/for-brands/advocate/mobile-options-for-advocate/mobile-options-for-advocate-programs) pour créer, mettre à jour ou réaliser un upsert des utilisateurs depuis votre application.
{% endtab %}
{% endtabs %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.