For the complete documentation index, see llms.txt. This page is also available as Markdown.

Crea ricompense in denaro in blocco con Advocate

Sebbene molti premi siano attivati automaticamente dalle regole del programma (come una conversione da referral), a volte potresti dover premiare i partecipanti per azioni manuali o offline, come completare un sondaggio o vincere un concorso.

La Premi in blocco lo strumento di importazione consente di assegnare denaro, punti o gift card a più advocate contemporaneamente caricando un file CSV. Questa funzionalità include un meccanismo di sicurezza di esecuzione di prova per assicurare che i dati siano corretti prima che vengano erogati eventuali fondi.

Prepara il tuo file di importazione

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

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

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

Riferimento alle colonne del file

userId

L'ID univoco dell'utente.

Obbligatorio

assignedCreditInCurrencyBaseUnit

L'importo da premiare (ad es. 50).

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

rewardUnit

L'unità del premio (ad es. USD, POINTS).

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

globalRewardKey

La chiave di un premio preconfigurato da assegnare.

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

discountPercent

L'importo da premiare come sconto

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

dateScheduledFor

Metti in attesa il premio fino a questa data.

Opzionale

uniqueId

Un identificatore univoco per la transazione.

Consigliato Usato come chiave di sicurezza per evitare premi duplicati se il file viene rieseguito.

customerNote

Aggiungi una nota visibile al cliente.

Opzionale

internalNote

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

Opzionale

1

Configura le impostazioni di importazione

  1. Nel menu di navigazione a sinistra, seleziona [Engage] → Reportistica → Importazioni ed esportazioni.

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

  3. Sotto Tipo di importazione, seleziona sezione Premi.

Imposta valori predefiniti (valori globali)

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

  • Ricompensa: Scegli un premio preconfigurato oppure specifica un'unità manuale (ad es. "Contanti/USD").

  • Programma: Associa questi premi a un programma specifico a fini di reportistica.

  • Durata del premio in attesa: [Attiva] per aggiungere un margine di sicurezza (ad es. 30 giorni) prima che il premio sia disponibile per l'utente. Ciò consente tempo per eventuali revoche, se necessario.

2

Carica ed esegui la prova

Poiché i premi in denaro sono definitivi e non possono essere annullati, il sistema richiede un'esecuzione di prova (importazione di test) così puoi rivedere con sicurezza i dettagli prima di elaborare i premi.

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

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

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

3

Rivedi e finalizza

Una volta completata l'esecuzione di test, vedrai una voce di stato nell'elenco Importazioni ed esportazioni. Le email potrebbero essere inviate come parte del processo di revisione (gift card, configurazione dei pagamenti, ecc.).

  1. Rivedi: Se ci sono errori (indicati con [Exclaimation]), seleziona Scarica il report degli errori per correggere il file e riprovare. Inoltre, seleziona Scarica report per ottenere un registro di tutti i premi che verranno creati. Che ci sia un errore o meno, è consigliato per la revisione.

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

  3. Apparirà una finestra di conferma che riepiloga l'impatto totale (ad es. "Eseguendo questa importazione verranno creati 412 premi"). Seleziona Esegui importazione per confermare e distribuire i premi.

Se decidi di non procedere, puoi semplicemente annullare l'esecuzione e poi selezionare Scarta per eliminare l'esecuzione di test.

Ultimo aggiornamento

È stato utile?