# Crear recompensas en efectivo masivas con Advocate

Si bien muchas recompensas se activan automáticamente por las 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 tendría que 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 requeridas**: Su archivo debe incluir como mínimo `userId` para identificar al usuario.
* **Columnas opcionales**: Puede incluir los detalles de la recompensa (p. ej., importe, unidad, tipo) en el archivo. Como alternativa, recomendamos establecer estos 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>El importe que se va a recompensar (p. ej., 50).</td><td>Condicional<br>(No es necesario si se establece un valor predeterminado global)</td></tr><tr><td><code>rewardUnit</code></td><td>La unidad de la recompensa (p. ej., USD, POINTS).</td><td>Condicional<br>(No es necesario si se establece un valor predeterminado global)</td></tr><tr><td><code>globalRewardKey</code></td><td>La clave de una recompensa preconfigurada que se va a otorgar.</td><td><p>Condicional<br>(No es necesario si se establece un valor predeterminado global)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>El importe que se va a recompensar como descuento</td><td>Condicional<br>(No es necesario si se establece un valor predeterminado global)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Posponer 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 el archivo se vuelve a ejecutar.</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 los ajustes de importación

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

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

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

Para ahorrar tiempo y reducir errores en su archivo CSV, puede definir valores preestablecidos que se aplicarán 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 para fines de informes.
* **Duración de recompensa pendiente**: ![](/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

Dado que 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. Debajo de *Cargue su archivo CSV o JSONL de usuarios de importación* seleccione **Elegir archivo**.
2. Selecciona **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/dd86157d4d7fcb00be1a9d6c83be099928d0d94c" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar y finalizar

Una vez que finalice 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 e intentarlo de nuevo. 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 para la revisión.
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, simplemente puede cancelar la ejecución y luego seleccionar Descartar 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: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.
