> 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">Toma el curso PXA</a>

Advocate ofrece varios informes descargables para sus datos de programa y participantes. Todos los informes tienen opciones de filtrado para darle mayor control sobre los datos que descarga. Cada informe se puede descargar como un archivo .CSV o de Excel.

Este artículo explica los diferentes informes y qué tipo de datos incluye cada uno. Consulte [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 de usuario

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

<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 referencia (si corresponde)

Al generar el informe, opcionalmente puede incluir:

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

Puede 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) informe de detalles de 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 (encriptada) del correo electrónico del participante, útil para la coincidencia compatible con la privacidad en otros sistemas.                                                                                     |
| **Información de referencia y compartir**                       |                                                                                                                                                                                                                                          |
| Código de referido                                              | El código único vinculado al participante, utilizado para rastrear las referencias que genera.                                                                                                                                           |
| Enlace para compartir                                           | El enlace único de referencia asociado con el participante.                                                                                                                                                                              |
| Enlace para compartir en Facebook                               | Un enlace pregenerado para compartir la referencia en Facebook.                                                                                                                                                                          |
| Enlace para compartir en Twitter                                | Un enlace pregenerado para compartir la referencia en Twitter.                                                                                                                                                                           |
| Enlace para compartir por correo electrónico                    | Un enlace pregenerado para compartir la referencia por correo electrónico.                                                                                                                                                               |
| Enlace para compartir en LinkedIn                               | Un enlace pregenerado para compartir la referencia en LinkedIn.                                                                                                                                                                          |
| Enlace limpio para compartir                                    | Una versión del enlace de referencia sin parámetros de seguimiento; más neutra para determinadas plataformas o casos de uso.                                                                                                             |
| **Geolocalización y configuración regional**                    |                                                                                                                                                                                                                                          |
| IP vista por primera vez                                        | La dirección IP desde la que se registró por primera vez al participante.                                                                                                                                                                |
| Última IP vista                                                 | 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 el cumplimiento o el procesamiento de recompensas.                                                                                                        |
| **Estadísticas del usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                                          |
| stats.date Modificado                                           | La última fecha en la que se actualizaron las estadísticas del participante.                                                                                                                                                             |
| stats.tráfico                                                   | Número total de visitas generadas por la actividad de referencia del participante.                                                                                                                                                       |
| stats.referencias                                               | Número total de referencias exitosas realizadas por el participante.                                                                                                                                                                     |
| stats.conversiones                                              | Número total de conversiones (por ejemplo, compras, registros) que resultaron de esas referencias.                                                                                                                                       |
| stats.objetivos                                                 | Número de finalizaciones de objetivos específicos asociadas con la actividad de referencia del participante (definidos de forma personalizada en el programa).                                                                           |
| stats.recompensas                                               | Número total de recompensas que ha ganado el participante.                                                                                                                                                                               |
| stats.cargas de widget                                          | Número de veces que el widget de referencia 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 varias fuentes.                                                                                                                              |
| stats.ingresos referidos                                        | Ingresos atribuidos específicamente a los participantes que se registraron o compraron a través del enlace de referencia de este participante.                                                                                           |
| **Datos personalizados**                                        |                                                                                                                                                                                                                                          |
| custom Fields.ejemplo                                           | Un marcador de posición para cualquier campo personalizado definido por su 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 de la referencia                                         | La fuente o canal original que llevó al participante a su programa (por ejemplo, *orgánico*, *correo electrónico*, *sitio asociado*).                                                                                                    |

</details>

#### Exportación de eventos de usuario

El *Exportación de eventos de usuario* el informe proporciona un registro de todos los eventos de usuario que hemos recibido de su organización para su programa de Advocate. Puede aplicar filtros para reducir un intervalo de tiempo, una clave de evento, un 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 el seguimiento, la depuración o la auditoría de envíos de eventos.                                                                                   |
| Clave del evento                                                                | El tipo o la etiqueta del evento, como `purchase`, `registro`, o cualquier clave definida de forma personalizada que envíe su sistema.                                                                         |
| ID de usuario                                                                   | El identificador único del participante en Advocate con el 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 – AAAA-MM-DD                                     | La fecha en que realmente ocurrió el evento (según lo informado por su sistema). Por ejemplo, la fecha en que tuvo lugar una compra o un registro.                                                             |
| Fecha de recepción del evento – AAAA-MM-DD                                      | La fecha en que Advocate recibió el evento de su sistema. Puede diferir de la fecha de activación debido a procesamiento por lotes o retrasos del sistema.                                                     |
| Fecha de procesamiento del evento – AAAA-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 sus cargas útiles de eventos)** |                                                                                                                                                                                                                |
| 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 rastrear el uso de incentivos o desencadenantes 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 importe de ingresos. Importante al informar entre regiones o 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 su sistema, si se envió como parte del evento. Ayuda a conectar los eventos de usuario con las fechas de adquisición originales o los registros del CRM. |

</details>

#### Historial de recompensas

El *Historial de recompensas* el informe proporciona un registro detallado de cada una de sus recompensas y de las relaciones con participantes y referencias. Esta información puede ser útil para crear balances, así como para obtener el estado de todas sus 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

Puede 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) informes de detalles de recompensa.

Al generar el informe, opcionalmente puede incluir:

* **Detalles del participante** como nombre, ID de usuario y de cuenta, dirección de correo electrónico, campos personalizados, segmentos e información de referencia (si corresponde).
* **Campos de referencia** como ID de referencia, campos de customer advocate, campos de 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 recompensa (generado por Advocate).                                                                                                                                |
| Tipo                                                                                                                       | La categoría o tipo de recompensa (por ejemplo, *Efectivo*, *Tarjeta de 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 visible 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é desencadenó 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 de FuelTank). Por ejemplo, *Prepago*, *Tarjeta de 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 de regalo).                                                                                       |
| ID del programa                                                                                                            | ID del programa de Advocate bajo el cual se emitió la recompensa.                                                                                                                              |
| Clave de recompensa del programa                                                                                           | Identificador interno para la configuración específica de recompensa utilizada dentro del programa.                                                                                            |
| Clave global de recompensa                                                                                                 | 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ó emitir la recompensa (por ejemplo, después de un retraso o período de espera).                                                                                              |
| Fecha de otorgamiento                                                                                                      | Cuándo se emitió realmente la recompensa al participante.                                                                                                                                      |
| Fecha de vencimiento                                                                                                       | La fecha de vencimiento de la recompensa (si corresponde).                                                                                                                                     |
| Fecha de cancelación                                                                                                       | La fecha en que la recompensa fue anulada o cancelada.                                                                                                                                         |
| Fecha de canje                                                                                                             | 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 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 no utilizada o no canjeada de la recompensa.                                                                                                                                 |
| **Estado y mensajes de la recompensa**                                                                                     |                                                                                                                                                                                                |
| Estados                                                                                                                    | Estado actual de la recompensa (por ejemplo, *pendiente*, *Programada*, *Entregada*, *Caducada*, *Cancelado*).                                                                                 |
| meta.estado                                                                                                                | Estado técnico o a nivel de 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 internas solo para administradores (por ejemplo, explicaciones de fallos o indicadores).                                                                                                 |
| meta.fecha Modificada                                                                                                      | Ú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 su programa (en este caso, testMeta es una muestra).                                                        |
| **Información del participante (usuario)**                                                                                 |                                                                                                                                                                                                |
| user.id                                                                                                                    | ID del usuario que recibe la recompensa.                                                                                                                                                       |
| user.id de cuenta                                                                                                          | El ID de cuenta asociado del usuario en Advocate.                                                                                                                                              |
| <p>user.nombre</p><p>user.apellido</p><p>user.correo electrónico</p>                                                       | Información básica del participante incluida como referencia o para coincidencia con el CRM.                                                                                                   |
| **Contexto de la referencia (si la recompensa se basa en una referencia)**                                                 |                                                                                                                                                                                                |
| referral.id                                                                                                                | El ID de la referencia que desencadenó esta recompensa.                                                                                                                                        |
| referral.fecha Inicio de la referencia                                                                                     | Cuándo comenzó la acción de referencia (por ejemplo, un evento de clic o compartir).                                                                                                           |
| referral.fecha Modificada                                                                                                  | Cuándo se actualizó por última vez el registro de referencia.                                                                                                                                  |
| referral.código de referencia utilizado                                                                                    | El código que utilizó el usuario referido para unirse 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.id de cuenta                                                                                        | El ID de cuenta único del referente.                                                                                                                                                           |
| <p>referral.referred User.nombre</p><p>referral.referred User.apellido</p><p>referral.referred User.correo electrónico</p> | Los datos básicos de contacto del referente.                                                                                                                                                   |
| **Información del referente (Advocate)**                                                                                   |                                                                                                                                                                                                |
| referral.referrer User.id                                                                                                  | ID de la persona que hizo la referencia (el “advocate”).                                                                                                                                       |
| referral.referrer User.id de cuenta                                                                                        | El ID de cuenta único del referente.                                                                                                                                                           |
| <p>referral.referrer User.nombre</p><p>referral.referrer User.apellido</p><p>referral.referrer User.correo electrónico</p> | Los datos básicos de contacto del referente.                                                                                                                                                   |
| referral.fecha Convertida                                                                                                  | La fecha en que la referencia se convirtió oficialmente (por ejemplo, cuando se completó el registro o la compra), activando la recompensa.                                                    |

</details>

#### Historial de referencias

El *Historial de referencias* el informe proporciona un registro del estado de cada conexión de referencia realizada en su programa de referencias. Esta información puede ser útil para comprobar el éxito de su programa y hacer un seguimiento del número de nuevos clientes que ha aportado su 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 customer advocate como nombre, ID de usuario y de cuenta, dirección de correo electrónico y más
* Estado de la referencia
* Estado de moderación
* IDs de recompensa

Puede 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 referencias.

**Referencia de columnas del informe**

| Columna                                                                                                                 | Descripción                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadatos de referencia**                                                                                             |                                                                                                                                         |
| ID                                                                                                                      | Identificador único del registro de referencia en Advocate.                                                                             |
| Fecha de modificación                                                                                                   | La fecha más reciente en la que se actualizó cualquier parte del registro de referencia.                                                |
| Fecha de inicio de la referencia                                                                                        | Cuándo se inició por primera vez la referencia (por ejemplo, cuando el usuario referido hizo clic en un enlace de referencia).          |
| Fecha de conversión                                                                                                     | Cuándo se convirtió la referencia, 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 actualizó el dato del usuario implicado en esta referencia (referente o referido).                                 |
| ID del programa                                                                                                         | El ID del programa de referencias de Advocate al que pertenece esta referencia.                                                         |
| Nombre del programa                                                                                                     | El nombre del programa de referencias, útil si administra 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 referencia del usuario referido                                                                               | El código de referencia asignado al usuario referido (en caso de que también pueda referir a otros más adelante).                       |
| <p>Primera IP vista del usuario referido</p><p>Última IP vista del usuario referido</p>                                 | Direcciones IP registradas en la primera y la actividad más reciente del usuario referido.                                              |
| URL de imagen del usuario referido                                                                                      | URL de 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 de cuenta interno vinculado al usuario referido (usado en programas de varias cuentas).                                              |
| **Información del referente (customer advocate)**                                                                       |                                                                                                                                         |
| <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 referencia del usuario referente                                                                              | El código de referencia que pertenece al referente, el código que probablemente usó el usuario referido.                                |
| <p>Primera IP vista del usuario referente</p><p>Última IP vista del usuario referente</p>                               | Direcciones IP registradas en la primera y la actividad más reciente del referente.                                                     |
| URL de 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                                                                                 | Cuándo el referente se unió por primera vez o fue registrado 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. (Por ejemplo, *Aprobada*, *Rechazada*, *pendiente*.)                                     |
| Fecha de moderación                                                                                                     | La fecha en que se tomó la decisión de moderación (aprobación/rechazo).                                                                 |
| Fecha de pago de la referencia                                                                                          | Cuando se pagó cualquier recompensa asociada por la referencia.                                                                         |
| Fecha de finalización de la referencia                                                                                  | Cuando el registro de referencia se cerró oficialmente (p. ej., por vencimiento o finalización).                                        |
| Estado de moderación del referido                                                                                       | Estado de moderación específico de la parte del usuario referido en la referencia.                                                      |
| Estado de moderación del referidor                                                                                      | Estado de moderación específico de la parte del referidor en la referencia.                                                             |
| **Referencias de recompensa**                                                                                           |                                                                                                                                         |
| Recompensa del referido                                                                                                 | El ID o la referencia de la recompensa emitida al usuario referido (si corresponde).                                                    |
| Recompensa del referidor                                                                                                | El ID o la referencia de la recompensa emitida al referidor (si corresponde).                                                           |

</details>

#### Saldos de recompensas por usuario

El *Saldos de recompensas por usuario* 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 se usa a menudo como parte de la entrega manual de recompensas, o como parte de un proceso por lotes a un sistema como Tango Card. También puede ser útil para hacer seguimiento de cuánto pagó su programa de referidos en un período determinado.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Puede 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 recompensas 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 a grupos de cuentas segmentados.                                                |
| Correo electrónico               | La dirección de correo electrónico del participante. A menudo se usa para la entrega manual de recompensas o la sincronización con sistemas externos.                                                          |
| <p>Nombre</p><p>Apellido</p>     | El nombre y apellido del participante. Útil para personalización o filtrado durante el procesamiento de recompensas.                                                                                           |
| Código de referido               | El código de referencia asignado al participante. Es lo que comparten para referir a otros y hacer seguimiento de la elegibilidad para recompensas.                                                            |
| **Información de la recompensa** |                                                                                                                                                                                                                |
| Tipo                             | La categoría o método de recompensa (p. ej., *Efectivo*, *Tarjeta de regalo*, *Puntos*, *Personalizado*). Ayuda a determinar cómo deben entregarse 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 regional de pagos.                                                               |
| 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           | El importe total de crédito que se ha asignado alguna vez a este usuario (independientemente del canje). Refleja el costo general del programa asignado a este participante.                                   |
| Crédito total canjeado           | La parte total de las recompensas que este participante ya ha canjeado. Útil para auditar costos reales frente a pasivos.                                                                                      |
| Crédito total vencido            | Total de recompensas que se asignaron al usuario pero vencieron antes de ser canjeadas. Ayuda a hacer seguimiento de recompensas no reclamadas o de oportunidades de entrega 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 orientados al usuario, si corresponde.                                                       |
| IP vista por primera vez         | La primera dirección IP registrada cuando el participante fue agregado o se activó. Útil para cumplimiento, etiquetado de ubicación o análisis de fraude.                                                      |
| Última IP vista                  | 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 análisis de cohortes o del comportamiento de recompensas a lo largo del tiempo.                                                      |
| Origen de la referencia          | La fuente o canal original a través del cual se adquirió al participante (p. ej., *correo electrónico*, *orgánico*, *socio*). Ayuda a evaluar el alcance y la efectividad 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 o opciones de recompensa regionales.                                          |

</details>

#### Saldos de recompensas disponibles por usuario

El *Saldos de recompensas disponibles por usuario* informe proporciona una lista de recompensas no canjeadas. Este tipo de informe está destinado a usarse como parte de la entrega de recompensas a través del [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 de cuenta, dirección de correo electrónico y más
* Unidad de recompensa
* Moneda de la recompensa
* Importe disponible

Puede 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, Fuel Tank 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, usado 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, usada 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 diferentes reglas de entrega. |
| **Estado y cronología de la recompensa** |                                                                                                                                                                                                                                                                                                                         |
| Fecha de bloqueo                         | La fecha en que se bloqueó al usuario para recibir recompensas, si corresponde. Un estado bloqueado podría impedir el canje; este campo indica cuándo se aplicó ese bloqueo.                                                                                                                                            |
| **Datos de la recompensa**               |                                                                                                                                                                                                                                                                                                                         |
| Nombre de la unidad                      | La etiqueta o nombre visible de la unidad de la recompensa (p. ej., *Efectivo por referidos*, *Crédito de tienda*). Esto ayuda a distinguir entre varios tipos de recompensas que un programa podría ofrecer.                                                                                                           |
| Moneda                                   | El código de moneda del valor de la recompensa (p. ej., *USD*, *ZAR*, *EUR*). Necesario al entregar recompensas, especialmente entre países o sistemas de pago.                                                                                                                                                         |
| Valor disponible                         | El importe de la recompensa no canjeada actualmente disponible para este participante. Este es el valor principal que se usa al determinar cuánto pagar.                                                                                                                                                                |
| Valor para canjear                       | El valor actualmente en cola para canje (p. ej., pendiente en una entrega masiva o a la espera de procesamiento). Útil para evitar el doble canje o garantizar que no haya solapamiento en los canjes.                                                                                                                  |
| Valor total canjeado                     | El valor total de las recompensas que este participante ya ha canjeado. Brinda información sobre canjes anteriores 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 la entrega.                                                                                                                                             |

</details>

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

El informe fiscal W-9 de EE. UU. muestra el estado fiscal W-9 de EE. UU. de los participantes y las recompensas ganadas 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 de cuenta, dirección de correo electrónico y más
* Fecha en que el formulario W-9 del participante se marcó como recibido
* Valor imponible en EE. UU. de las recompensas ganadas por año fiscal
* Cantidad total de recompensas ganadas 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>YYYY-MM-DD</p> | La fecha en que el formulario W-9 del participante se marcó como enviado y recibido 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 ganó recompensas. Se usa para agrupar ganancias por año calendario para el procesamiento del 1099.                                                                                             |
| Valor imponible en EE. UU. en centavos                                  | Valor total de las recompensas gravables en EE. UU. ganadas por este participante en el año fiscal especificado, expresado en centavos (p. ej., 2500 = $25.00). Ayuda con cálculos brutos 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 de revisar o incluir en resúmenes oficiales.                                                                                              |
| Cantidad de recompensas                                                 | Número total de instancias individuales de recompensas ganadas por el participante en el año fiscal especificado. Útil para registros de auditoría o para entender la frecuencia de recompensas y la participación en el programa.     |

</details>

#### Pagos y impuestos

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

Si su programa ofrece 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 de cuenta, dirección de correo electrónico y más
* 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 ganadas por año fiscal
* Cantidad total de recompensas ganadas por cada participante en el año fiscal
* El estado del formulario fiscal, p. ej., *válido*, *en espera*, o *pendiente*. También se incluyen en el informe los motivos de retención del pago

**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 cuenta del participante, usado para agrupación o informes organizacionales.                                                                                                                                                                   |
| 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>YYYY-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 ganó las recompensas.                                                                                                                                                                                      |
| Valor                                                                   | Valor total del pago en unidades menores (p. ej., centavos) ganado o pendiente para este participante durante el año. Por ejemplo, 1750 = $17.50.                                                                                                      |
| Valor en dólares                                                        | El mismo valor, mostrado en formato de moneda estándar para facilitar la revisión (p. ej., 17.50).                                                                                                                                                     |
| Cantidad                                                                | Número total de instancias individuales de recompensas de pago para el participante en el año especificado. Útil para entender 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 por formularios fiscales faltantes o una configuración incompleta.                                                                              |
| Motivos de retención del pago                                           | Explica por qué el participante tiene retenido el pago (si corresponde). Motivos de ejemplo: *Formulario fiscal faltante*, *Información bancaria no proporcionada*, *Revisión de cumplimiento*.                                                        |
| Moneda del pago                                                         | La moneda en la que los pagos del participante se procesan o se procesarán (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 hacer seguimiento del progreso de incorporación o de las necesidades de seguimiento para 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.
