> 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/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-bulk-cash-rewards-with-advocate.md).

# Crea ricompense in contanti in blocco con Advocate

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

Il **Premi in blocco** lo strumento di importazione ti consente di erogare contanti, punti o carte regalo a più partecipanti contemporaneamente caricando un file CSV. Questa funzionalità include un meccanismo di sicurezza di esecuzione di prova per garantire che i tuoi dati siano corretti prima che vengano erogati fondi.

### Prepara il file di importazione

{% hint style="success" %}
**Nota**: Se utilizzi le impostazioni globali di importazione, ti basterà inviare una `userId` lista.
{% endhint %}

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 `userId` per identificare l'utente.
* **Colonne facoltative**: Puoi includere nel file i dettagli del premio (ad es. importo, unità, tipo). In alternativa, ti consigliamo di impostarli come *valori predefiniti globali* nella piattaforma durante il processo di importazione per semplificare il file.

#### Riferimento delle colonne del file

<table data-header-hidden><thead><tr><th width="297.484375">Colonna</th><th>Descrizione</th><th>Requisito</th></tr></thead><tbody><tr><td><code>userId</code></td><td>L'ID univoco dell'utente.</td><td><mark style="color:$danger;">Obbligatorio</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>L'importo da premiare (ad es. 50).</td><td>Condizionale<br>(Non richiesto se è impostato un valore predefinito globale)</td></tr><tr><td><code>rewardUnit</code></td><td>L'unità del premio (ad es. USD, POINTS).</td><td>Condizionale<br>(Non richiesto se è impostato un valore predefinito globale)</td></tr><tr><td><code>globalRewardKey</code></td><td>La chiave di un premio preconfigurato da assegnare.</td><td><p>Condizionale<br>(Non richiesto se è impostato un valore predefinito globale)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>L'importo da premiare come sconto</td><td>Condizionale<br>(Non richiesto se è impostato un valore predefinito globale)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Sospendi il premio fino a questa data.</td><td>Facoltativo</td></tr><tr><td><code>uniqueId</code></td><td>Un identificatore univoco per la transazione.</td><td><mark style="color:$success;">Consigliato</mark><br>Usato come chiave di sicurezza per impedire premi duplicati se il file viene rieseguito.</td></tr><tr><td><code>customerNote</code></td><td>Aggiungi una nota che sarà visibile al cliente.</td><td>Facoltativo</td></tr><tr><td><code>internalNote</code></td><td>Aggiungi una nota per uso interno che il cliente non potrà vedere.</td><td>Facoltativo</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configura le impostazioni di importazione

1. Nel menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Reportistica → Importazioni ed esportazioni**.
2. Nell'angolo in alto a destra, seleziona **Importazione**.
3. In *Tipo di importazione*, seleziona **sezione Ricompense**.

<div data-with-frame="true"><figure><img src="https://1043985218-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>

**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 della tua importazione.

* **Premio**: Scegli un premio preconfigurato oppure specifica un'unità manuale (ad es. "Contanti/USD").
* **Programma**: Associa questi premi a un programma specifico per fini di reportistica.
* **Durata del periodo di sospensione della ricompensa**: ![](https://1043985218-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) **\[Attiva]** per aggiungere un margine di sicurezza (ad es. 30 giorni) prima che il premio sia disponibile per l'utente. Questo consente tempo per eventuali revoche, se necessario.

{% hint style="success" %}
**Nota**: Se imposti qui un valore (ad es. Unità del premio: USD), non **non** devi includere quella colonna nel tuo file CSV.
{% endhint %}
{% endstep %}

{% step %}

#### 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) in modo che tu possa rivedere con sicurezza i dettagli prima di elaborare i premi.

1. Sotto il *Carica il file CSV o JSONL degli utenti da importare* seleziona **Scegli file**.
2. Seleziona **Esegui importazione di prova** per avviare lo stato di test.
3. Il sistema elaborerà il file **senza** creando premi.

<div data-with-frame="true"><figure><img src="https://1043985218-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 %}

#### Rivedi e finalizza

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

1. **Rivedi**: Se ci sono errori (indicati con ![](https://1043985218-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) **\[Exclaimation]**), seleziona **Scarica il rapporto degli errori** per correggere il file e riprovare. Inoltre, seleziona **Scarica rapporto** 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 ![](https://1043985218-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) **\[Segno di spunta]**), seleziona **Avvia importazione**.
3. Apparirà una finestra di conferma che riassume l'impatto totale (ad es. “Eseguendo questa importazione verranno creati 412 premi”). Seleziona **Avvia importazione** per confermare ed erogare i premi.

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

<div data-with-frame="true"><figure><img src="https://1043985218-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/it/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.