> 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 de PXA</a>

Advocate ofrece varios informes descargables para los datos de tu programa y de los participantes. Todos los informes cuentan con opciones de filtrado para darte un mayor control sobre los datos que descargas. Cada informe puede descargarse como archivo .CSV o de Excel.

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

#### Informe de detalles del usuario

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

<details>

<summary>Detalles del informe</summary>

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

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

Al generar el informe, puedes incluir opcionalmente:

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

Se puede encontrar una lista completa de los campos cuando [descargas nuestro CSV de muestra](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 del usuario.

**Referencia de columnas del informe**

| Columna                                                         | Descripción                                                                                                                                                                                                                                      |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Información del usuario**                                     |                                                                                                                                                                                                                                                  |
| ID                                                              | El identificador único del participante dentro del sistema de Advocate.                                                                                                                                                                          |
| ID de cuenta                                                    | El identificador único de la cuenta del participante (se usa 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 comparaciones compatibles con la privacidad con otros sistemas.                                                                                                |
| **Información de referido y compartición**                      |                                                                                                                                                                                                                                                  |
| Código de referido                                              | El código único vinculado al participante, usado para rastrear los referidos que genera.                                                                                                                                                         |
| Enlace para compartir                                           | El enlace único de referido asociado con el participante.                                                                                                                                                                                        |
| Enlace para compartir en Facebook                               | Un enlace pregenerado para compartir el referido en Facebook.                                                                                                                                                                                    |
| Enlace para compartir en Twitter                                | Un enlace pregenerado para compartir el referido en Twitter.                                                                                                                                                                                     |
| Enlace para compartir por correo electrónico                    | Un enlace pregenrado para compartir el referido por correo electrónico.                                                                                                                                                                          |
| Enlace para compartir en LinkedIn                               | Un enlace pregenerado para compartir el referido en LinkedIn.                                                                                                                                                                                    |
| Enlace limpio para compartir                                    | Una versión del enlace de referido sin parámetros de seguimiento; más neutra para ciertas plataformas o casos de uso.                                                                                                                            |
| **Geolocalización y configuración regional**                    |                                                                                                                                                                                                                                                  |
| IP vista por primera vez                                        | La dirección IP desde la cual se registró por primera vez al participante.                                                                                                                                                                       |
| Última IP vista                                                 | La dirección IP más reciente vista 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 presentó un formulario fiscal de EE. UU. para cumplimiento o procesamiento de recompensas.                                                                                                                   |
| **Estadísticas del usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                                                  |
| stats.fecha modificada                                          | 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 referido del participante.                                                                                                                                                                 |
| stats.referidos                                                 | Número total de referidos exitosos realizados por el participante.                                                                                                                                                                               |
| stats.conversiones                                              | Número total de conversiones (por ejemplo, compras, registros) que resultaron de esos referidos.                                                                                                                                                 |
| stats.objetivos                                                 | Número de logros de objetivos específicos asociados con la actividad de referidos del participante (definidos de forma personalizada en el programa).                                                                                            |
| stats.recompensas                                               | Número total de recompensas que ha ganado el participante.                                                                                                                                                                                       |
| stats.cargas del widget                                         | Número de veces que el widget de referidos o la interfaz para compartir fue cargada por este participante.                                                                                                                                       |
| stats.ingresos                                                  | Ingresos totales generados por usuarios que fueron referidos por este participante.                                                                                                                                                              |
| stats.ingresos generados                                        | Sinónimo de stats.revenue; algunos informes pueden distinguirlo 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 referido de este participante.                                                                                                     |
| **Datos personalizados**                                        |                                                                                                                                                                                                                                                  |
| campos personalizados.ejemplo                                   | Un marcador de posición para cualquier campo personalizado definido por tu programa (por ejemplo, *ID de fidelidad*, *notas internas*, *etiqueta de región*). Cada campo aparecerá como su propia columna, con el prefijo campos personalizados. |
| **Otros**                                                       |                                                                                                                                                                                                                                                  |
| Fuente de referido                                              | La fuente o canal original que llevó al participante a tu programa (por ejemplo, *orgánico*, *correo electrónico*, *sitio de un socio*).                                                                                                         |

</details>

#### Exportación de eventos de usuario

El *Exportación de evento de usuario* el informe proporciona un registro de todos los eventos de usuario que hemos recibido de tu organización para tu programa de Advocate. Puedes aplicar filtros para reducir un rango de tiempo, clave de evento, 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 del usuario y de la cuenta
* Fecha de activación
* Fecha de recepción
* Fecha de procesamiento

**Referencia de columnas del informe**

| Columna                                                                         | Descripción                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del evento y del usuario**                                        |                                                                                                                                                                                                                       |
| ID del evento                                                                   | Un ID único generado para cada evento recibido. Útil para hacer seguimiento, depurar o auditar envíos de eventos.                                                                                                     |
| Clave del evento                                                                | El tipo o etiqueta del evento, como `compra`, `registro`, o cualquier clave definida de forma personalizada que envíe tu sistema.                                                                                     |
| ID de usuario                                                                   | El identificador único del participante en Advocate al que está asociado el evento.                                                                                                                                   |
| ID de cuenta                                                                    | El ID de cuenta vinculado al usuario, especialmente relevante en programas donde los usuarios pueden pertenecer a diferentes estructuras de cuenta.                                                                   |
| **Marcas de tiempo del evento**                                                 |                                                                                                                                                                                                                       |
| Fecha de activación del evento – YYYY-MM-DD                                     | La fecha en que realmente ocurrió el evento (según lo informa tu sistema). Por ejemplo, la fecha en que tuvo lugar una compra o un registro.                                                                          |
| Fecha de recepción del evento – YYYY-MM-DD                                      | La fecha en que Advocate recibió el evento de tu sistema. Puede diferir de la fecha de activación debido a lotes o retrasos del sistema.                                                                              |
| Fecha de procesamiento del evento – YYYY-MM-DD                                  | La fecha en que el evento se procesó y almacenó correctamente en Advocate. Marca cuándo el evento se volvió utilizable para seguimiento, recompensas o informes.                                                      |
| **Campos de datos del evento (si se incluyen en tus 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 los 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 tu sistema, si se envía como parte del evento. Ayuda a relacionar los eventos del usuario con las fechas de adquisición originales o con los registros del CRM. |

</details>

#### Historial de recompensas

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

<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

Se puede encontrar una lista completa de los campos incluidos cuando [descargas 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 recompensa.

Al generar el informe, puedes incluir opcionalmente:

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

**Referencia de columnas del informe**

| Columna                                                                                                                                | Descripción                                                                                                                                                                                          |
| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información de la recompensa**                                                                                                       |                                                                                                                                                                                                      |
| ID                                                                                                                                     | ID único de la instancia de recompensa (generado por Advocate).                                                                                                                                      |
| Tipo                                                                                                                                   | La categoría o tipo de recompensa (por ejemplo, *Efectivo*, *Tarjeta regalo*, *Cupón*, *Personalizado*).                                                                                             |
| Valor                                                                                                                                  | El valor numérico de la recompensa (por ejemplo, 10, 100, etc.).                                                                                                                                     |
| Unidad                                                                                                                                 | La unidad asociada con el valor (por ejemplo, *USD*, *puntos*, *ZAR*, *%*).                                                                                                                          |
| Nombre                                                                                                                                 | Nombre para mostrar de la recompensa (tal como se define en la [configuración de la recompensa](/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Fuente de la recompensa                                                                                                                | Describe qué desencadenó la recompensa (por ejemplo, *Referencia*, *Objetivo*, *Manual*, *API*).                                                                                                     |
| Tipo de Fuel Tank                                                                                                                      | El tipo de fondo de recompensas utilizado (si se usa la integración FuelTank). Por ejemplo, *Prepago*, *Tarjeta regalo*.                                                                             |
| Código de Fuel Tank                                                                                                                    | El código asociado con la entrega externa (por ejemplo, un cupón o código de tarjeta regalo).                                                                                                        |
| ID del programa                                                                                                                        | ID del programa de Advocate bajo el cual se emitió la recompensa.                                                                                                                                    |
| Clave de recompensa del programa                                                                                                       | Identificador interno de la configuración de recompensa específica usada 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ó la emisión de la recompensa (por ejemplo, después de un retraso o período de espera).                                                                                             |
| Fecha otorgada                                                                                                                         | Cuándo se emitió realmente la recompensa al participante.                                                                                                                                            |
| Fecha de caducidad                                                                                                                     | La fecha de vencimiento de la recompensa (si corresponde).                                                                                                                                           |
| Fecha de cancelación                                                                                                                   | La fecha en que la recompensa quedó anulada o cancelada.                                                                                                                                             |
| Fecha canjeada                                                                                                                         | La fecha en que el participante canjeó la recompensa (si corresponde).                                                                                                                               |
| Fecha de modificación                                                                                                                  | La fecha en que se realizó la actualización más reciente al registro de la recompensa.                                                                                                               |
| **Seguimiento de crédito y valor**                                                                                                     |                                                                                                                                                                                                      |
| Crédito asignado                                                                                                                       | La cantidad de crédito asignada a esta recompensa (puede diferir del valor en algunos modelos).                                                                                                      |
| Crédito canjeado                                                                                                                       | La cantidad de crédito que se ha canjeado de la recompensa.                                                                                                                                          |
| Valor disponible                                                                                                                       | La parte restante no utilizada o no canjeada de la recompensa.                                                                                                                                       |
| **Estado y mensajes de la recompensa**                                                                                                 |                                                                                                                                                                                                      |
| Estados                                                                                                                                | Estado actual de la recompensa (por ejemplo, *Pendiente*, *Programada*, *Otorgada*, *Vencido*, *Cancelado*).                                                                                         |
| meta.estado                                                                                                                            | Estado técnico o de nivel de sistema (útil para diagnósticos o manejo de errores).                                                                                                                   |
| meta.mensaje                                                                                                                           | Mensaje vinculado a la entrega de la recompensa (por ejemplo, “La recompensa se entregó correctamente”).                                                                                             |
| meta.mensaje interno                                                                                                                   | Notas solo internas 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 personalizado 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.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 CRM.                                                                                                            |
| **Contexto del referido (si la recompensa se basa en un referido)**                                                                    |                                                                                                                                                                                                      |
| referral.id                                                                                                                            | El ID del referido que desencadenó esta recompensa.                                                                                                                                                  |
| referral.fecha de inicio del referido                                                                                                  | Cuándo comenzó la acción de referido (por ejemplo, un clic o un evento de compartición).                                                                                                             |
| referral.fecha modificada                                                                                                              | Cuándo se actualizó por última vez el registro del referido.                                                                                                                                         |
| referral.código de referido utilizado                                                                                                  | El código que el usuario referido usó para unirse o realizar una acción.                                                                                                                             |
| **Información del usuario referido (amigo)**                                                                                           |                                                                                                                                                                                                      |
| referral.usuario referido.id                                                                                                           | ID de la persona que fue referida (el “amigo”).                                                                                                                                                      |
| referral.usuario referido.id de cuenta                                                                                                 | El ID de cuenta único del referente.                                                                                                                                                                 |
| <p>referral.usuario referido.nombre</p><p>referral.usuario referido.apellido</p><p>referral.usuario referido.correo electrónico</p>    | Los datos básicos de contacto del referente.                                                                                                                                                         |
| **Información del referente (Defensor del cliente)**                                                                                   |                                                                                                                                                                                                      |
| referral.usuario referente.id                                                                                                          | ID de la persona que hizo el referido (el “defensor”).                                                                                                                                               |
| referral.usuario referente.id de cuenta                                                                                                | El ID de cuenta único del referente.                                                                                                                                                                 |
| <p>referral.usuario referente.nombre</p><p>referral.usuario referente.apellido</p><p>referral.usuario referente.correo electrónico</p> | Los datos básicos de contacto del referente.                                                                                                                                                         |
| referral.fecha de conversión                                                                                                           | La fecha en que el referido se convirtió oficialmente (por ejemplo, completó un registro o una compra), lo que desencadenó la recompensa.                                                            |

</details>

#### Historial de referidos

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Se puede encontrar una lista completa de los campos cuando [descargas nuestro CSV de muestra](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) informe de actividad de referidos.

**Referencia de columnas del informe**

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

</details>

#### Saldos de recompensas por usuario

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Se puede encontrar una lista completa de los campos cuando [descargas nuestro CSV de muestra](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) informe de saldos de recompensas.

**Referencia de columnas del informe**

| Columna                          | Descripción                                                                                                                                                                                                   |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante** |                                                                                                                                                                                                               |
| ID de usuario                    | El identificador único del participante dentro de Advocate. Se usa para vincular el saldo de la recompensa con el usuario individual.                                                                         |
| ID de cuenta                     | El ID de cuenta interno asociado con el participante. Especialmente relevante si los usuarios pertenecen a organizaciones o grupos de cuentas segmentados.                                                    |
| Correo electrónico               | La dirección de correo electrónico del participante. A menudo se usa para 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 la personalización o el filtrado durante el procesamiento de recompensas.                                                                                    |
| Código de referido               | El código de referencia asignado al participante. Esto es lo que comparte para referir a otros y rastrear la elegibilidad de la recompensa.                                                                   |
| **Información de la recompensa** |                                                                                                                                                                                                               |
| Tipo                             | La categoría o método de recompensa (p. ej., *Efectivo*, *Tarjeta regalo*, *Puntos*, *Personalizado*). Ayuda a determinar cómo deben 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 de pagos regionales.                                                            |
| 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 coste total del programa asignado a este participante.                                    |
| Crédito total canjeado           | La porción total de recompensas que este participante ya ha canjeado. Útil para auditar los costes reales frente a los pasivos.                                                                               |
| Crédito total caducado           | Recompensas totales que se asignaron al usuario pero caducaron antes de ser canjeadas. Ayuda a hacer un seguimiento de las recompensas no reclamadas o de las oportunidades de entrega perdidas.              |
| **Metadatos del usuario**        |                                                                                                                                                                                                               |
| URL de imagen                    | URL de la imagen de perfil o avatar del participante (si se recopiló). Principalmente estética o usada en paneles para usuarios, si corresponde.                                                              |
| IP vista por primera vez         | La primera dirección IP registrada cuando se añadió al participante o pasó a estar activo. Ú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 involucrado.                                                                                       |
| Fecha de creación                | La fecha en que se creó la cuenta del participante en Advocate. Útil para el análisis de cohortes o del comportamiento de recompensas a lo largo del tiempo.                                                  |
| Fuente de referido               | La fuente o canal original a través del cual se adquirió al participante (p. ej., *correo electrónico*, *orgánico*, *partner*). Ayuda a evaluar el alcance y la eficacia del programa de referidos por canal. |
| Configuración regional           | El idioma y la configuración regional del participante (p. ej., *en-US*, *fr-FR*). Importante para comunicaciones personalizadas u opciones de recompensa regionales.                                         |

</details>

#### Saldos de recompensas disponibles por usuario

El *Saldos de recompensas disponibles por usuario* el informe proporciona una lista de recompensas no canjeadas. Este tipo de informe está pensado para 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

Se puede encontrar una lista completa de los campos cuando [descargas nuestro CSV de muestra](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) en el informe de saldos de recompensas disponibles.

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

**Referencia de columnas del informe**

| Columna                              | Descripción                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**     |                                                                                                                                                                                                                                                                                                                             |
| Nombre                               | El nombre del participante, usado para la identificación o la 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 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 de cuenta interna vinculado al participante.                                                                                                                                                                                                                                                                          |
| Segmentos                            | Etiquetas o categorías usadas para [agrupar participantes](/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (p. ej., *por región*, *etapa del ciclo de vida*, *tipo de cliente*). Útil para filtrar o aplicar distintas reglas de cumplimiento. |
| **Estado y tiempo de la recompensa** |                                                                                                                                                                                                                                                                                                                             |
| Fecha de bloqueo                     | La fecha en que se bloqueó al usuario para recibir recompensas, si corresponde. Un estado de bloqueo 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 recompensa (p. ej., *Efectivo por referidos*, *Crédito de tienda*). Esto ayuda a distinguir entre varios tipos de recompensa 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 recompensa no canjeada actualmente disponible para este participante. Este es el valor principal que se usa al determinar qué pagar.                                                                                                                                                                          |
| Valor a 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. Ofrece información sobre canjes anteriores y puede ser útil para hacer un seguimiento de los límites 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 los participantes y las recompensas obtenidas o pendientes por año.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

**Referencia de columnas del informe**

| Columna                                                                 | Descripción                                                                                                                                                                                                                                         |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                        |                                                                                                                                                                                                                                                     |
| ID de usuario                                                           | El identificador único del participante en Advocate.                                                                                                                                                                                                |
| ID de cuenta                                                            | ID de cuenta interna 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 del W-9**                                          |                                                                                                                                                                                                                                                     |
| <p>Fecha de envío del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | La fecha en que el formulario W-9 del participante se marcó como enviado y recopilado en Advocate. Importante para el cumplimiento del IRS y la verificación del estado de la documentación fiscal.                                                 |
| **Resumen del año fiscal**                                              |                                                                                                                                                                                                                                                     |
| Año                                                                     | El año fiscal en el que el participante obtuvo recompensas. Se usa para agrupar las ganancias por año natural para el procesamiento del 1099.                                                                                                       |
| Valor imponible en EE. UU. en centavos                                  | Valor total de las recompensas sujetas a impuestos en EE. UU. obtenidas por este participante en el año fiscal especificado, expresado en centavos (p. ej., 2500 = 25,00 $). Ayuda con cálculos brutos o integraciones donde se requiere precisión. |
| Valor imponible en EE. UU. en dólares                                   | Igual 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.                                                                                                              |
| Conteo de recompensas                                                   | Número total de instancias individuales de recompensa obtenidas por el participante en el año fiscal especificado. Útil para rastros de auditoría o para entender la frecuencia de las recompensas y la participación en el programa.               |

</details>

#### Pagos e impuestos

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

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* Detalles del participante como nombre, ID de usuario y 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 obtenidas por año fiscal
* Número total de recompensas obtenidas por cada participante en el año fiscal
* El estado del formulario fiscal, p. ej., *válido*, *en espera*, o *pendientes*. Los motivos de retención del pago también se incluyen en el informe

**Referencia de columnas del informe**

| Columna                                                                 | Descripción                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Información del participante**                                        |                                                                                                                                                                                                                                                        |
| ID de usuario                                                           | El identificador único del participante en Advocate.                                                                                                                                                                                                   |
| ID de cuenta                                                            | El ID de cuenta del participante, usado para agrupación o informes organizativos.                                                                                                                                                                      |
| Correo electrónico                                                      | La dirección de correo electrónico del participante.                                                                                                                                                                                                   |
| Nombre                                                                  | El nombre del participante.                                                                                                                                                                                                                            |
| Apellido                                                                | El apellido del participante.                                                                                                                                                                                                                          |
| **Información fiscal del W-9**                                          |                                                                                                                                                                                                                                                        |
| <p>Fecha de envío del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | La fecha en que el participante presentó su formulario W-9 (o el formulario fiscal estadounidense correspondiente). Importante para verificar la elegibilidad fiscal antes de emitir pagos en efectivo.                                                |
| **Resumen del año de pago**                                             |                                                                                                                                                                                                                                                        |
| Año                                                                     | El año natural en el que el participante obtuvo las recompensas.                                                                                                                                                                                       |
| Valor                                                                   | Valor total del pago en unidades menores (p. ej., centavos) obtenido o pendiente para este participante durante el año. Por ejemplo, 1750 = 17,50 $.                                                                                                   |
| Valor en dólares                                                        | El mismo valor, mostrado en formato monetario estándar para una revisión fácil (p. ej., 17,50).                                                                                                                                                        |
| Cuenta                                                                  | Número total de instancias individuales de recompensa 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 de pago                                                       | Indica si los pagos del participante están actualmente retenidos (Sí o No). Los pagos pueden retenerse por formularios fiscales faltantes o configuración incompleta.                                                                                  |
| Motivos de la retención del pago                                        | Explica por qué el participante está en retención de pago (si corresponde). Motivos de ejemplo: *Formulario fiscal faltante*, *No se proporcionó información bancaria*, *Revisión de cumplimiento*.                                                    |
| Moneda del pago                                                         | La moneda en la que se procesan o procesarán los pagos del participante (p. ej., *USD*, *EUR*, *ZAR*). Importante para sistemas de pago globales y contabilidad.                                                                                       |
| Comenzó la configuración del pago                                       | 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.
