search
Developer DocsContact SupportLog In

Crea ricompense in contanti in blocco con Advocate

Mentre molte ricompense vengono attivate automaticamente dalle regole del programma (come una conversione per referral), a volte potrebbe essere necessario premiare i partecipanti per azioni manuali o offline—come completare un sondaggio o vincere un concorso.

Lo strumento di importazione di Ricompense Collettive ti consente di emettere contanti, punti o buoni regalo a più sostenitori contemporaneamente caricando un file CSV. Questa funzione include un meccanismo di verifica (dry run) per garantire che i tuoi dati siano corretti prima che vengano erogati fondi.

hashtag
Prepara il tuo file di importazione

circle-check

Nota: Se utilizzi le impostazioni globali di importazione, allora dovrai inviare solo una lista userId .

Per iniziare, avrai bisogno di un file CSV o JSONL contenente l'elenco degli utenti che desideri premiare.

  • Colonne richieste: Il tuo file deve includere almeno lista userId per identificare l'utente.

  • Colonne opzionali: Puoi includere i dettagli della ricompensa (ad es., importo, unità, tipo) nel file. In alternativa, consigliamo di impostarli come valori predefiniti globali nella piattaforma durante il processo di importazione per semplificare il file.

hashtag
Riferimento colonne del file

lista userId

L'ID unico dell'utente.

Richiesto

assignedCreditInCurrencyBaseUnit

L'importo da assegnare (ad es., 50).

Condizionale (Non richiesto se è impostato un valore predefinito globale)

rewardUnit

L'unità della ricompensa (ad es., USD, POINTS).

Condizionale (Non richiesto se è impostato un valore predefinito globale)

globalRewardKey

La chiave di una ricompensa preconfigurata da assegnare.

Condizionale (Non richiesto se è impostato un valore predefinito globale)

discountPercent

L'importo da assegnare come sconto

Condizionale (Non richiesto se è impostato un valore predefinito globale)

dateScheduledFor

Metti in sospeso la ricompensa fino a questa data.

Opzionale

uniqueId

Un identificatore unico per la transazione.

Consigliato Utilizzato come chiave di sicurezza per evitare ricompense duplicate se il file viene rieseguito.

customerNote

Aggiungi una nota che sarà visibile al cliente.

Opzionale

internalNote

Aggiungi una nota per uso interno che il cliente non potrà vedere.

Opzionale

1

hashtag
Configura le impostazioni di importazione

  1. Nel menu di navigazione a sinistra, seleziona [Engage] → Reporting → Imports & Exports.

  2. Nell'angolo in alto a destra, seleziona Importa.

  3. Sotto Tipo di importazione, seleziona Ricompense.

hashtag
Imposta valori predefiniti (Default globali)

Per risparmiare tempo e ridurre errori nel tuo file CSV, puoi definire valori preimpostati che si applicano a ogni riga dell'importazione.

  • Ricompensa: Scegli una ricompensa preconfigurata o specifica un'unità manuale (ad es., "Contanti/USD").

  • Programma: Associa queste ricompense a uno specifico programma per finalità di reportistica.

  • Durata di attesa della ricompensa: [Attiva] per aggiungere un buffer di sicurezza (ad es., 30 giorni) prima che la ricompensa sia disponibile per l'utente. Questo dà tempo per eventuali revoche se necessario.

circle-check

Nota: Se imposti un valore qui (ad es., Unità Ricompensa: USD), non è necessario includere quella colonna nel tuo file CSV.

2

hashtag
Caricamento e Dry Run

Poiché le ricompense in denaro sono definitive e non possono essere annullate, il sistema richiede un dry run (importazione di prova) in modo che tu possa rivedere con fiducia i dettagli prima di elaborare le ricompense.

  1. Sotto Carica il tuo file CSV o JSONL con gli utenti da importare seleziona Scegli file.

  2. Seleziona Esegui importazione di prova per avviare lo stato di prova.

  3. Il sistema elaborerà il file senza creare ricompense.

3

hashtag
Revisiona e finalizza

Una volta completata l'esecuzione di prova, vedrai una voce di stato nell'elenco Imports & Exports. Potrebbero essere inviate email come parte del processo di revisione (buoni regalo, configurazione dei pagamenti, ecc.).

  1. Revisiona: Se ci sono errori (indicate con [Punto esclamativo]), seleziona Scarica rapporto errori per correggere il tuo file e riprovare. Inoltre, seleziona Scarica rapporto per ottenere un registro di tutte le ricompense che verranno create. Che ci sia un errore o meno, è consigliato per la revisione.

  2. Conferma: Se il test ha esito positivo (indicato con un [Segno di spunta]), seleziona Esegui importazione.

  3. Apparirà una finestra di conferma che riepiloga l'impatto totale (ad es., “Eseguendo questa importazione verranno create 412 ricompense"). Seleziona Esegui importazione per confermare ed erogare le ricompense.

Se decidi di non procedere, puoi semplicemente annullare l'esecuzione e poi selezionare Elimina per cancellare l'esecuzione di prova.

PrecedenteSpiegazione delle opzioni di ricompensa del programmaSuccessivoSpiegazione delle carte regalo come ricompensa

Ultimo aggiornamento

È stato utile?