> 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 tienen opciones de filtrado para darte mayor control sobre los datos que descargas. Cada informe se puede descargar como un archivo .CSV o de Excel.

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

#### Informe de detalles del usuario

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

<details>

<summary>Detalles del informe</summary>

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

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

Al generar el informe, opcionalmente puedes incluir:

* **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 de 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 al [descargar 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 Advocate.                                                                                                                                                                            |
| ID de cuenta                                                    | El identificador único de la cuenta del participante (usado en varios programas, si corresponde).                                                                                                                                               |
| Correo electrónico                                              | La dirección de correo electrónico del participante.                                                                                                                                                                                            |
| Nombre                                                          | El nombre del participante.                                                                                                                                                                                                                     |
| Apellido                                                        | El apellido del participante.                                                                                                                                                                                                                   |
| Hash del correo electrónico                                     | Una versión con hash (cifrada) del correo electrónico del participante, útil para la coincidencia compatible con la privacidad con otros sistemas.                                                                                              |
| **Información de referidos y para compartir**                   |                                                                                                                                                                                                                                                 |
| Código de referido                                              | El código único vinculado al participante, utilizado para rastrear los referidos que genera.                                                                                                                                                    |
| Enlace para compartir                                           | El enlace de referido único asociado con el participante.                                                                                                                                                                                       |
| Enlace para compartir en Facebook                               | Un enlace pregenerado para compartir el referido en Facebook.                                                                                                                                                                                   |
| Enlace para compartir en Twitter                                | Un enlace pregenerado para compartir el referido en Twitter.                                                                                                                                                                                    |
| Enlace para compartir por correo electrónico                    | Un enlace pregenerado para compartir el referido por correo electrónico.                                                                                                                                                                        |
| Enlace para compartir en LinkedIn                               | Un enlace pregenerado para compartir el referido en LinkedIn.                                                                                                                                                                                   |
| Enlace limpio para compartir                                    | Una versión del enlace de referido sin parámetros de seguimiento; más neutral para ciertas plataformas o casos de uso.                                                                                                                          |
| **Geolocalización y configuración regional**                    |                                                                                                                                                                                                                                                 |
| IP vista por primera vez                                        | La dirección IP desde la que se registró por primera vez al participante.                                                                                                                                                                       |
| Última IP vista                                                 | La dirección IP más reciente 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 envió un formulario fiscal de EE. UU. para cumplimiento o procesamiento de recompensas.                                                                                                                     |
| **Estadísticas del usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                                                 |
| stats.fecha Modificada                                          | La última fecha en que se actualizaron las estadísticas del participante.                                                                                                                                                                       |
| stats.tráfico                                                   | Número total de visitas generadas por la actividad de referido del participante.                                                                                                                                                                |
| stats.referidos                                                 | Número total de referidos exitosos realizados por el participante.                                                                                                                                                                              |
| stats.conversiones                                              | Número total de conversiones (por ejemplo, compras, registros) que resultaron de esos referidos.                                                                                                                                                |
| stats.objetivos                                                 | Número de cumplimientos de objetivos específicos asociados con la actividad de referido del participante (definidos de forma personalizada en el programa).                                                                                     |
| stats.recompensas                                               | Número total de recompensas que ha ganado el participante.                                                                                                                                                                                      |
| stats.cargas del widget                                         | Número de veces que el widget de referido o la interfaz para compartir fue cargada por este participante.                                                                                                                                       |
| stats.ingresos                                                  | Ingresos totales generados por los usuarios que fueron referidos por este participante.                                                                                                                                                         |
| stats.ingresos generados                                        | Sinónimo de stats.revenue; algunos informes pueden diferenciarlo 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, precedida por campos personalizados. |
| **Otro**                                                        |                                                                                                                                                                                                                                                 |
| Origen del referido                                             | La fuente o canal original que llevó al participante a tu programa (por ejemplo, *orgánico*, *correo electrónico*, *sitio asociado*).                                                                                                           |

</details>

#### Exportación de eventos de usuario

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

* ID del evento
* Clave del evento
* ID de usuario y de cuenta
* Fecha desencadenada
* Fecha recibida
* Fecha procesada

**Referencia de columnas del informe**

| Columna                                                                           | Descripción                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del evento y del usuario**                                          |                                                                                                                                                                                                                 |
| ID del evento                                                                     | Un ID único generado para cada evento recibido. Útil para el seguimiento, la depuración o la auditoría de envíos de eventos.                                                                                    |
| Clave del evento                                                                  | El tipo o 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 del evento desencadenado – AAAA-MM-DD                                       | La fecha en que realmente ocurrió el evento (según lo informado por tu sistema). Por ejemplo, la fecha en que tuvo lugar una compra o un registro.                                                              |
| Fecha del evento recibida – AAAA-MM-DD                                            | La fecha en que Advocate recibió el evento de tu sistema. Puede diferir de la fecha desencadenada debido al procesamiento por lotes o a retrasos del sistema.                                                   |
| Fecha del evento procesada – AAAA-MM-DD                                           | La fecha en que el evento se procesó y almacenó correctamente en Advocate. Indica cuándo el evento pasó a estar disponible para seguimiento, recompensas o informes.                                            |
| **Campos de datos del evento (si se incluyen en las cargas útiles de tu evento)** |                                                                                                                                                                                                                 |
| fields.cupón                                                                      | Cualquier cupón o código de descuento aplicado durante el evento, si se envió en los datos del evento. Útil para rastrear el uso de incentivos o desencadenantes de promociones específicas.                    |
| fields.ingresos                                                                   | El importe de ingresos asociado con el evento. Normalmente se utiliza en eventos de compra para calcular el rendimiento, las recompensas o el ROI.                                                              |
| fields.moneda                                                                     | El código de moneda (por ejemplo, *USD*, *ZAR*, *EUR*) vinculado al importe de ingresos. Importante al informar entre regiones o al calcular recompensas ajustadas al 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 envió como parte del evento. Ayuda a conectar los eventos del usuario con las fechas de adquisición originales o los registros del CRM. |

</details>

#### Historial de recompensas

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

<details>

<summary>Detalles del informe</summary>

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

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

Se puede 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) de los informes de detalles de recompensas.

Al generar el informe, opcionalmente puedes incluir:

* **Detalles del participante** como nombre, ID de usuario y de cuenta, dirección de correo electrónico, campos personalizados, segmentos e información de 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 (según 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)). |
| Origen de la recompensa                                                                                            | Describe qué desencadenó la recompensa (por ejemplo, *Referencia*, *Objetivo*, *Manual*, *API*).                                                                                                  |
| Tipo de Fuel Tank                                                                                                  | El tipo de fondo de recompensa utilizado (si se usa la integración de FuelTank). Por ejemplo, *Prepago*, *Tarjeta regalo*.                                                                        |
| Código de tanque de combustible                                                                                    | El código asociado con el cumplimiento externo (por ejemplo, un cupón o un código de tarjeta regalo).                                                                                             |
| ID del programa                                                                                                    | ID del programa Advocate bajo el cual se emitió la recompensa.                                                                                                                                    |
| Clave de recompensa del programa                                                                                   | Identificador interno de la configuración específica de recompensa utilizada dentro del programa.                                                                                                 |
| Clave de recompensa global                                                                                         | Identificador entre programas para recompensas configuradas a nivel global (si corresponde).                                                                                                      |
| **Marcas de tiempo de la recompensa**                                                                              |                                                                                                                                                                                                   |
| Fecha de creación                                                                                                  | Cuándo se creó el registro de la recompensa en el sistema.                                                                                                                                        |
| Fecha programada para                                                                                              | Cuándo se programó la emisión de la recompensa (por ejemplo, después de un retraso o período de espera).                                                                                          |
| Fecha de otorgamiento                                                                                              | Cuándo se emitió realmente la recompensa al participante.                                                                                                                                         |
| Fecha de vencimiento                                                                                               | La fecha de vencimiento de la recompensa (si corresponde).                                                                                                                                        |
| Fecha de cancelación                                                                                               | La fecha en la que la recompensa fue anulada o cancelada.                                                                                                                                         |
| Fecha de canje                                                                                                     | La fecha en la que el participante canjeó la recompensa (si corresponde).                                                                                                                         |
| Fecha modificada                                                                                                   | La fecha en la 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 de la recompensa que no se ha usado ni canjeado.                                                                                                                                |
| **Estado y mensajería de la recompensa**                                                                           |                                                                                                                                                                                                   |
| Estados                                                                                                            | Estado actual de la recompensa (por ejemplo, *Pendiente*, *Programada*, *Otorgada*, *Caducado*, *Cancelado*).                                                                                     |
| meta.estado                                                                                                        | Estado técnico o a nivel de sistema (útil para diagnósticos o manejo de errores).                                                                                                                 |
| meta.mensaje                                                                                                       | Mensaje vinculado a la entrega de la recompensa (por ejemplo, “Recompensa entregada correctamente”).                                                                                              |
| meta.mensaje interno                                                                                               | Notas de uso interno 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.account Id                                                                                                    | El ID de cuenta asociado del usuario en Advocate.                                                                                                                                                 |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Información básica del participante incluida como referencia o para coincidencia con CRM.                                                                                                         |
| **Contexto de referido (si la recompensa se basa en referidos)**                                                   |                                                                                                                                                                                                   |
| 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 compartir).                                                                                                             |
| referral.fecha modificada                                                                                          | Cuándo se actualizó por última vez el registro del referido.                                                                                                                                      |
| referral.código de referido usado                                                                                  | El código que usó el usuario referido para unirse o realizar una acción.                                                                                                                          |
| **Información del usuario referido (amigo)**                                                                       |                                                                                                                                                                                                   |
| referral.referred User.id                                                                                          | ID de la persona que fue referida (el “amigo”).                                                                                                                                                   |
| referral.referred User.account Id                                                                                  | El ID de cuenta único del referente.                                                                                                                                                              |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Los datos básicos de contacto del referente.                                                                                                                                                      |
| **Información del referente (Advocate)**                                                                           |                                                                                                                                                                                                   |
| referral.referrer User.id                                                                                          | ID de la persona que hizo el referido (el “defensor”).                                                                                                                                            |
| referral.referrer User.account Id                                                                                  | El ID de cuenta único del referente.                                                                                                                                                              |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</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, al completar el registro o la compra), desencadenando la recompensa.                                                          |

</details>

#### Historial de referidos

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Se puede encontrar una lista completa de los campos al [descargar 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 modificada                                                                                                        | La fecha más reciente en la que se actualizó cualquier parte del registro de referido.                                                |
| Fecha de inicio del referido                                                                                            | Cuándo se inició por primera vez el referido (por ejemplo, cuando el usuario referido hizo clic en un enlace de referido).            |
| Fecha de conversión                                                                                                     | Cuándo se convirtió el referido, normalmente cuando el usuario referido completó la acción requerida (como un registro o una compra). |
| Fecha de modificación del usuario                                                                                       | La última vez que se actualizaron los datos del usuario implicado 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 más reciente actividad 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 Advocate.                                                                               |
| Cuenta referida                                                                                                         | ID interno de la cuenta vinculado al usuario referido (usado en programas con múltiples 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 más reciente actividad del referente.                                                      |
| URL de la imagen del usuario referente                                                                                  | La URL de la imagen o avatar del referente.                                                                                           |
| Configuración regional del usuario referente                                                                            | Configuración regional del referente.                                                                                                 |
| Fecha de creación del usuario referente                                                                                 | Cuando el referente se unió por primera vez o fue registrado en el sistema.                                                           |
| Usuario referente                                                                                                       | ID interno del referente en Advocate.                                                                                                 |
| Cuenta del referente                                                                                                    | ID de cuenta asociado con el referente.                                                                                               |
| **Moderación y estado**                                                                                                 |                                                                                                                                       |
| Estado de moderación                                                                                                    | Estado general de moderación de la recomendación. (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 recomendación                                                                                       | Cuando se pagó cualquier recompensa asociada por la recomendación.                                                                    |
| Fecha de finalización de la recomendación                                                                               | Cuando el registro de la recomendación se cerró oficialmente (p. ej., debido a caducidad o finalización).                             |
| Estado de moderación del recomendado                                                                                    | Estado de moderación específico de la parte del usuario recomendado en la recomendación.                                              |
| Estado de moderación del recomendador                                                                                   | Estado de moderación específico de la parte del recomendador en la recomendación.                                                     |
| **Referencias de recompensa**                                                                                           |                                                                                                                                       |
| Recompensa del recomendado                                                                                              | El ID o referencia de la recompensa emitida al usuario recomendado (si corresponde).                                                  |
| Recompensa del recomendador                                                                                             | El ID o referencia de la recompensa emitida al recomendador (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 referencias. Este informe se usa a menudo 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 seguimiento de cuánto pagó su programa de referencias en un período determinado.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Se puede encontrar una lista completa de los campos al [descargar 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 recompensas con el usuario individual.                                                                                   |
| ID de cuenta                     | El ID interno de la cuenta asociado al 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 recomendar a otros y hacer seguimiento de la elegibilidad para recompensas.                                                            |
| **Información de la recompensa** |                                                                                                                                                                                                                       |
| Tipo                             | La categoría o método de recompensa (p. ej., *Efectivo*, *Tarjeta 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 por región.                                                                    |
| Importe                          | El saldo total disponible de las 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 le ha asignado a este usuario en cualquier momento (independientemente del canje). Refleja el coste total del programa asignado a este participante.                               |
| Crédito total canjeado           | La parte total de las recompensas que este participante ya ha canjeado. Útil para auditar los costes reales frente a las obligaciones.                                                                                |
| Crédito total caducado           | Recompensas totales que se asignaron al usuario pero caducaron antes de ser canjeadas. Ayuda a hacer seguimiento de recompensas no reclamadas o oportunidades de entrega perdidas.                                    |
| **Metadatos del usuario**        |                                                                                                                                                                                                                       |
| URL de la imagen                 | URL de la imagen de perfil o avatar del participante (si se recopiló). Principalmente estética o usada en paneles de usuario, si corresponde.                                                                         |
| IP vista por primera vez         | La primera dirección IP registrada cuando se añadió al participante o se volvió activo. Útil para cumplimiento, etiquetado de ubicación o análisis de fraude.                                                         |
| Última IP vista                  | La dirección IP más reciente asociada al participante. Ayuda a determinar si el usuario sigue activo o comprometido.                                                                                                  |
| Fecha de creación                | La fecha en que se creó la cuenta del participante en Advocate. Útil para análisis de cohortes o del comportamiento de recompensas a lo largo del tiempo.                                                             |
| Origen del referido              | La fuente o el 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 efectividad del programa de referencias por canal. |
| Configuración regional           | El idioma y la configuración regional del participante (p. ej., *en-US*, *fr-FR*). Importante para comunicaciones personalizadas o opciones de recompensa regionales.                                                 |

</details>

#### Saldos de recompensas disponibles por usuario

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

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

Se puede encontrar una lista completa de los campos al [descargar 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, Fuel Tank o tarjeta regalo. Use el *Saldos de recompensas por usuario* informe para obtener más detalles sobre estos tipos de recompensas.
{% endhint %}

**Referencia de columnas del informe**

| Columna                               | Descripción                                                                                                                                                                                                                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**      |                                                                                                                                                                                                                                                                                                                            |
| Nombre                                | El nombre del participante, usado para identificación o personalización durante el procesamiento de recompensas.                                                                                                                                                                                                           |
| Apellido                              | El apellido del participante.                                                                                                                                                                                                                                                                                              |
| Correo electrónico                    | La dirección de correo electrónico del participante, usada para enviar recompensas o coincidir con sistemas externos como un CRM o un proveedor de recompensas.                                                                                                                                                            |
| ID de usuario                         | El identificador único asignado al participante dentro de Advocate.                                                                                                                                                                                                                                                        |
| ID de cuenta                          | El ID interno de la cuenta vinculado al participante.                                                                                                                                                                                                                                                                      |
| Segmentos                             | Etiquetas o categorías usadas para [agrupar participantes](/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (p. ej., *por región*, *por etapa del ciclo de vida*, *tipo de cliente*). Útil para filtrar o aplicar distintas reglas de entrega. |
| **Estado y momento de la recompensa** |                                                                                                                                                                                                                                                                                                                            |
| Fecha de bloqueo                      | La fecha en que se bloqueó al usuario para recibir recompensas, si corresponde. Un estado bloqueado puede impedir el canje; este campo indica cuándo se aplicó ese bloqueo.                                                                                                                                                |
| **Datos de recompensa**               |                                                                                                                                                                                                                                                                                                                            |
| Nombre de la unidad                   | La etiqueta o nombre visible de la unidad de recompensa (p. ej., *Efectivo por recomendación*, *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 la recompensa no canjeada actualmente disponible para este participante. Este es el valor principal que se usa al determinar qué pagar.                                                                                                                                                                      |
| Valor para canjear                    | El valor actualmente en cola para canje (p. ej., pendiente en una entrega masiva o a la espera de procesamiento). Útil para evitar dobles canjes 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 una visión de los canjes anteriores y puede ser útil para hacer seguimiento de límites de recompensas                                                                                                                                       |
| Unidad                                | El código interno o del sistema para la unidad de recompensa (p. ej., *USD*, *puntos*, etc.). Puede 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 ganadas o pendientes por año.

<details>

<summary>Detalles del informe</summary>

De forma predeterminada, el informe incluye:

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

**Referencia de columnas del informe**

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

</details>

#### Pagos y impuestos

El *Pago e impuestos* el informe muestra el estado fiscal de los participantes y las recompensas ganadas 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
* La fecha en que el formulario fiscal del participante — como un W-8 o W-9 — se marcó como enviado
* Valor imponible en EE. UU. de las recompensas ganadas 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 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 de EE. UU. correspondiente). Importante para verificar la elegibilidad fiscal antes de emitir pagos en efectivo.                                                    |
| **Resumen del año de pago**                                             |                                                                                                                                                                                                                                                        |
| Año                                                                     | El año calendario en el que el participante obtuvo las recompensas.                                                                                                                                                                                    |
| Valor                                                                   | Valor total del pago en unidades menores (p. ej., centavos) ganado o pendiente para este participante durante el año. Por ejemplo, 1750 = $17.50.                                                                                                      |
| Valor en dólares                                                        | El mismo valor, mostrado en formato monetario estándar para facilitar la revisión (p. ej., 17.50).                                                                                                                                                     |
| Cantidad                                                                | Número total de instancias individuales de recompensa de pago para el participante en el año especificado. Útil para comprender con qué frecuencia un participante obtuvo pagos.                                                                       |
| **Elegibilidad y estado del pago**                                      |                                                                                                                                                                                                                                                        |
| Retención de pago                                                       | Indica si los pagos del participante están actualmente retenidos (Sí o No). Los pagos pueden retenerse debido a formularios fiscales faltantes o a una configuración incompleta.                                                                       |
| Motivos de retención del pago                                           | Explica por qué el participante tiene retenido el pago (si corresponde). Ejemplos de motivos: *Formulario fiscal faltante*, *No se proporcionó la 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 globales de pago y contabilidad.                                                                                       |
| Configuración de pago iniciada                                          | Indica si el participante ha comenzado a configurar su método de pago (p. ej., mediante una integración con un proveedor de pagos). Ayuda a hacer seguimiento del progreso de incorporación o de las necesidades de seguimiento para pagos pendientes. |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation 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.
