> 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-reporting-and-analytics/advocate-program-reports-explained.md).

# Explicación de los informes del programa Advocate

<a href="https://pxa.impact.com/student/activity/1687872?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Tome el curso PXA</a>

Advocate ofrece varios informes descargables para los datos de tu programa y de los participantes. Todos los informes tienen opciones de filtro para darte mayor control sobre los datos que descargas. Cada informe se puede descargar como un archivo .CSV o de Excel.

Este artículo explica los distintos informes y qué tipo de datos incluye cada uno. Consulta [Ejecutar un informe de programa de Advocate](/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) para obtener instrucciones sobre cómo generar un informe.

#### Informe de detalles del usuario

El *Detalles del usuario* el informe contiene información detallada sobre cada participante de todos tus programas. Exporta una lista de todos los participantes para mantener tus registros actualizados con los enlaces para compartir y los códigos de referido de Advocate.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluirá información del participante como:

* Nombre
* ID de usuario y de cuenta
* Dirección de correo electrónico
* Campos personalizados
* Segmentos
* Información de referido (si corresponde)

Al generar el informe, puedes incluir opcionalmente:

* **Estadísticas del usuario**, incluida información de analíticas sobre el participante, como tráfico, ingresos y más.
* **Enlaces y códigos para compartir de referido**, si corresponde. Esta información puede ser útil como parte de la actualización de los registros de contacto en tu CMS o sistema de correo electrónico para incluir los enlaces y códigos para compartir de Advocate de cada participante.

Puedes encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) del informe de detalles del usuario.

**Referencia de columnas del informe**

| Columna                                                         | Descripción                                                                                                                                                                                                                              |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del usuario**                                     |                                                                                                                                                                                                                                          |
| ID                                                              | El identificador único del participante dentro del sistema de Advocate.                                                                                                                                                                  |
| ID de cuenta                                                    | El identificador único de la cuenta del participante (usado en varios programas, si corresponde).                                                                                                                                        |
| Correo electrónico                                              | La dirección de correo electrónico del participante.                                                                                                                                                                                     |
| Nombre                                                          | El nombre del participante.                                                                                                                                                                                                              |
| Apellido                                                        | El apellido del participante.                                                                                                                                                                                                            |
| Hash del correo electrónico                                     | Una versión con hash (cifrada) del correo electrónico del participante, útil para hacer coincidencias compatibles con la privacidad con otros sistemas.                                                                                  |
| **Información de referido y de compartición**                   |                                                                                                                                                                                                                                          |
| Código de referido                                              | El código único vinculado al participante, usado para hacer seguimiento de los referidos que genere.                                                                                                                                     |
| Enlace para compartir                                           | El enlace de referido único asociado con el participante.                                                                                                                                                                                |
| Enlace para compartir en Facebook                               | Un enlace pregenerado para compartir el referido en Facebook.                                                                                                                                                                            |
| Enlace para compartir en Twitter                                | Un enlace pregenerado para compartir el referido en Twitter.                                                                                                                                                                             |
| Enlace para compartir por correo electrónico                    | Un enlace pregenerado para compartir el referido por correo electrónico.                                                                                                                                                                 |
| Enlace para compartir en LinkedIn                               | Un enlace pregenerado para compartir el referido en LinkedIn.                                                                                                                                                                            |
| Enlace limpio para compartir                                    | Una versión del enlace de referido sin parámetros de seguimiento; más neutral para ciertas plataformas o casos de uso.                                                                                                                   |
| **Geolocalización y configuración regional**                    |                                                                                                                                                                                                                                          |
| Primera IP detectada                                            | La dirección IP desde la que se registró por primera vez al participante.                                                                                                                                                                |
| Última IP detectada                                             | La dirección IP más reciente registrada para este participante.                                                                                                                                                                          |
| Configuración regional                                          | El idioma preferido y la configuración regional del participante (por ejemplo, en-US).                                                                                                                                                   |
| Código de país                                                  | El país del participante según la configuración regional o la dirección IP (por ejemplo, ZA, US).                                                                                                                                        |
| **Marcas de tiempo**                                            |                                                                                                                                                                                                                                          |
| Fecha de creación                                               | La fecha y hora en que se creó la cuenta del participante en Advocate.                                                                                                                                                                   |
| Fecha de envío del formulario fiscal de EE. UU.                 | (Si corresponde) La fecha en que se envió un formulario fiscal de EE. UU. para cumplimiento o procesamiento de recompensas.                                                                                                              |
| **Estadísticas del usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                                          |
| stats.date Modificada                                           | La última fecha en que se actualizaron las estadísticas del participante.                                                                                                                                                                |
| stats.tráfico                                                   | Número total de visitas generadas por la actividad de referido del participante.                                                                                                                                                         |
| stats.referidos                                                 | Número total de referidos exitosos realizados por el participante.                                                                                                                                                                       |
| stats.conversiones                                              | Número total de conversiones (por ejemplo, compras o registros) que resultaron de esos referidos.                                                                                                                                        |
| stats.objetivos                                                 | Número de cumplimientos de objetivos específicos asociados con la actividad de referido del participante (definidos de forma personalizada en el programa).                                                                              |
| stats.recompensas                                               | Número total de recompensas que ha obtenido el participante.                                                                                                                                                                             |
| stats.cargas del widget                                         | Número de veces que el widget de referido o la interfaz para compartir fue cargada por este participante.                                                                                                                                |
| stats.ingresos                                                  | Ingresos totales generados por los usuarios que fueron referidos por este participante.                                                                                                                                                  |
| stats.ingresos generados                                        | Sinónimo de stats.revenue; algunos informes pueden diferenciar si los ingresos provienen de múltiples fuentes.                                                                                                                           |
| stats.ingresos referidos                                        | Ingresos atribuidos específicamente a los participantes que se registraron o compraron a través del enlace de referido de este participante.                                                                                             |
| **Datos personalizados**                                        |                                                                                                                                                                                                                                          |
| custom Fields.ejemplo                                           | Un marcador de posición para cualquier campo personalizado definido por tu programa (por ejemplo, *ID de fidelidad*, *notas internas*, *etiqueta de región*). Cada campo aparecerá como su propia columna, con el prefijo custom Fields. |
| **Otros**                                                       |                                                                                                                                                                                                                                          |
| Origen del referido                                             | La fuente o canal original que llevó al participante a tu programa (por ejemplo, *orgánico*, *correo electrónico*, *sitio de socio*).                                                                                                    |

</details>

#### Exportación de eventos de usuario

El *Exportación de evento de usuario* el informe proporciona un registro de todos los eventos de usuario que hemos recibido de tu organización para tu programa de Advocate. Puedes aplicar filtros para reducir un rango de tiempo, la clave del evento, el ID de usuario y más.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* ID del evento
* Clave del evento
* ID de usuario y de cuenta
* Fecha de activación
* Fecha de recepción
* Fecha de procesamiento

**Referencia de columnas del informe**

| Columna                                                                         | Descripción                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del evento y del usuario**                                        |                                                                                                                                                                                                               |
| ID del evento                                                                   | Un ID único generado para cada evento recibido. Útil para hacer seguimiento, depurar o auditar el envío de eventos.                                                                                           |
| Clave del evento                                                                | El tipo o la etiqueta del evento, como `compra`, `registro`, o cualquier clave definida de forma personalizada que envíe tu sistema.                                                                          |
| ID de usuario                                                                   | El identificador único del participante en Advocate al que está asociado el evento.                                                                                                                           |
| ID de cuenta                                                                    | El ID de cuenta vinculado al usuario, especialmente relevante en programas donde los usuarios pueden pertenecer a diferentes estructuras de cuenta.                                                           |
| **Marcas de tiempo del evento**                                                 |                                                                                                                                                                                                               |
| Fecha de activación del evento – YYYY-MM-DD                                     | La fecha en que realmente ocurrió el evento (según lo informado por tu sistema). Por ejemplo, la fecha en que tuvo lugar una compra o un registro.                                                            |
| Fecha de recepción del evento – YYYY-MM-DD                                      | La fecha en que Advocate recibió el evento de tu sistema. Puede diferir de la fecha de activación debido a procesamiento por lotes o retrasos del sistema.                                                    |
| Fecha de procesamiento del evento – YYYY-MM-DD                                  | La fecha en que el evento se procesó y almacenó correctamente en Advocate. Indica cuándo el evento pasó a estar disponible para seguimiento, recompensas o informes.                                          |
| **Campos de datos del evento (si se incluyen en tus cargas útiles del evento)** |                                                                                                                                                                                                               |
| fields.cupón                                                                    | Cualquier cupón o código de descuento aplicado durante el evento, si se envía en los datos del evento. Útil para hacer seguimiento del uso de incentivos o de activadores de promociones específicas.         |
| fields.ingresos                                                                 | La cantidad de ingresos asociada con el evento. Normalmente se usa en eventos de compra para calcular el rendimiento, las recompensas o el ROI.                                                               |
| fields.moneda                                                                   | El código de moneda (por ejemplo, *USD*, *ZAR*, *EUR*) vinculado al monto de ingresos. Importante al informar entre regiones o al calcular recompensas ajustadas por tipo de cambio.                          |
| fields.fecha de creación del lead                                               | La fecha original en que se creó el lead (usuario) en tu sistema, si se envía como parte del evento. Ayuda a conectar los eventos de usuario con las fechas originales de adquisición o los registros de CRM. |

</details>

#### Historial de recompensas

El *Historial de recompensas* el informe proporciona un registro detallado de cada una de tus recompensas y de las relaciones con los participantes y los referidos. Esta información puede ser útil para crear balances, así como para obtener el estado de todas tus recompensas en un momento dado.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluirá **campos de recompensa** información como:

* ID de la recompensa
* Tipo de recompensa
* Valor de la recompensa

Puedes encontrar una lista completa de los campos incluidos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) o [JSONL de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) de los informes de detalles de recompensa.

Al generar el informe, puedes incluir opcionalmente:

* **Detalles del participante** como nombre, ID de usuario y de cuenta, dirección de correo electrónico, campos personalizados, segmentos e información de referido (si corresponde).
* **Campos de referido** como ID de referido, campos del defensor del cliente, campos del amigo referido y más.

**Referencia de columnas del informe**

| Columna                                                                                                            | Descripción                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información de la recompensa**                                                                                   |                                                                                                                                                                                                     |
| ID                                                                                                                 | ID único de la instancia de la recompensa (generado por Advocate).                                                                                                                                  |
| Tipo                                                                                                               | La categoría o el tipo de recompensa (por ejemplo, *Efectivo*, *Tarjeta regalo*, *Cupón*, *Personalizado*).                                                                                         |
| Valor                                                                                                              | El valor numérico de la recompensa (por ejemplo, 10, 100, etc.).                                                                                                                                    |
| Unidad                                                                                                             | La unidad asociada con el valor (por ejemplo, *USD*, *puntos*, *ZAR*, *%*).                                                                                                                         |
| Nombre                                                                                                             | Nombre para mostrar de la recompensa (según lo definido en la [configuración de la recompensa](/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Origen de la recompensa                                                                                            | Describe qué activó la recompensa (por ejemplo, *Referido*, *Objetivo*, *Manual*, *API*).                                                                                                           |
| Tipo de Fuel Tank                                                                                                  | El tipo de fondo de recompensa utilizado (si se usa la integración con FuelTank). Por ejemplo, *Prepago*, *Tarjeta regalo*.                                                                         |
| Código de Fuel Tank                                                                                                | El código asociado con el cumplimiento externo (por ejemplo, un cupón o un código de tarjeta regalo).                                                                                               |
| ID del programa                                                                                                    | ID del programa de Advocate bajo el cual se emitió la recompensa.                                                                                                                                   |
| Clave de recompensa del programa                                                                                   | Identificador interno de la configuración específica de recompensa usada dentro del programa.                                                                                                       |
| Clave de recompensa global                                                                                         | Identificador entre programas para recompensas configuradas a nivel global (si corresponde).                                                                                                        |
| **Marcas de tiempo de la recompensa**                                                                              |                                                                                                                                                                                                     |
| Fecha de creación                                                                                                  | Cuándo se creó el registro de la recompensa en el sistema.                                                                                                                                          |
| Fecha programada para                                                                                              | Cuándo se programó la emisión de la recompensa (por ejemplo, después de un retraso o periodo de espera).                                                                                            |
| Fecha otorgada                                                                                                     | Cuándo se emitió realmente la recompensa al participante.                                                                                                                                           |
| Fecha de caducidad                                                                                                 | La fecha de vencimiento de la recompensa (si corresponde).                                                                                                                                          |
| Fecha de cancelación                                                                                               | La fecha en que la recompensa se anuló o canceló.                                                                                                                                                   |
| Fecha canjeada                                                                                                     | La fecha en que el participante canjeó la recompensa (si corresponde).                                                                                                                              |
| Fecha de modificación                                                                                              | La fecha en que se realizó la actualización más reciente del registro de la recompensa.                                                                                                             |
| **Seguimiento de crédito y valor**                                                                                 |                                                                                                                                                                                                     |
| Crédito asignado                                                                                                   | La cantidad de crédito asignada a esta recompensa (puede diferir del valor en algunos modelos).                                                                                                     |
| Crédito canjeado                                                                                                   | La cantidad de crédito que se ha canjeado de la recompensa.                                                                                                                                         |
| Valor disponible                                                                                                   | La parte restante de la recompensa que no se ha usado ni canjeado.                                                                                                                                  |
| **Estado y mensajería de la recompensa**                                                                           |                                                                                                                                                                                                     |
| Estados                                                                                                            | Estado actual de la recompensa (por ejemplo, *Pendiente*, *Programada*, *Otorgada*, *Caducado*, *Cancelado*).                                                                                       |
| meta.estado                                                                                                        | Estado técnico o del sistema (útil para diagnósticos o manejo de errores).                                                                                                                          |
| meta.mensaje                                                                                                       | Mensaje vinculado a la entrega de la recompensa (por ejemplo, “Recompensa entregada correctamente”).                                                                                                |
| meta.mensaje interno                                                                                               | Notas solo para administradores (por ejemplo, explicaciones de fallos o indicadores).                                                                                                               |
| meta.fecha modificada                                                                                              | La última vez que se actualizaron los metadatos relacionados con la recompensa.                                                                                                                     |
| meta.customMeta.testMeta                                                                                           | Un marcador de posición para cualquier campo de metadatos personalizados que envíe tu programa (en este caso, testMeta es un ejemplo).                                                              |
| **Información del participante (usuario)**                                                                         |                                                                                                                                                                                                     |
| user.id                                                                                                            | ID del usuario que recibe la recompensa.                                                                                                                                                            |
| user.account Id                                                                                                    | El ID de cuenta asociado del usuario en Advocate.                                                                                                                                                   |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Información básica del participante incluida como referencia o para hacer coincidencias con el CRM.                                                                                                 |
| **Contexto del referido (si la recompensa se basa en referidos)**                                                  |                                                                                                                                                                                                     |
| referral.id                                                                                                        | El ID del referido que activó esta recompensa.                                                                                                                                                      |
| referral.date Referral Started                                                                                     | Cuándo comenzó la acción de referido (por ejemplo, clic o evento de compartir).                                                                                                                     |
| referral.date Modificada                                                                                           | Cuándo se actualizó por última vez el registro de referido.                                                                                                                                         |
| referral.referral Code Used                                                                                        | El código que usó el usuario referido para registrarse o realizar una acción.                                                                                                                       |
| **Información del usuario referido (amigo)**                                                                       |                                                                                                                                                                                                     |
| referral.referred User.id                                                                                          | ID de la persona que fue referida (el “amigo”).                                                                                                                                                     |
| referral.referred User.account Id                                                                                  | El ID de cuenta único del referido.                                                                                                                                                                 |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Los datos de contacto básicos del referido.                                                                                                                                                         |
| **Información del referente (defensor de cliente)**                                                                |                                                                                                                                                                                                     |
| referral.referrer User.id                                                                                          | ID de la persona que hizo la referencia (el “defensor”).                                                                                                                                            |
| referral.referrer User.account Id                                                                                  | El ID de cuenta único del referido.                                                                                                                                                                 |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Los datos de contacto básicos del referido.                                                                                                                                                         |
| referral.date Converted                                                                                            | La fecha en que el referido se convirtió oficialmente (por ejemplo, completó el registro o la compra), activando la recompensa.                                                                     |

</details>

#### Historial de referidos

El *Historial de referidos* el informe proporciona un registro del estado de cada conexión de referido realizada en tu programa de referidos. Esta información puede ser útil para comprobar el éxito de tu programa y hacer seguimiento de la cantidad de nuevos clientes que ha aportado tu programa.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del amigo referido como nombre, ID de usuario y de cuenta, dirección de correo electrónico y más
* Detalles del defensor del cliente como nombre, ID de usuario y de cuenta, dirección de correo electrónico y más
* Estado del referido
* Estado de moderación
* IDs de recompensa

Puedes encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) informe de actividad de referidos.

**Referencia de columnas del informe**

| Columna                                                                                                                 | Descripción                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadatos del referido**                                                                                              |                                                                                                                                       |
| ID                                                                                                                      | Identificador único del registro de referido en Advocate.                                                                             |
| Fecha de modificación                                                                                                   | La fecha más reciente en la que se actualizó cualquier parte del registro de referido.                                                |
| Fecha de inicio del referido                                                                                            | Cuándo se inició por primera vez el referido (por ejemplo, cuando el usuario referido hizo clic en un enlace de referido).            |
| Fecha de conversión                                                                                                     | Cuándo se convirtió el referido, normalmente cuando el usuario referido completó la acción requerida (como un registro o una compra). |
| Fecha de modificación del usuario                                                                                       | La última vez que se actualizaron los datos del usuario involucrados en este referido (referente o referido).                         |
| ID del programa                                                                                                         | El ID del programa de referidos de Advocate al que pertenece este referido.                                                           |
| Nombre del programa                                                                                                     | El nombre del programa de referidos, útil si gestionas varios programas.                                                              |
| **Información del amigo referido (nuevo cliente)**                                                                      |                                                                                                                                       |
| <p>Correo electrónico del usuario referido</p><p>Nombre del usuario referido</p><p>Apellido del usuario referido</p>    | Información básica de identidad del usuario referido.                                                                                 |
| Código de referido del usuario referido                                                                                 | El código de referido asignado al usuario referido (en caso de que luego también pueda referir a otras personas).                     |
| <p>Primera IP detectada del usuario referido</p><p>Última IP detectada del usuario referido</p>                         | Direcciones IP registradas en la primera y más reciente actividad del usuario referido.                                               |
| URL de la imagen del usuario referido                                                                                   | La URL de la imagen o avatar, si se capturó o asignó al usuario referido.                                                             |
| Configuración regional del usuario referido                                                                             | Configuración de idioma/región (por ejemplo, *en-US*, *fr-FR*) del usuario referido.                                                  |
| Fecha de creación del usuario referido                                                                                  | La fecha en que se creó la cuenta del usuario referido en Advocate.                                                                   |
| Usuario referido                                                                                                        | ID interno del usuario referido en el sistema de Advocate.                                                                            |
| Cuenta referida                                                                                                         | ID interno de cuenta vinculado al usuario referido (usado en programas con varias cuentas).                                           |
| **Información del referente (defensor del cliente)**                                                                    |                                                                                                                                       |
| <p>Correo electrónico del usuario referente</p><p>Nombre del usuario referente</p><p>Apellido del usuario referente</p> | Información básica de identidad del participante que refiere.                                                                         |
| Código de referido del usuario referente                                                                                | El código de referido que pertenece al referente, el código que probablemente usó el usuario referido.                                |
| <p>Primera IP detectada del usuario referente</p><p>Última IP detectada del usuario referente</p>                       | Direcciones IP registradas en la primera y más reciente actividad del referente.                                                      |
| URL de la imagen del usuario referente                                                                                  | La URL de la imagen o avatar del referente.                                                                                           |
| Configuración regional del usuario referente                                                                            | Configuración regional del referente.                                                                                                 |
| Fecha de creación del usuario referente                                                                                 | Cuando el referente se unió por primera vez o se registró en el sistema.                                                              |
| Usuario referente                                                                                                       | ID interno del referente en Advocate.                                                                                                 |
| Cuenta del referente                                                                                                    | ID de cuenta asociado con el referente.                                                                                               |
| **Moderación y estado**                                                                                                 |                                                                                                                                       |
| Estado de moderación                                                                                                    | Estado general de moderación de la referencia. (p. ej., *Aprobada*, *Rechazado*, *Pendiente*.)                                        |
| Fecha de moderación                                                                                                     | La fecha en que se tomó la decisión de moderación (aprobación/rechazo).                                                               |
| Fecha en que se pagó la referencia                                                                                      | Cuándo se pagó cualquier recompensa asociada por la referencia.                                                                       |
| Fecha de finalización de la referencia                                                                                  | Cuándo se cerró oficialmente el registro de referencia (p. ej., debido a expiración o finalización).                                  |
| Estado de moderación del referido                                                                                       | Estado de moderación específico de la parte del referido en la referencia.                                                            |
| Estado de moderación del referente                                                                                      | Estado de moderación específico de la parte del referente en la referencia.                                                           |
| **Referencias de recompensas**                                                                                          |                                                                                                                                       |
| Recompensa del referido                                                                                                 | El ID o referencia de la recompensa emitida al usuario referido (si corresponde).                                                     |
| Recompensa del referente                                                                                                | El ID o referencia de la recompensa emitida al referente (si corresponde).                                                            |

</details>

#### Saldos de recompensas por usuario

El *Saldos de recompensas por usuario* El informe proporciona un registro de las recompensas pendientes, incluido el valor y el destinatario previsto, que se generaron a través de su programa de referidos. Este informe suele utilizarse como parte del canje manual de recompensas o como parte de un proceso por lotes hacia un sistema como Tango Card. También puede ser útil para seguir cuánto pagó su programa de referidos en un período de tiempo determinado.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del participante, como nombre, ID de usuario y cuenta, dirección de correo electrónico y más
* Tipo de recompensa
* Unidad de recompensa
* Importe de la recompensa

Puedes encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) informe de saldos de recompensas.

**Referencia de columnas del informe**

| Columna                          | Descripción                                                                                                                                                                                            |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Información del participante** |                                                                                                                                                                                                        |
| ID de usuario                    | El identificador único del participante dentro de Advocate. Se usa para vincular el saldo de la recompensa con el usuario individual.                                                                  |
| ID de cuenta                     | El ID interno de la cuenta asociado con el participante. Especialmente relevante si los usuarios pertenecen a organizaciones o grupos de cuentas segmentados.                                          |
| Correo electrónico               | La dirección de correo electrónico del participante. A menudo se usa para el canje manual de recompensas o la sincronización con sistemas externos.                                                    |
| <p>Nombre</p><p>Apellido</p>     | El nombre y apellido del participante. Útil para la personalización o el filtrado durante el procesamiento de recompensas.                                                                             |
| Código de referido               | El código de referido asignado al participante. Esto es lo que comparte para referir a otros y rastrear la elegibilidad para recompensas.                                                              |
| **Información de la recompensa** |                                                                                                                                                                                                        |
| Tipo                             | La categoría o método de recompensa (p. ej., *Efectivo*, *Tarjeta regalo*, *Puntos*, *Personalizado*). Ayuda a determinar cómo deben canjearse o agruparse las recompensas.                            |
| Unidad                           | La unidad del valor de la recompensa (p. ej., *USD*, *ZAR*, *Puntos*, *%*). Importante para calcular saldos y para la gestión de pagos según la región.                                                |
| Importe                          | El saldo total disponible de recompensas pendientes para este usuario. Esta es la cifra principal que se usa al preparar pagos o exportaciones.                                                        |
| Crédito total asignado           | La cantidad total de crédito que se ha asignado alguna vez a este usuario (independientemente del canje). Refleja el costo total del programa asignado a este participante.                            |
| Crédito total canjeado           | La porción total de las recompensas que este participante ya ha canjeado. Útil para auditar los costos reales frente a los pasivos.                                                                    |
| Crédito total expirado           | Total de recompensas que se asignaron al usuario pero expiraron antes de ser canjeadas. Ayuda a rastrear recompensas no reclamadas o oportunidades de canje perdidas.                                  |
| **Metadatos del usuario**        |                                                                                                                                                                                                        |
| URL de la imagen                 | URL de la imagen de perfil o avatar del participante (si se recopiló). Principalmente estética o usada en paneles visibles para el usuario, si corresponde.                                            |
| Primera IP detectada             | La primera dirección IP registrada cuando se añadió o activó al participante. Útil para cumplimiento, etiquetado de ubicación o análisis de fraude.                                                    |
| Última IP detectada              | La dirección IP más reciente asociada con el participante. Ayuda a determinar si el usuario sigue activo o comprometido.                                                                               |
| Fecha de creación                | La fecha en que se creó la cuenta del participante en Advocate. Útil para el análisis de cohortes o del comportamiento de recompensas a lo largo del tiempo.                                           |
| Origen del referido              | La fuente o canal original por el que se adquirió al participante (p. ej., *correo electrónico*, *orgánico*, *partner*). Ayuda a evaluar el alcance y la eficacia del programa de referidos por canal. |
| Configuración regional           | El idioma y la configuración regional del participante (p. ej., *en-US*, *fr-FR*). Importante para comunicaciones personalizadas u opciones de recompensas regionales.                                 |

</details>

#### Saldos de recompensas disponibles por usuario

El *Saldos de recompensas disponibles por usuario* El informe proporciona una lista de recompensas no canjeadas. Este tipo de informe está diseñado para usarse como parte del canje de recompensas mediante el [canje masivo de recompensas](/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) proceso.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del participante, como nombre, ID de usuario y cuenta, dirección de correo electrónico y más
* Unidad de recompensa
* Moneda de la recompensa
* Importe disponible

Puedes encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](/files/faf35a5c690d12a158ef24495738b00376115a13) en el informe de saldos de recompensas disponibles.

{% hint style="info" %}
**Nota**: Este informe no incluye detalles sobre recompensas de Descuento porcentual, Tanque de combustible o Tarjeta de regalo. Use el *Saldos de recompensas por usuario* informe para obtener más detalles sobre estos tipos de recompensas.
{% endhint %}

**Referencia de columnas del informe**

| Columna                               | Descripción                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**      |                                                                                                                                                                                                                                                                                                                             |
| Nombre                                | El nombre del participante, utilizado para identificación o personalización durante el procesamiento de recompensas.                                                                                                                                                                                                        |
| Apellido                              | El apellido del participante.                                                                                                                                                                                                                                                                                               |
| Correo electrónico                    | La dirección de correo electrónico del participante, utilizada para enviar recompensas o hacer coincidir con sistemas externos como un CRM o un proveedor de recompensas.                                                                                                                                                   |
| ID de usuario                         | El identificador único asignado al participante dentro de Advocate.                                                                                                                                                                                                                                                         |
| ID de cuenta                          | El ID interno de la cuenta vinculado al participante.                                                                                                                                                                                                                                                                       |
| Segmentos                             | Etiquetas o categorías usadas para [agrupar participantes](/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (p. ej., *por región*, *etapa del ciclo de vida*, *tipo de cliente*). Útil para filtrar o aplicar distintas reglas de cumplimiento. |
| **Estado y momento de la recompensa** |                                                                                                                                                                                                                                                                                                                             |
| Fecha de bloqueo                      | La fecha en que se bloqueó al usuario para recibir recompensas, si corresponde. Un estado de bloqueo puede impedir el canje; este campo indica cuándo se aplicó dicho bloqueo.                                                                                                                                              |
| **Datos de la recompensa**            |                                                                                                                                                                                                                                                                                                                             |
| Nombre de la unidad                   | La etiqueta o nombre visible de la unidad de recompensa (p. ej., *Efectivo por referidos*, *Crédito de tienda*). Esto ayuda a distinguir entre varios tipos de recompensas que un programa puede ofrecer.                                                                                                                   |
| Moneda                                | El código de moneda del valor de la recompensa (p. ej., *USD*, *ZAR*, *EUR*). Necesario al canjear recompensas, especialmente entre países o sistemas de pago.                                                                                                                                                              |
| Valor disponible                      | La cantidad de recompensa no canjeada que actualmente está disponible para este participante. Este es el valor principal que se usa al determinar qué pagar.                                                                                                                                                                |
| Valor para canjear                    | El valor actualmente en cola para canje (p. ej., pendiente en un cumplimiento masivo o a la espera de procesamiento). Útil para evitar un doble canje o garantizar que no haya superposición en los canjes.                                                                                                                 |
| Valor total canjeado                  | El valor total de las recompensas que este participante ya ha canjeado. Ofrece información sobre canjes pasados y puede ser útil para el seguimiento del límite de recompensas                                                                                                                                              |
| Unidad                                | El código interno o del sistema para la unidad de recompensa (p. ej., *USD*, *puntos*, etc.). Podría usarse en llamadas a la API o en la lógica interna durante el canje.                                                                                                                                                   |

</details>

#### informe fiscal W-9 de EE. UU.

El informe fiscal W-9 de EE. UU. muestra el estado fiscal W-9 de los participantes y las recompensas obtenidas o pendientes por año.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del participante, como nombre, ID de usuario y cuenta, dirección de correo electrónico y más
* Fecha en que el formulario W-9 del participante se marcó como recopilado
* Valor imponible en EE. UU. de las recompensas obtenidas por año fiscal
* Número total de recompensas obtenidas por cada participante en el año fiscal

**Referencia de columnas del informe**

| Columna                                                                 | Descripción                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                        |                                                                                                                                                                                                                                                      |
| ID de usuario                                                           | El identificador único del participante en Advocate.                                                                                                                                                                                                 |
| ID de cuenta                                                            | ID interno de la cuenta asociado con el participante.                                                                                                                                                                                                |
| Correo electrónico                                                      | La dirección de correo electrónico del participante.                                                                                                                                                                                                 |
| Nombre                                                                  | El nombre del participante.                                                                                                                                                                                                                          |
| Apellido                                                                | El apellido del participante.                                                                                                                                                                                                                        |
| **Información fiscal W-9**                                              |                                                                                                                                                                                                                                                      |
| <p>Fecha de envío del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | La fecha en que el formulario W-9 del participante se marcó como enviado y recopilado en Advocate. Importante para el cumplimiento del IRS y para verificar el estado de la documentación fiscal.                                                    |
| **Resumen del año fiscal**                                              |                                                                                                                                                                                                                                                      |
| Año                                                                     | El año fiscal en el que el participante obtuvo recompensas. Se usa para agrupar los ingresos por año calendario para el procesamiento del 1099.                                                                                                      |
| Valor imponible en EE. UU. en centavos                                  | Valor total de las recompensas sujetas a impuestos en EE. UU. obtenidas por este participante en el año fiscal especificado, expresado en centavos (p. ej., 2500 = $25.00). Ayuda con cálculos en bruto o integraciones donde se requiere precisión. |
| Valor imponible en EE. UU. en dólares                                   | Lo mismo que arriba, pero mostrado en formato estándar de dólares (p. ej., 25.00). Más fácil para revisar o incluir en resúmenes oficiales.                                                                                                          |
| Recuento de recompensas                                                 | Número total de instancias individuales de recompensa obtenidas por el participante en el año fiscal especificado. Útil para auditorías o para comprender la frecuencia de recompensas y la participación en el programa.                            |

</details>

#### Pagos e impuestos

El *Pago e impuestos* informe muestra el estado fiscal de los participantes y las recompensas obtenidas o pendientes por año.

Si su programa proporciona pagos en efectivo a los participantes, se pondrán a disposición ciertos campos relacionados con el estado del formulario fiscal del participante.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del participante, como nombre, ID de usuario y cuenta, dirección de correo electrónico y más
* La fecha en que el formulario fiscal del participante — como un W-8 o W-9 — se marcó como enviado
* Valor imponible en EE. UU. de las recompensas obtenidas por año fiscal
* Número total de recompensas obtenidas por cada participante en el año fiscal
* El estado del formulario fiscal, por ejemplo, *válido*, *en espera*, o *pendientes*. Los motivos de retención del pago también se incluyen en el informe

**Referencia de columnas del informe**

| Columna                                                                 | Descripción                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                        |                                                                                                                                                                                                                                             |
| ID de usuario                                                           | El identificador único del participante en Advocate.                                                                                                                                                                                        |
| ID de cuenta                                                            | El ID de la cuenta del participante, utilizado para agrupación o informes organizativos.                                                                                                                                                    |
| Correo electrónico                                                      | La dirección de correo electrónico del participante.                                                                                                                                                                                        |
| Nombre                                                                  | El nombre del participante.                                                                                                                                                                                                                 |
| Apellido                                                                | El apellido del participante.                                                                                                                                                                                                               |
| **Información fiscal W-9**                                              |                                                                                                                                                                                                                                             |
| <p>Fecha de envío del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | La fecha en que el participante presentó su formulario W-9 (o el formulario fiscal estadounidense correspondiente). Importante para verificar la elegibilidad fiscal antes de emitir pagos en efectivo.                                     |
| **Resumen del año de pago**                                             |                                                                                                                                                                                                                                             |
| Año                                                                     | El año calendario en el que el participante obtuvo las recompensas.                                                                                                                                                                         |
| Valor                                                                   | Valor total del pago en unidades menores (p. ej., centavos) obtenido o pendiente para este participante durante el año. Por ejemplo, 1750 = $17.50.                                                                                         |
| Valor en dólares                                                        | El mismo valor, mostrado en formato monetario estándar para facilitar la revisión (p. ej., 17.50).                                                                                                                                          |
| Recuento                                                                | Número total de instancias individuales de recompensa de pago para el participante en el año especificado. Útil para comprender con qué frecuencia un participante obtuvo pagos.                                                            |
| **Elegibilidad y estado del pago**                                      |                                                                                                                                                                                                                                             |
| Retención del pago                                                      | Indica si los pagos del participante están actualmente retenidos (Sí o No). Los pagos pueden retenerse debido a formularios fiscales faltantes o a una configuración incompleta.                                                            |
| Motivos de retención del pago                                           | Explica por qué el participante está en retención de pago (si corresponde). Ejemplos de motivos: *Formulario fiscal faltante*, *No se proporcionó información bancaria*, *Revisión de cumplimiento*.                                        |
| Moneda del pago                                                         | La moneda en la que se procesan o procesarán los pagos del participante (p. ej., *USD*, *EUR*, *ZAR*). Importante para sistemas de pago globales y contabilidad.                                                                            |
| Configuración de pago iniciada                                          | Indica si el participante ha comenzado a configurar su método de pago (p. ej., mediante una integración con un proveedor de pagos). Ayuda a seguir el progreso de incorporación o las necesidades de seguimiento para los pagos pendientes. |

</details>


---

# 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-reporting-and-analytics/advocate-program-reports-explained.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.
