> 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.md).

# Créer des récompenses en espèces en masse avec Advocate

Bien que de nombreuses récompenses soient déclenchées automatiquement par les règles du programme (comme une conversion de parrainage), il peut parfois être nécessaire de récompenser des participants pour des actions manuelles ou hors ligne — par exemple, pour avoir répondu à un sondage ou remporté un concours.

Le **Récompenses groupées** L’outil d’importation vous permet d’attribuer de l’argent, des points ou des cartes-cadeaux à plusieurs ambassadeurs en une seule fois en téléversant un fichier CSV. Cette fonctionnalité comprend un mécanisme de sécurité de test à blanc afin de garantir que vos données sont correctes avant tout versement de fonds.

### Préparez votre fichier d’importation

{% hint style="success" %}
**Remarque**: Si vous utilisez les paramètres d'importation globaux, il vous suffira de soumettre une `userId` liste.
{% endhint %}

Pour commencer, vous aurez besoin d’un fichier CSV ou JSONL contenant la liste des utilisateurs que vous souhaitez récompenser.

* **Colonnes obligatoires**: Votre fichier doit au minimum inclure `userId` pour identifier l’utilisateur.
* **Colonnes facultatives**: Vous pouvez inclure les détails de la récompense (p. ex. montant, unité, type) dans le fichier. Sinon, nous vous recommandons de les définir comme *valeurs par défaut globales* sur la plateforme pendant le processus d’importation afin de simplifier votre fichier.

#### Référence des colonnes du fichier

<table data-header-hidden><thead><tr><th width="297.484375">Colonne</th><th>Description</th><th>Exigence</th></tr></thead><tbody><tr><td><code>userId</code></td><td>L’identifiant unique de l’utilisateur.</td><td><mark style="color:$danger;">Obligatoire</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>Le montant à récompenser (p. ex. 50).</td><td>Conditionnel<br>(Non requis si une valeur par défaut globale est définie)</td></tr><tr><td><code>rewardUnit</code></td><td>L’unité de la récompense (p. ex. USD, POINTS).</td><td>Conditionnel<br>(Non requis si une valeur par défaut globale est définie)</td></tr><tr><td><code>globalRewardKey</code></td><td>La clé d’une récompense préconfigurée à attribuer.</td><td><p>Conditionnel<br>(Non requis si une valeur par défaut globale est définie)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>Le montant à récompenser sous forme de remise</td><td>Conditionnel<br>(Non requis si une valeur par défaut globale est définie)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Mettre la récompense en attente jusqu’à cette date.</td><td>Facultatif</td></tr><tr><td><code>uniqueId</code></td><td>Un identifiant unique pour la transaction.</td><td><mark style="color:$success;">Recommandé</mark><br>Utilisé comme clé de sécurité pour empêcher les récompenses en double si le fichier est relancé.</td></tr><tr><td><code>customerNote</code></td><td>Ajoutez une note qui sera visible par le client.</td><td>Facultatif</td></tr><tr><td><code>internalNote</code></td><td>Ajoutez une note à usage interne que le client ne pourra pas voir.</td><td>Facultatif</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configurer les paramètres d'importation

1. Dans le menu de navigation de gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Rapports → Importations et exportations**.
2. Dans le coin supérieur droit, sélectionnez **Importer**.
3. Sous *Type d'importation*, sélectionnez **Récompenses**.

<div data-with-frame="true"><figure><img src="https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**Définir des valeurs prédéfinies (valeurs par défaut globales)**

Pour gagner du temps et réduire les erreurs dans votre fichier CSV, vous pouvez définir des valeurs prédéfinies qui s'appliquent à chaque ligne de votre importation.

* **Récompense**: Choisissez une récompense préconfigurée ou spécifiez une unité manuelle (p. ex. « Cash/USD »).
* **Programme**: Associez ces récompenses à un programme spécifique à des fins de reporting.
* **Durée de mise en attente de la récompense**: ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Activer]** pour ajouter une marge de sécurité (p. ex. 30 jours) avant que la récompense ne soit disponible pour l'utilisateur. Cela laisse le temps d'effectuer des annulations si nécessaire.

{% hint style="success" %}
**Remarque**: Si vous définissez une valeur ici (p. ex. Unité de récompense : USD), vous n' **pas** avez besoin d'inclure cette colonne dans votre fichier CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Téléversement et test à blanc

Comme les récompenses en argent sont définitives et ne peuvent pas être annulées, le système exige un test à blanc (importation de test) afin que vous puissiez examiner les détails en toute confiance avant de traiter les récompenses.

1. Sous la *Téléversez votre fichier CSV ou JSONL d'utilisateurs à importer* sélectionnez **Choisir un fichier**.
2. Sélectionnez **Lancer l’import test** pour lancer l'état de test.
3. Le système traitera le fichier **sans** en créant des récompenses.

<div data-with-frame="true"><figure><img src="https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Révision et finalisation

Une fois l'exécution de test terminée, vous verrez une entrée de statut dans la liste Imports et exports. Des e-mails peuvent être envoyés dans le cadre du processus de révision (cartes-cadeaux, configuration des paiements, etc.).

1. **Examiner**: S'il y a des erreurs (indiquées par ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **\[Exclaimation]**), sélectionnez **Télécharger le rapport d'erreurs** pour corriger votre fichier et réessayer. Sélectionnez également **Télécharger le rapport** pour obtenir un enregistrement de toutes les récompenses qui seront créées. Qu'il y ait une erreur ou non, il est recommandé de le consulter.
2. **Confirmer**: Si le test est réussi (indiqué par un ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **\[Coche]**), sélectionnez **Lancer l’importation**.
3. Une boîte de dialogue de confirmation apparaîtra, résumant l'impact total (par ex. « En exécutant cette importation, 412 récompenses seront créées »). Sélectionnez **Lancer l’importation** pour confirmer et verser les récompenses.

Si vous décidez de ne pas continuer, vous pouvez simplement annuler l'exécution, puis sélectionner Abandonner pour supprimer l'exécution de test.

<div data-with-frame="true"><figure><img src="https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.