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

# Crea recompensas en efectivo masivas con Advocate

Aunque muchas recompensas se activan automáticamente por reglas del programa (como una conversión de referido), a veces puede ser necesario recompensar a los participantes por acciones manuales o fuera de línea, como completar una encuesta o ganar un concurso.

El **Recompensas masivas** La herramienta de importación le permite emitir efectivo, puntos o tarjetas de regalo a varios defensores a la vez mediante la carga de un archivo CSV. Esta función incluye un mecanismo de seguridad de ejecución de prueba para garantizar que sus datos sean correctos antes de desembolsar cualquier fondo.

### Prepare su archivo de importación

{% hint style="success" %}
**Nota**: Si utiliza la configuración global de importación, solo necesitaría enviar una `userId` lista.
{% endhint %}

Para comenzar, necesitará un archivo CSV o JSONL que contenga la lista de usuarios a los que desea recompensar.

* **Columnas obligatorias**: Su archivo debe incluir como mínimo `userId` para identificar al usuario.
* **Columnas opcionales**: Puede incluir detalles de la recompensa (por ejemplo, importe, unidad, tipo) en el archivo. Como alternativa, recomendamos configurarlos como *valores predeterminados globales* en la plataforma durante el proceso de importación para simplificar su archivo.

#### Referencia de columnas del archivo

<table data-header-hidden><thead><tr><th width="297.484375">Columna</th><th>Descripción</th><th>Requisito</th></tr></thead><tbody><tr><td><code>userId</code></td><td>El ID único del usuario.</td><td><mark style="color:$danger;">Obligatorio</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>La cantidad que se va a recompensar (por ejemplo, 50).</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>rewardUnit</code></td><td>La unidad de la recompensa (por ejemplo, USD, POINTS).</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>globalRewardKey</code></td><td>La clave de una recompensa preconfigurada que se entregará.</td><td><p>Condicional<br>(No requerido si se establece un valor predeterminado global)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>El importe que se recompensará como descuento</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Ponga en espera la recompensa hasta esta fecha.</td><td>Opcional</td></tr><tr><td><code>uniqueId</code></td><td>Un identificador único para la transacción.</td><td><mark style="color:$success;">Recomendado</mark><br>Se utiliza como clave de seguridad para evitar recompensas duplicadas si se vuelve a ejecutar el archivo.</td></tr><tr><td><code>customerNote</code></td><td>Añada una nota que será visible para el cliente.</td><td>Opcional</td></tr><tr><td><code>internalNote</code></td><td>Añada una nota para uso interno que el cliente no podrá ver.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configurar ajustes de importación

1. En el menú de navegación izquierdo, selecciona ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage] → Informes → Importaciones y exportaciones**.
2. En la esquina superior derecha, seleccione **Importar**.
3. En *Tipo de importación*, seleccione **Recompensas**.

<div data-with-frame="true"><figure><img src="/files/61a3385c389647d46bc022eda113a6a94aa6b5c5" alt=""><figcaption></figcaption></figure></div>

**Establecer valores predefinidos (valores predeterminados globales)**

Para ahorrar tiempo y reducir errores en su archivo CSV, puede definir valores predefinidos que se apliquen a cada fila de su importación.

* **Recompensa**: Elija una recompensa preconfigurada o especifique una unidad manual (por ejemplo, "Efectivo/USD").
* **Programa**: Asocie estas recompensas con un programa específico a efectos de informes.
* **Duración de espera de la recompensa**: ![](/files/56e1fcd9ba564ade1200e6210703a468dfffe350) **\[Activar]** para añadir un margen de seguridad (por ejemplo, 30 días) antes de que la recompensa esté disponible para el usuario. Esto permite tiempo para retractaciones si es necesario.

{% hint style="success" %}
**Nota**: Si establece un valor aquí (por ejemplo, Unidad de recompensa: USD), no **no** necesita incluir esa columna en su archivo CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Cargar y ejecutar prueba

Como las recompensas en efectivo son definitivas y no se pueden revertir, el sistema requiere una ejecución de prueba (importación de prueba) para que pueda revisar con confianza los detalles antes de procesar las recompensas.

1. Bajo la *Cargue su archivo CSV o JSONL de usuarios para importación* seleccione **Elegir archivo**.
2. Seleccione **Ejecutar importación de prueba** para iniciar el estado de prueba.
3. El sistema procesará el archivo **sin** creando recompensas.

<div data-with-frame="true"><figure><img src="/files/d8599553f403959943a8e5f4e09b9bb777a8ae56" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar y finalizar

Una vez completada la ejecución de prueba, verá una entrada de estado en la lista de Importaciones y exportaciones. Es posible que se envíen correos electrónicos como parte del proceso de revisión (tarjetas de regalo, configuración de pagos, etc.).

1. **Revisar**: Si hay errores (indicados con ![](/files/362403424cd7d7aa73e9547471dd79c695eea00a) **\[Exclamación]**), seleccione **Descargar informe de errores** para corregir su archivo y volver a intentarlo. Además, seleccione **Descargar informe** para obtener un registro de todas las recompensas que se crearán. Tanto si hay un error como si no, se recomienda revisarlo.
2. **Confirmar**: Si la prueba es exitosa (indicada con un ![](/files/c0e6881bcd07073a36e9b558b14cb4222f9bfbae) **\[Marca de verificación]**), seleccione **Ejecutar importación**.
3. Aparecerá un modal de confirmación que resumirá el impacto total (por ejemplo, "Al ejecutar esta importación se crearán 412 recompensas"). Seleccione **Ejecutar importación** para confirmar y desembolsar las recompensas.

Si decide no continuar, puede simplemente cancelar la ejecución y luego seleccionar Descarta para eliminar la ejecución de prueba.

<div data-with-frame="true"><figure><img src="/files/0321764174195a3564d21df62211b73d521c5513" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-bulk-cash-rewards-with-advocate.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
