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

Advocate ofrece varios informes descargables sobre los datos de tu programa y sus participantes. Todos los informes incluyen opciones de filtrado para que tengas más control sobre los datos que descargas. Puedes descargar cada informe como archivo .CSV o de Excel.

En este artículo se explican los distintos informes y el tipo de datos que incluye cada uno. Consulta [Generar un informe del programa de Advocate](https://help.impact.com/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 *informe de detalles de usuario* 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 referencia de Advocate.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluirá información de los participantes, 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, puedes incluir opcionalmente:

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

Puedes consultar la lista completa de campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) del informe de detalles de usuario.

**Referencia de las columnas del informe**

| Columna                                                         | Descripción                                                                                                                                                                                                                 |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del usuario**                                     |                                                                                                                                                                                                                             |
| ID                                                              | El identificador único del participante en el sistema Advocate.                                                                                                                                                             |
| ID de cuenta                                                    | El identificador único de la cuenta del participante (se utiliza 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 realizar coincidencias con otros sistemas de forma respetuosa con la privacidad.                                                          |
| **Información de referencias y uso compartido**                 |                                                                                                                                                                                                                             |
| Código de referencia                                            | El código único asociado al participante, que se utiliza para hacer un seguimiento de las referencias que genera.                                                                                                           |
| Enlace para compartir                                           | El enlace de referencia único asociado al participante.                                                                                                                                                                     |
| Enlace para compartir en Facebook                               | Un enlace generado previamente para compartir la referencia en Facebook.                                                                                                                                                    |
| Enlace para compartir en Twitter                                | Un enlace generado previamente para compartir la referencia en Twitter.                                                                                                                                                     |
| Enlace para compartir por correo electrónico                    | Un enlace generado previamente para compartir la referencia por correo electrónico.                                                                                                                                         |
| Enlace para compartir en LinkedIn                               | Un enlace generado previamente para compartir la referencia en LinkedIn.                                                                                                                                                    |
| Enlace limpio para compartir                                    | Una versión del enlace de referencia sin parámetros de seguimiento; más neutral para determinadas plataformas o casos de uso.                                                                                               |
| **Geolocalización e idioma**                                    |                                                                                                                                                                                                                             |
| 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 detectada para este participante.                                                                                                                                                              |
| Configuración regional                                          | El idioma y la configuración regional preferidos por el participante (p. ej., en-US).                                                                                                                                       |
| Código de país                                                  | El país del participante, según su configuración regional o dirección IP (p. ej., 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. con fines de cumplimiento normativo o procesamiento de recompensas.                                                                               |
| **Estadísticas del usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                             |
| stats.date Modified                                             | La última fecha en que se actualizaron las estadísticas del participante.                                                                                                                                                   |
| stats.traffic                                                   | Número total de visitas generadas por la actividad de recomendación del participante.                                                                                                                                       |
| stats.referrals                                                 | Número total de recomendaciones exitosas realizadas por el participante.                                                                                                                                                    |
| stats.conversions                                               | Número total de conversiones (p. ej., compras, registros) generadas por esas recomendaciones.                                                                                                                               |
| stats.goals                                                     | Número de objetivos específicos completados asociados a la actividad de recomendación del participante (definidos de forma personalizada en el programa).                                                                   |
| stats.rewards                                                   | Número total de recompensas que ha obtenido el participante.                                                                                                                                                                |
| stats.widget Loads                                              | Número de veces que este participante cargó el widget de recomendaciones o la interfaz para compartir.                                                                                                                      |
| stats.revenue                                                   | Ingresos totales generados por los usuarios recomendados por este participante.                                                                                                                                             |
| stats.generated Revenue                                         | Sinónimo de stats.revenue; algunos informes pueden distinguir si los ingresos provienen de varias fuentes.                                                                                                                  |
| stats.referred Revenue                                          | Ingresos atribuidos específicamente a los participantes que se registraron o realizaron una compra mediante el enlace de recomendación de este participante.                                                                |
| **Datos personalizados**                                        |                                                                                                                                                                                                                             |
| custom Fields.example                                           | Marcador de posición para los campos personalizados definidos por tu programa (p. ej., *ID de fidelidad*, *notas internas*, *etiqueta de región*). Cada campo aparecerá en su propia columna, con el prefijo custom Fields. |
| **Otro**                                                        |                                                                                                                                                                                                                             |
| Fuente de recomendación                                         | La fuente o el canal original que llevó al participante a tu programa (p. ej., *orgánico*, *correo electrónico*, *sitio de un socio*).                                                                                      |

</details>

#### Exportación de eventos de usuario

El *informe de exportación de eventos de usuario* 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 delimitar 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 las 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 los envíos de eventos.                                                                                             |
| Clave del evento                                                                    | El tipo o la etiqueta del evento, como `purchase`, `signup`, o cualquier clave 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 asociado al usuario, especialmente relevante en programas donde los usuarios pueden pertenecer a distintas estructuras de cuentas.                                                                |
| **Marcas de tiempo del evento**                                                     |                                                                                                                                                                                                                   |
| Fecha de activación del evento – YYYY-MM-DD                                         | La fecha en que ocurrió realmente el evento (según lo informado por tu sistema). Por ejemplo, la fecha en que se realizó 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 al procesamiento por lotes o a 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 quedó disponible para el seguimiento, las recompensas o los informes.                                                    |
| **Campos de datos del evento (si se incluyen en las cargas útiles de tus eventos)** |                                                                                                                                                                                                                   |
| fields.coupon                                                                       | 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.revenue                                                                      | El importe de los ingresos asociados al evento. Se suele usar en eventos de compra para calcular el rendimiento, las recompensas o el retorno de la inversión (ROI).                                              |
| fields.currency                                                                     | El código de moneda (p. ej., *USD*, *ZAR*, *EUR*) asociado al importe de los ingresos. Es importante para generar informes de distintas regiones o calcular recompensas ajustadas al tipo de cambio.              |
| fields.lead Created Date                                                            | La fecha original en que se creó el lead (usuario) en tu sistema, si se envió como parte del evento. Ayuda a relacionar los eventos del usuario con las fechas de adquisición originales o los registros del CRM. |

</details>

#### Historial de recompensas

El *historial de recompensas* informe proporciona un registro detallado de cada una de tus recompensas y de las relaciones con los participantes y las referencias. Esta información puede ser útil para crear balances y consultar el estado de todas tus recompensas en un momento determinado.

<details>

<summary>Detalles del informe</summary>

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

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

Puedes encontrar una lista completa de los campos incluidos al [descargar nuestro CSV de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) informes de detalles de recompensas.

Al generar el informe, puedes incluir opcionalmente:

* **Detalles del participante** como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico, los campos personalizados, los segmentos y la información de referencia (si corresponde).
* **Campos de referencia** como el ID de referencia, los campos del recomendador, los campos del amigo recomendado y más.

**Referencia de las 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 el tipo de recompensa (p. ej., *Efectivo*, *Tarjeta regalo*, *Cupón*, *Personalizada*).                                                                                                                      |
| Valor                                                                                                              | El valor numérico de la recompensa (p. ej., 10, 100, etc.).                                                                                                                                                                 |
| Unidad                                                                                                             | La unidad asociada al valor (p. ej., *USD*, *puntos*, *ZAR*, *%*).                                                                                                                                                          |
| Nombre                                                                                                             | Nombre para mostrar de la recompensa (tal como se define en la [configuración de la recompensa](https://help.impact.com/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 (p. ej., *Referencia*, *Objetivo*, *Manual*, *API*).                                                                                                                                      |
| Tipo de fondo Fuel Tank                                                                                            | El tipo de fondo de recompensa utilizado (si se usa la integración de FuelTank). Por ejemplo, *Prepago*, *Tarjeta regalo*.                                                                                                  |
| Código de Fuel Tank                                                                                                | El código asociado al cumplimiento externo (p. ej., el código de un vale o de una tarjeta regalo).                                                                                                                          |
| ID del programa                                                                                                    | ID del programa de Advocate en cuyo marco se emitió la recompensa.                                                                                                                                                          |
| Clave de recompensa del programa                                                                                   | Identificador interno de la configuración de recompensa específica utilizada en el programa.                                                                                                                                |
| Clave de recompensa global                                                                                         | Identificador entre programas para las recompensas configuradas a nivel global (si corresponde).                                                                                                                            |
| **Marcas de tiempo de la recompensa**                                                                              |                                                                                                                                                                                                                             |
| Fecha de creación                                                                                                  | Fecha en que se creó el registro de recompensa en el sistema.                                                                                                                                                               |
| Fecha programada para                                                                                              | Fecha en que se programó la emisión de la recompensa (p. ej., tras un retraso o un período de espera).                                                                                                                      |
| Fecha de concesión                                                                                                 | Fecha en que se emitió la recompensa al participante.                                                                                                                                                                       |
| Fecha de vencimiento                                                                                               | Fecha de vencimiento de la recompensa (si corresponde).                                                                                                                                                                     |
| Fecha de cancelación                                                                                               | Fecha en que se anuló o canceló la recompensa.                                                                                                                                                                              |
| Fecha de canje                                                                                                     | Fecha en que el participante canjeó la recompensa (si corresponde).                                                                                                                                                         |
| Fecha de modificación                                                                                              | Fecha en que se realizó la actualización más reciente del registro de recompensa.                                                                                                                                           |
| **Seguimiento de créditos y valores**                                                                              |                                                                                                                                                                                                                             |
| 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 mensajes de la recompensa**                                                                             |                                                                                                                                                                                                                             |
| Estados                                                                                                            | Estado actual de la recompensa (p. ej., *Pendiente*, *Programada*, *Otorgada*, *Caducada*, *Cancelada*).                                                                                                                    |
| meta.status                                                                                                        | Estado técnico o del sistema (útil para diagnósticos o para gestionar errores).                                                                                                                                             |
| meta.message                                                                                                       | Mensaje asociado a la entrega de la recompensa (p. ej., «La recompensa se entregó correctamente»).                                                                                                                          |
| meta.internal Message                                                                                              | Notas solo para uso interno de los administradores (p. ej., explicaciones de fallos o indicadores).                                                                                                                         |
| meta.date Modified                                                                                                 | Última vez que se actualizaron los metadatos relacionados con la recompensa.                                                                                                                                                |
| meta.customMeta.testMeta                                                                                           | Marcador de posición para los campos 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                                                                                                    | ID de la cuenta asociada al 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 buscar coincidencias en el CRM.                                                                                                                        |
| **Contexto de la recomendación (si la recompensa se basa en una recomendación)**                                   |                                                                                                                                                                                                                             |
| referral.id                                                                                                        | ID de la recomendación que activó esta recompensa.                                                                                                                                                                          |
| referral.date Referral Started                                                                                     | Cuándo comenzó la acción de recomendación (p. ej., al hacer clic o compartir).                                                                                                                                              |
| referral.date Modified                                                                                             | Cuándo se actualizó por última vez el registro de la recomendación.                                                                                                                                                         |
| referral.referral Code Used                                                                                        | El código que usó la persona recomendada para unirse o realizar una acción.                                                                                                                                                 |
| **Información de la persona recomendada (amigo)**                                                                  |                                                                                                                                                                                                                             |
| referral.referred User.id                                                                                          | ID de la persona recomendada (el «amigo»).                                                                                                                                                                                  |
| referral.referred User.account Id                                                                                  | ID de cuenta único de la persona que hizo la recomendación.                                                                                                                                                                 |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Datos básicos de contacto de la persona que hizo la recomendación.                                                                                                                                                          |
| **Información del referente (promotor)**                                                                           |                                                                                                                                                                                                                             |
| referral.referrer User.id                                                                                          | ID de la persona que hizo la recomendación (el «promotor»).                                                                                                                                                                 |
| referral.referrer User.account Id                                                                                  | ID de cuenta único de la persona que hizo la recomendación.                                                                                                                                                                 |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Datos básicos de contacto de la persona que hizo la recomendación.                                                                                                                                                          |
| referral.date Converted                                                                                            | La fecha en que la recomendación se convirtió oficialmente (por ejemplo, al completar un registro o una compra), lo que activó la recompensa.                                                                               |

</details>

#### Historial de recomendaciones

El *historial de recomendaciones* informe ofrece un registro del estado de cada conexión de recomendación creada en tu programa. Esta información puede ser útil para comprobar el éxito del programa y hacer un seguimiento del número de nuevos clientes que ha atraído.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Datos de la persona recomendada, como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico y más
* Datos del promotor, como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico y más
* Estado de la recomendación
* Estado de moderación
* ID de recompensas

Puedes encontrar la lista completa de campos al [descargar nuestro archivo CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) del informe de actividad de recomendaciones.

**Referencia de las columnas del informe**

| Columna                                                                                                                       | Descripción                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadatos de la recomendación**                                                                                             |                                                                                                                                                     |
| ID                                                                                                                            | Identificador único del registro de recomendación en Advocate.                                                                                      |
| Fecha de modificación                                                                                                         | La fecha más reciente en que se actualizó alguna parte del registro de recomendación.                                                               |
| Fecha de inicio de la recomendación                                                                                           | Cuándo se inició la recomendación (por ejemplo, cuando la persona recomendada hizo clic en un enlace de recomendación).                             |
| Fecha de conversión                                                                                                           | Cuándo se convirtió la recomendación, normalmente cuando la persona recomendada completó la acción requerida (como registrarse o hacer una compra). |
| Fecha de modificación del usuario                                                                                             | La última vez que se actualizaron los datos de usuario implicados en esta recomendación (el referente o la persona recomendada).                    |
| ID del programa                                                                                                               | El ID del programa de recomendaciones de Advocate al que pertenece esta recomendación.                                                              |
| Nombre del programa                                                                                                           | El nombre del programa de recomendaciones, útil si gestionas varios programas.                                                                      |
| **Información de la persona recomendada (nuevo cliente)**                                                                     |                                                                                                                                                     |
| <p>Correo electrónico del usuario recomendado</p><p>Nombre del usuario recomendado</p><p>Apellido del usuario recomendado</p> | Información básica sobre la identidad de la persona recomendada.                                                                                    |
| Código de recomendación del usuario recomendado                                                                               | El código de recomendación asignado a la persona recomendada (por si también puede recomendar a otras personas más adelante).                       |
| <p>Primera IP registrada del usuario recomendado</p><p>Última IP registrada del usuario recomendado</p>                       | Direcciones IP registradas en la primera y la actividad más reciente de la persona recomendada.                                                     |
| URL de imagen del usuario recomendado                                                                                         | URL de la imagen o el avatar, si se registró o asignó a la persona recomendada.                                                                     |
| Configuración regional del usuario recomendado                                                                                | Configuración de idioma/región (por ejemplo, *en-US*, *fr-FR*) de la persona recomendada.                                                           |
| 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 Advocate.                                                                                             |
| Cuenta referida                                                                                                               | ID interno de la cuenta vinculada al usuario referido (se utiliza en programas con varias cuentas).                                                 |
| **Información del referente (promotor 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                                                                                      | Código de referido del usuario referente; probablemente, el código que usó el usuario referido.                                                     |
| <p>Primera IP registrada del usuario referente</p><p>Última IP registrada del usuario referente</p>                           | Direcciones IP registradas durante la primera y la actividad más reciente del referente.                                                            |
| URL de imagen del usuario referente                                                                                           | URL de la imagen o el avatar del referente.                                                                                                         |
| Configuración regional del usuario referente                                                                                  | Configuración regional del referente.                                                                                                               |
| Fecha de creación del usuario referente                                                                                       | Cuándo se unió el referente por primera vez o cuándo se registró en el sistema.                                                                     |
| Usuario referente                                                                                                             | ID interno del referente en Advocate.                                                                                                               |
| Cuenta del referente                                                                                                          | ID de la cuenta asociada al referente.                                                                                                              |
| **Moderación y estado**                                                                                                       |                                                                                                                                                     |
| Estado de moderación                                                                                                          | Estado general de moderación del referido. (Por ejemplo, *Aprobado*, *Rechazado*, *Pendiente*.)                                                     |
| Fecha de moderación                                                                                                           | La fecha en que se tomó la decisión de moderación (aprobación o rechazo).                                                                           |
| Fecha de pago del referido                                                                                                    | Cuándo se pagó la recompensa asociada al referido, si corresponde.                                                                                  |
| Fecha de finalización del referido                                                                                            | Cuándo se cerró oficialmente el registro del referido (por ejemplo, por vencimiento o finalización).                                                |
| Estado de moderación del usuario referido                                                                                     | Estado de moderación correspondiente a la participación del usuario referido.                                                                       |
| Estado de moderación del referente                                                                                            | Estado de moderación correspondiente a la participación del referente.                                                                              |
| **Referencias de recompensas**                                                                                                |                                                                                                                                                     |
| Recompensa del usuario referido                                                                                               | ID o referencia de la recompensa otorgada al usuario referido (si corresponde).                                                                     |
| Recompensa del referente                                                                                                      | ID o referencia de la recompensa otorgada 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, incluidos su valor y el destinatario previsto, generadas a través de su programa de referidos. Este informe suele utilizarse para entregar recompensas manualmente o como parte de un proceso por lotes en un sistema como Tango Card. También puede ser útil para hacer un seguimiento del importe pagado por su programa de referidos durante un periodo determinado.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Datos del participante, como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico y otros
* 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) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) del informe de saldos de recompensas.

**Referencia de las columnas del informe**

| Columna                          | Descripción                                                                                                                                                                                        |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante** |                                                                                                                                                                                                    |
| ID de usuario                    | Identificador único del participante en Advocate. Se utiliza para vincular el saldo de recompensas con el usuario correspondiente.                                                                 |
| ID de cuenta                     | ID de la cuenta interna asociada al participante. Es especialmente relevante si los usuarios pertenecen a organizaciones o a grupos de cuentas segmentados.                                        |
| Correo electrónico               | Dirección de correo electrónico del participante. Suele utilizarse para entregar recompensas manualmente o sincronizar datos con sistemas externos.                                                |
| <p>Nombre</p><p>Apellido</p>     | Nombre y apellidos del participante. Resultan útiles para personalizar o filtrar durante el procesamiento de recompensas.                                                                          |
| Código de referencia             | Código de referido asignado al participante. Es el código que comparte para referir a otras personas y hacer un seguimiento de su elegibilidad para recibir recompensas.                           |
| **Información de la recompensa** |                                                                                                                                                                                                    |
| Tipo                             | Categoría o método de la recompensa (p. ej., *Efectivo*, *Tarjeta de regalo*, *Puntos*, *Personalizada*). Ayuda a determinar cómo se deben entregar o agrupar las recompensas.                     |
| Unidad                           | Unidad del valor de la recompensa (p. ej., *USD*, *ZAR*, *Puntos*, *%*). Es importante para calcular los saldos y gestionar los pagos según la región.                                             |
| Importe                          | Saldo total disponible de recompensas pendientes para este usuario. Es la cifra principal que se utiliza al preparar pagos o exportaciones.                                                        |
| Crédito total asignado           | Importe total de crédito que se ha asignado a este usuario (independientemente de si lo ha canjeado). Refleja el costo total del programa asignado a este participante.                            |
| Crédito total canjeado           | Parte total de las recompensas que este participante ya ha canjeado. Es útil para auditar los costos reales frente a los pasivos.                                                                  |
| Crédito total vencido            | Total de recompensas asignadas al usuario que vencieron antes de que pudiera canjearlas. Ayuda a hacer un seguimiento de las recompensas no reclamadas o de las oportunidades de entrega perdidas. |
| **Metadatos del usuario**        |                                                                                                                                                                                                    |
| URL de la imagen                 | URL de la imagen de perfil o del avatar del participante (si se recopiló). Se utiliza principalmente con fines estéticos o en paneles visibles para los usuarios, si corresponde.                  |
| Primera IP detectada             | Primera dirección IP registrada cuando se añadió el participante o pasó a estar activo. Es útil para el cumplimiento normativo, la identificación de ubicaciones o el análisis de fraudes.         |
| Última IP detectada              | Dirección IP más reciente asociada al participante. Ayuda a determinar si el usuario sigue activo o participa.                                                                                     |
| Fecha de creación                | Fecha de creación de la cuenta del participante en Advocate. Es útil para analizar cohortes o el comportamiento relacionado con las recompensas a lo largo del tiempo.                             |
| Fuente de recomendación          | Fuente o canal original por el que se captó al participante (p. ej., *correo electrónico*, *orgánico*, *socio*). Ayuda a evaluar el alcance y la eficacia del programa de referidos por canal.     |
| Configuración regional           | Idioma y configuración regional del participante (p. ej., *en-US*, *fr-FR*). Son importantes para personalizar las comunicaciones o las opciones de recompensa según la región.                    |

</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á pensado para utilizarse como parte del proceso de canje masivo de recompensas mediante [el canje masivo de recompensas](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) .

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Datos del participante, como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico y otros
* Unidad de recompensa
* Moneda de la recompensa
* Importe disponible

Puedes encontrar la lista completa de campos al [descargar nuestro archivo CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) del informe de saldos de recompensas disponibles.

{% hint style="info" %}
**Nota**: este informe no incluye detalles sobre las recompensas de descuento porcentual, tanque de combustible o tarjeta de regalo. Para obtener más información sobre estos tipos de recompensas, usa el informe de *Saldos de recompensas por usuario* .
{% endhint %}

**Referencia de las columnas del informe**

| Columna                                | Descripción                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**       |                                                                                                                                                                                                                                                                                                                                                               |
| Nombre                                 | El nombre del participante, que se utiliza para identificarlo o personalizar las comunicaciones durante el procesamiento de recompensas.                                                                                                                                                                                                                      |
| Apellido                               | El apellido del participante.                                                                                                                                                                                                                                                                                                                                 |
| Correo electrónico                     | La dirección de correo electrónico del participante, que se utiliza para enviar recompensas o vincularlo con sistemas externos, como un CRM o un proveedor de recompensas.                                                                                                                                                                                    |
| ID de usuario                          | El identificador único asignado al participante en Advocate.                                                                                                                                                                                                                                                                                                  |
| ID de cuenta                           | El ID interno de la cuenta vinculada al participante.                                                                                                                                                                                                                                                                                                         |
| Segmentos                              | Etiquetas o categorías que se usan para [agrupar participantes](https://help.impact.com/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*). Son útiles para aplicar filtros o distintas reglas de cumplimiento. |
| **Estado y fechas de las recompensas** |                                                                                                                                                                                                                                                                                                                                                               |
| Fecha del bloqueo                      | La fecha en que se bloqueó al usuario para que no recibiera recompensas, si corresponde. El estado de bloqueo podría impedir el canje; este campo indica cuándo se aplicó el bloqueo.                                                                                                                                                                         |
| **Datos de las recompensas**           |                                                                                                                                                                                                                                                                                                                                                               |
| Nombre de la unidad                    | La etiqueta o el nombre visible de la unidad de recompensa (p. ej., *Dinero por recomendación*, *Crédito en tienda*). Esto permite distinguir entre los distintos tipos de recompensas que podría ofrecer un programa.                                                                                                                                        |
| Moneda                                 | El código de moneda del valor de la recompensa (p. ej., *USD*, *ZAR*, *EUR*). Es necesario para cumplir con las recompensas, especialmente en distintos países o sistemas de pago.                                                                                                                                                                            |
| Valor disponible                       | El importe de las recompensas no canjeadas que el participante tiene disponible actualmente. Este es el valor principal que se utiliza para determinar cuánto se pagará.                                                                                                                                                                                      |
| Valor que se va a canjear              | El valor que está actualmente en cola para el canje (p. ej., pendiente de cumplimiento masivo o a la espera de procesamiento). Es útil para evitar canjes duplicados o solapamientos.                                                                                                                                                                         |
| Valor total canjeado                   | El valor total de las recompensas que el participante ya ha canjeado. Permite conocer los canjes anteriores y puede ser útil para hacer un seguimiento de los límites de recompensas                                                                                                                                                                          |
| Unidad                                 | El código interno o del sistema de la unidad de recompensa (p. ej., *USD*, *puntos*, etc.). Podría utilizarse en llamadas a la API o en la lógica interna durante el cumplimiento.                                                                                                                                                                            |

</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 en EE. UU. y las recompensas obtenidas o pendientes por año.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

**Referencia de las columnas del informe**

| Columna                                                                        | Descripción                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                               |                                                                                                                                                                                                                                                                  |
| ID de usuario                                                                  | Identificador único del participante en Advocate.                                                                                                                                                                                                                |
| ID de cuenta                                                                   | ID de cuenta interno asociado al 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 del formulario W-9**                                      |                                                                                                                                                                                                                                                                  |
| <p>Fecha de presentación del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | Fecha en la que el formulario W-9 del participante se marcó como presentado y recopilado en Advocate. Es importante para cumplir con los requisitos del IRS y verificar el estado de la documentación fiscal.                                                    |
| **Resumen por año fiscal**                                                     |                                                                                                                                                                                                                                                                  |
| Año                                                                            | Año fiscal en el que el participante obtuvo las recompensas. Se utiliza para agrupar los ingresos por año calendario para la tramitación de los formularios 1099.                                                                                                |
| Valor imponible en EE. UU., en centavos                                        | Valor total de las recompensas sujetas a impuestos en EE. UU. que obtuvo este participante durante el año fiscal especificado, expresado en centavos (por ejemplo, 2500 = 25,00 $). Es útil para cálculos sin redondear o integraciones que requieren precisión. |
| Valor imponible en EE. UU., en dólares                                         | El mismo valor que el anterior, pero mostrado en el formato habitual en dólares (por ejemplo, 25,00). Facilita la revisión o la inclusión en resúmenes oficiales.                                                                                                |
| Número de recompensas                                                          | Número total de recompensas individuales obtenidas por el participante durante el año fiscal especificado. Es útil para llevar un registro de auditoría o conocer la frecuencia de las recompensas y la participación en el programa.                            |

</details>

#### Pagos e impuestos

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

Si su programa ofrece pagos en efectivo a los participantes, se mostrarán ciertos campos relacionados con el estado de sus formularios fiscales.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Datos del participante, como el nombre, el ID de usuario y de cuenta, la dirección de correo electrónico y otros
* Fecha en que el formulario fiscal del participante —como un W-8 o W-9— se marcó como presentado
* Valor imponible en EE. UU. de las recompensas obtenidas por año fiscal
* Número total de recompensas obtenidas por cada participante durante el año fiscal
* El estado del formulario fiscal, por ejemplo, *válido*, *en espera*, o *pendiente*. El informe también incluye los motivos por los que se retienen los pagos

**Referencia de las columnas del informe**

| Columna                                                                        | Descripción                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                               |                                                                                                                                                                                                                                                             |
| ID de usuario                                                                  | Identificador único del participante en Advocate.                                                                                                                                                                                                           |
| ID de cuenta                                                                   | El ID de cuenta del participante, que se utiliza para agrupar o elaborar 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 del formulario W-9**                                      |                                                                                                                                                                                                                                                             |
| <p>Fecha de presentación del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | Fecha en que el participante presentó su formulario W-9 (u otro formulario fiscal pertinente de EE. UU.). Es importante para verificar la elegibilidad fiscal antes de emitir pagos en efectivo.                                                            |
| **Resumen por año de pago**                                                    |                                                                                                                                                                                                                                                             |
| Año                                                                            | Año calendario en que el participante obtuvo las recompensas.                                                                                                                                                                                               |
| Valor                                                                          | Valor total de los pagos en unidades menores (por ejemplo, centavos) obtenidos o pendientes para este participante durante el año. Por ejemplo, 1750 = 17,50 $.                                                                                             |
| Valor en dólares                                                               | El mismo valor, mostrado en el formato habitual de moneda para facilitar su revisión (por ejemplo, 17,50).                                                                                                                                                  |
| Cantidad                                                                       | Número total de recompensas individuales pagadas al participante durante el año especificado. Es útil para saber con qué frecuencia un participante obtuvo pagos.                                                                                           |
| **Elegibilidad y estado de los pagos**                                         |                                                                                                                                                                                                                                                             |
| Retención de pagos                                                             | Indica si los pagos del participante están retenidos actualmente (Sí o No). Los pagos pueden retenerse si faltan formularios fiscales o si la configuración está incompleta.                                                                                |
| Motivos de la retención de pagos                                               | Explica por qué se retienen los pagos del participante, si corresponde. Algunos motivos posibles: *Falta el formulario fiscal*, *No se proporcionaron los datos bancarios*, *Revisión de cumplimiento*.                                                     |
| Moneda de pago                                                                 | Moneda en la que se procesan o se procesarán los pagos del participante (por ejemplo, *USD*, *EUR*, *ZAR*). Importante para los sistemas de pagos globales y la contabilidad.                                                                               |
| Configuración de pagos iniciada                                                | Indica si el participante ha comenzado a configurar su método de pago (por ejemplo, mediante la integración de un proveedor de pagos). Ayuda a hacer seguimiento del progreso de incorporación o de las necesidades de seguimiento de 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
