> 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 (par exemple, la conversion d’un parrainage), vous devrez parfois récompenser les participants pour des actions manuelles ou hors ligne, comme répondre à un sondage ou gagner un concours.

L’outil **de récompenses groupées** vous permet d’attribuer de l’argent, des points ou des cartes-cadeaux à plusieurs ambassadeurs à la fois en important un fichier CSV. Cette fonctionnalité comprend un mécanisme de simulation pour vérifier l’exactitude de vos données avant le versement des fonds.

### Préparer votre fichier d’importation

{% hint style="success" %}
**Remarque** : si vous utilisez les paramètres d’importation globaux, il vous suffit d’envoyer une liste de `userId` .
{% 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 (par exemple, le montant, l’unité et le type) dans le fichier. Vous pouvez aussi définir ces valeurs par défaut *à l’échelle globale* sur la plateforme pendant l’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>Identifiant unique de l’utilisateur.</td><td><mark style="color:$danger;">Obligatoire</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>Montant de la récompense (par exemple, 50).</td><td>Conditionnel<br>(Obligatoire uniquement si aucune valeur globale par défaut n’est définie)</td></tr><tr><td><code>rewardUnit</code></td><td>Unité de la récompense (par exemple, USD, POINTS).</td><td>Conditionnel<br>(Obligatoire uniquement si aucune valeur globale par défaut n’est définie)</td></tr><tr><td><code>globalRewardKey</code></td><td>Clé d’une récompense préconfigurée à attribuer.</td><td><p>Conditionnel<br>(Obligatoire uniquement si aucune valeur globale par défaut n’est définie)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>Montant de la récompense sous forme de remise</td><td>Conditionnel<br>(Obligatoire uniquement si aucune valeur globale par défaut n’est définie)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Différer la récompense jusqu’à cette date.</td><td>Facultatif</td></tr><tr><td><code>uniqueId</code></td><td>Identifiant unique de la transaction.</td><td><mark style="color:$success;">Recommandé</mark><br>Utilisé comme clé de sécurité pour éviter les doublons de récompenses si le fichier est traité à nouveau.</td></tr><tr><td><code>customerNote</code></td><td>Ajouter une note visible par le client.</td><td>Facultatif</td></tr><tr><td><code>internalNote</code></td><td>Ajouter 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] → Reporting → Imports & Exports**.
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 indiquez une unité manuellement (par ex. « Cash/USD »).
* **Programme** : associez ces récompenses à un programme spécifique à des fins de reporting.
* **Délai d’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 un délai de sécurité (par ex. 30 jours) avant que la récompense soit mise à la disposition de l’utilisateur. Cela laisse le temps de procéder à des rétractations si nécessaire.

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

{% step %}

#### Importer et effectuer un test à blanc

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

1. Dans la section *Importer votre fichier CSV ou JSONL contenant les utilisateurs* sélectionnez **Choisir un fichier**.
2. Sélectionner **Lancer l’importation test** pour lancer le test.
3. Le système traitera le fichier **sans** créer de 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 %}

#### Vérifier et finaliser

Une fois le test terminé, une entrée d’état apparaîtra dans la liste Importations et exportations. Des e-mails peuvent être envoyés pendant le processus de vérification (cartes-cadeaux, configuration des paiements, etc.).

1. **Vérifier** : en cas d’erreurs (signalé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) **\[Point d’exclamation]**), 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 relevé de toutes les récompenses qui seront créées. Qu’il y ait des erreurs ou non, il est recommandé de le consulter.
2. **Confirmer** : si le test réussit (signalé par une ![](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 fenêtre de confirmation récapitulera l’impact total (par ex. : « Cette importation créera 412 récompenses »). Sélectionnez **Lancer l’importation** pour confirmer et verser les récompenses.

Si vous décidez de ne pas poursuivre, vous pouvez simplement annuler l’exécution, puis sélectionner « Supprimer » pour effacer le 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 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.
