Ctrlk
Integrations HubContact SupportLog In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 les participants pour des actions manuelles ou hors ligne — comme remplir un sondage ou gagner un concours.

Le Récompenses en masse L’outil d’importation vous permet d’émettre des espèces, des points ou des cartes-cadeaux à plusieurs ambassadeurs à la fois en téléversant un fichier CSV. Cette fonctionnalité inclut un mécanisme de sécurité d’exécution à blanc pour garantir que vos données sont correctes avant tout déboursement de fonds.

Préparez votre fichier d’importation

Remarque: Si vous utilisez les paramètres d’importation globaux, vous n’aurez alors qu’à soumettre une userId liste.

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

  • Colonnes requises: 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 dans la plateforme pendant le processus d’importation pour simplifier votre fichier.

Référence des colonnes du fichier

userId

L’identifiant unique de l’utilisateur.

Obligatoire

assignedCreditInCurrencyBaseUnit

Le montant à récompenser (p. ex., 50).

Conditionnel (Non requis si une valeur par défaut globale est définie)

rewardUnit

L’unité de la récompense (p. ex., USD, POINTS).

Conditionnel (Non requis si une valeur par défaut globale est définie)

globalRewardKey

La clé d’une récompense préconfigurée à attribuer.

Conditionnel (Non requis si une valeur par défaut globale est définie)

discountPercent

Le montant à récompenser sous forme de remise

Conditionnel (Non requis si une valeur par défaut globale est définie)

dateScheduledFor

Mettre la récompense en attente jusqu’à cette date.

Facultatif

uniqueId

Un identifiant unique pour la transaction.

Recommandé Utilisé comme clé de sécurité pour éviter les récompenses en double si le fichier est relancé.

customerNote

Ajoutez une note visible par le client.

Facultatif

internalNote

Ajoutez une note à usage interne que le client ne pourra pas voir.

Facultatif

1

Configurer les paramètres d’importation

  1. Dans le menu de navigation de gauche, sélectionnez [Engage] → Rapports → Importations et exportations.

  2. Dans le coin supérieur droit, sélectionnez Importer.

  3. Sous Type d’importation, sélectionnez Récompenses.

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é manuelle (p. ex., « Cash/USD »).

  • Programme: Associez ces récompenses à un programme spécifique à des fins de reporting.

  • Durée d'attente de la récompense: [Activer] : 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 rétractions si nécessaire.

Remarque: Si vous définissez une valeur ici (p. ex., Unité de récompense : USD), vous n’avez pas pas besoin d’inclure cette colonne dans votre fichier CSV.

2

Téléversement et exécution à blanc

Comme les récompenses en espèces sont définitives et ne peuvent pas être annulées, le système exige une exécution à blanc (importation 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’importation test pour lancer l’état de test.

  3. Le système traitera le fichier sans et créera les récompenses.

3

Réviser et finaliser

Une fois l’exécution test terminée, vous verrez une entrée de statut dans la liste Importations et exportations. 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 [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 [Case à cocher]), sélectionnez Lancer l’importation.

  3. Une fenêtre modale de confirmation apparaîtra, résumant l’impact total (p. 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 Ignorer pour supprimer l’exécution test.

PrécédentOptions de récompense du programme expliquées
SuivantRécompenses par carte cadeau expliquées

Mis à jour

Ce contenu vous a-t-il été utile ?