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

# Explication des champs personnalisés pour Advocate

Vous pouvez utiliser *des champs personnalisés* pour envoyer à impact.com des 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 vouloir inclure des informations sur :

* Date de naissance
* Langue
* Localisation
* 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 exemple, `customFieldName` est considéré comme distinct de `customfieldname`.
  {% endtab %}

{% tab title="Valeurs" %}

* Prend en charge `chaîne de caractères`, `nombre`, `booléen`et `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 la valeur d'un champ personnalisé pour un utilisateur sur `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 faites un upsert d'utilisateurs, quelle que soit la méthode utilisée pour envoyer les données.

{% tabs %}
{% tab title="Imports 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 les 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.

Voici deux fichiers d'exemple que vous pouvez utiliser pour guider votre importation.

* Imports de données utilisateur : [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](/files/90253111111d13b141358f566ccbcf5f4193e096) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](/files/90253111111d13b141358f566ccbcf5f4193e096)
* Imports de données d'événements : [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](/files/90253111111d13b141358f566ccbcf5f4193e096) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](/files/90253111111d13b141358f566ccbcf5f4193e096)
  {% 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 font un upsert d'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 faire un upsert d'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 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://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=<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.