search
Developer DocsContact SupportLog In

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

Alors que de nombreuses récompenses sont déclenchées automatiquement par les règles du programme (comme une conversion par parrainage), vous pouvez parfois devoir récompenser des participants pour des actions manuelles ou hors ligne — comme remplir un sondage ou gagner un concours.

Le outil d'importation de récompenses en masse vous permet d'émettre de l'argent, des points ou des cartes-cadeaux à plusieurs ambassadeurs en une seule fois en téléchargeant un fichier CSV. Cette fonctionnalité inclut un mécanisme de simulation (dry run) pour vérifier que vos données sont correctes avant toute distribution de fonds.

hashtag
Préparez votre fichier d'import

circle-check

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

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 liste userId pour identifier l'utilisateur.

  • Colonnes optionnelles : Vous pouvez inclure les détails de la récompense (p. ex., montant, unité, type) dans le fichier. Alternativement, nous recommandons de définir ces éléments comme valeurs globales par défaut dans la plateforme lors du processus d'importation pour simplifier votre fichier.

hashtag
Référence des colonnes du fichier

liste userId

L'identifiant unique de l'utilisateur.

Requis

assignedCreditInCurrencyBaseUnit

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

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

rewardUnit

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

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

globalRewardKey

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

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

discountPercent

Le montant à récompenser sous forme de remise

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

dateScheduledFor

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

Optionnel

uniqueId

Un identifiant unique pour la transaction.

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

customerNote

Ajouter une note qui sera visible par le client.

Optionnel

internalNote

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

Optionnel

1

hashtag
Configurer les paramètres d'importation

  1. Dans le menu de navigation gauche, sélectionnez [Engage] → Reporting → Imports & Exports.

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

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

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

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 la mise en attente de la récompense: [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'annuler si nécessaire.

circle-check

Remarque : Si vous définissez une valeur ici (p. ex., Unité de récompense : USD), vous n'avez pas

2

hashtag
besoin d'inclure cette colonne dans votre fichier CSV.

Téléversement et simulation

  1. Parce que les récompenses en argent sont définitives et ne peuvent pas être annulées, le système exige une simulation (importation test) afin que vous puissiez revoir les détails en toute confiance avant de traiter les récompenses. Sous le Téléversez votre fichier CSV ou JSONL d'utilisateurs à importer sélectionnez.

  2. Choisir le fichier Sélectionnez Exécuter l'importation de test

  3. pour lancer l'état de test. Le système traitera le fichier sans

3

hashtag
créer de récompenses.

Réviser et finaliser

  1. Une fois la simulation terminée, vous verrez une entrée de statut dans la liste Imports & Exports. Des e-mails peuvent être envoyés dans le cadre du processus de revue (cartes-cadeaux, configuration des paiements, etc.).Revue : S'il y a des erreurs (indiquées par[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

  2. 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.Confirmer : Si le test est concluant (indiqué par une[Point d'exclamation] [Coche].

  3. Lancer l'importation [Coche] Une fenêtre de confirmation apparaîtra résumant l'impact total (p. ex., « En exécutant cette importation, 412 récompenses seront créées"). Sélectionnez

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 Supprimer pour supprimer la simulation.

PrécédentExplication des options de récompense du programmeSuivantExplication des récompenses par carte-cadeau

Mis à jour

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