> 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 *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
* Emplacement
* Type d’abonnement
* Statut d’adhésion

Les champs personnalisés peuvent être envoyés à impact.com lorsque vous téléchargez un fichier d’importation d’utilisateurs ou via UTT, API, 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 de champs et les valeurs.

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

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

{% tab title="Valeurs" %}

* Prend en charge `chaîne de caractères`, `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 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 effectuez un upsert d’utilisateurs, quelle que soit la méthode utilisée pour envoyer 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. Reportez-vous à [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.

Vous trouverez ci-dessous deux exemples de fichiers 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) ![](/files/90253111111d13b141358f566ccbcf5f4193e096) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](/files/90253111111d13b141358f566ccbcf5f4193e096)
* Importations 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/impact-brand/docs/graphql-reference) ou [points de terminaison Rest API](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) de impact.com qui créent, mettent à jour ou effectuent un upsert d’utilisateurs. Ils peuvent également être inclus lors de l’utilisation de [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) ou de nos [options mobiles](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) pour créer, mettre à jour ou effectuer 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.