# Explicación de informes del programa Advocate

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

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

Este artículo explica los diferentes informes y qué tipo de datos incluye cada uno. Consulta [Ejecutar un informe de programa Advocate](https://help.impact.com/brand/es/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) para obtener instrucciones sobre cómo generar un informe.

#### Informe de detalles de usuario

El *informe de detalles de usuario* contiene información detallada sobre cada participante 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>

Por defecto, 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 de usuario**, incluyendo información analítica sobre el participante como tráfico, ingresos y más.
* **Enlaces y códigos para compartir de referencia**, si corresponde. Esta información puede ser útil para actualizar registros de contacto en tu CMS o sistema de correo electrónico para incluir los enlaces y códigos para compartir de cada participante en Advocate.

Se puede encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](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 detalles de 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 múltiples 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 hash (encriptada) del correo electrónico del participante, útil para coincidencias compatibles con la privacidad con otros sistemas.                                                                                    |
| **Información de referencia y para compartir**                 |                                                                                                                                                                                                                                     |
| Código de referencia                                           | El código único vinculado al participante, usado para rastrear las referencias que genera.                                                                                                                                          |
| Enlace para compartir                                          | El enlace de referencia único asociado con el participante.                                                                                                                                                                         |
| Enlace para compartir en Facebook                              | Un enlace pregenerado para compartir la referencia en Facebook.                                                                                                                                                                     |
| Enlace para compartir en Twitter                               | Un enlace pregenerado para compartir la referencia en Twitter.                                                                                                                                                                      |
| Enlace para compartir por correo electrónico                   | Un enlace pregenerado para compartir la referencia por correo electrónico.                                                                                                                                                          |
| Enlace para compartir en LinkedIn                              | Un enlace pregenerado para compartir la referencia en LinkedIn.                                                                                                                                                                     |
| Enlace limpio para compartir                                   | Una versión del enlace de referencia sin parámetros de seguimiento; más 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.                                                                                                                                                           |
| IP vista por última vez                                        | La dirección IP más reciente registrada para este participante.                                                                                                                                                                     |
| Configuración regional (Locale)                                | El idioma y la configuración regional preferidos 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 de usuario (si se incluyen en la exportación)** |                                                                                                                                                                                                                                     |
| stats.date Modified                                            | La última fecha en la que se actualizaron las estadísticas del participante.                                                                                                                                                        |
| stats.traffic                                                  | Número total de visitas generadas por la actividad de referencia del participante.                                                                                                                                                  |
| stats.referrals                                                | Número total de referencias exitosas realizadas por el participante.                                                                                                                                                                |
| stats.conversions                                              | Número total de conversiones (p. ej., compras, registros) que resultaron de esas referencias.                                                                                                                                       |
| stats.goals                                                    | Número de cumplimientos de objetivos específicos asociados con la actividad de referencia del participante (definidos de forma personalizada en el programa).                                                                       |
| stats.rewards                                                  | Número total de recompensas que el participante ha obtenido.                                                                                                                                                                        |
| stats.widget Loads                                             | Número de veces que se cargó el widget de referencia o la interfaz de compartición por este participante.                                                                                                                           |
| stats.revenue                                                  | Ingresos totales generados por usuarios que fueron referidos por este participante.                                                                                                                                                 |
| stats.generated Revenue                                        | Sinónimo de stats.revenue; algunos informes pueden diferenciar si los ingresos provienen de múltiples fuentes.                                                                                                                      |
| stats.referred Revenue                                         | Ingresos atribuidos específicamente a participantes que se registraron o compraron a través del enlace de referencia de este participante.                                                                                          |
| **Datos personalizados**                                       |                                                                                                                                                                                                                                     |
| custom Fields.example                                          | Un marcador de posición para cualquier campo personalizado definido por tu programa (p. ej., *ID de fidelidad*, *notas internas*, *etiqueta de región*). Cada campo aparecerá como su propia columna, con el prefijo custom Fields. |
| **Otros**                                                      |                                                                                                                                                                                                                                     |
| Fuente de referencia                                           | La fuente o canal original que llevó al participante a tu programa (p. ej., *orgánico*, *correo electrónico*, *sitio asociado*).                                                                                                    |

</details>

#### Exportación de eventos de usuario

El *Exportación de eventos de usuario* 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 limitar un rango de tiempo, clave de evento, ID de usuario y más.

<details>

<summary>Detalles del informe</summary>

Por defecto, el informe incluye:

* ID de evento
* Clave de evento
* ID de usuario y de cuenta
* Fecha activada
* Fecha recibida
* Fecha procesada

**Referencia de columnas del informe**

| Columna                                                                           | Descripción                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del evento y del usuario**                                          |                                                                                                                                                                                                               |
| ID de evento                                                                      | Un ID único generado para cada evento recibido. Útil para rastreo, depuración o auditoría de envíos de eventos.                                                                                               |
| Clave de evento                                                                   | El tipo o etiqueta del evento, como `compra`, `registro`, o cualquier clave personalizada que tu sistema envíe.                                                                                               |
| ID de usuario                                                                     | El identificador único del participante en Advocate con el que se asocia el evento.                                                                                                                           |
| ID de cuenta                                                                      | El ID de cuenta vinculado al usuario, especialmente relevante en programas donde los usuarios pueden pertenecer a diferentes estructuras de cuenta.                                                           |
| **Marcas de tiempo del evento**                                                   |                                                                                                                                                                                                               |
| Fecha de activación del evento – AAAA-MM-DD                                       | La fecha en que el evento realmente ocurrió (según lo informado por tu sistema). Por ejemplo, la fecha en que se realizó una compra o un registro.                                                            |
| Fecha de recepción del evento – AAAA-MM-DD                                        | La fecha en que Advocate recibió el evento de tu sistema. Puede diferir de la fecha de activación debido a procesamiento por lotes o demoras del sistema.                                                     |
| Fecha de procesamiento del evento – AAAA-MM-DD                                    | La fecha en que el evento se procesó y almacenó correctamente en Advocate. Marca cuando el evento se volvió utilizable para seguimiento, recompensas o informes.                                              |
| **Campos de datos del evento (si se incluyen en las cargas útiles de tu evento)** |                                                                                                                                                                                                               |
| fields.coupon                                                                     | Cualquier cupón o código de descuento aplicado durante el evento, si se envía en los datos del evento. Útil para rastrear el uso de incentivos o activadores de promociones específicas.                      |
| fields.revenue                                                                    | La cantidad de ingresos asociada con el evento. Normalmente se usa en eventos de compra para calcular rendimiento, recompensas o ROI.                                                                         |
| fields.currency                                                                   | El código de moneda (p. ej., *USD*, *ZAR*, *EUR*) asociado con el monto de ingresos. Importante al informar entre regiones o calcular recompensas ajustadas por cambio.                                       |
| fields.lead Created Date                                                          | La fecha original en que el lead (usuario) fue creado en tu sistema, si se envió como parte del evento. Ayuda a conectar los eventos de usuario con las fechas de adquisición originales o registros del CRM. |

</details>

#### Historial de recompensas

El *Historial de recompensas* informe proporciona un registro detallado de cada una de tus recompensas y las relaciones con participantes y referencias. 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>

Por defecto, el informe incluirá **campos de recompensa** información como:

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

Una lista completa de los campos incluidos se puede encontrar al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](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 ejemplo](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, 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 referencia (si corresponde).
* **Campos de referencia** como ID de referencia, campos del defensor 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 (p. ej. *Efectivo*, *Tarjeta regalo*, *Cupón*, *Personalizado*).                                                                                   |
| Valor                                                                                                              | El valor numérico de la recompensa (p. ej., 10, 100, etc.).                                                                                                                          |
| Unidad                                                                                                             | La unidad asociada con el valor (p. ej., *USD*, *puntos*, *ZAR*, *%*).                                                                                                               |
| Nombre                                                                                                             | Nombre para mostrar de la recompensa (según lo definido en la [configuración de la recompensa](https://help.impact.com/brand/es/advocate-program/advocate-rewards/create-a-reward)). |
| Fuente de la recompensa                                                                                            | Describe qué desencadenó la recompensa (p. ej., *Referencia*, *Objetivo*, *Manual*, *API*).                                                                                          |
| Tipo de Fuel Tank                                                                                                  | El tipo de fondo de recompensa utilizado (si se usa la integración FuelTank). Por ejemplo, *Prepago*, *Tarjeta regalo*.                                                              |
| Código de Fuel Tank                                                                                                | El código asociado con el cumplimiento externo (p. ej., código de vale o tarjeta regalo).                                                                                            |
| ID de programa                                                                                                     | ID del programa Advocate bajo el cual se emitió la recompensa.                                                                                                                       |
| Clave de recompensa del programa                                                                                   | Identificador interno para la configuración específica de la recompensa utilizada dentro del programa.                                                                               |
| Clave global de recompensa                                                                                         | Identificador entre programas para recompensas configuradas a nivel global (si corresponde).                                                                                         |
| **Marcas de tiempo de la recompensa**                                                                              |                                                                                                                                                                                      |
| Fecha de creación                                                                                                  | Cuando se creó el registro de la recompensa en el sistema.                                                                                                                           |
| Fecha programada                                                                                                   | Cuando la recompensa estaba programada para emitirse (p. ej., después de un retraso o periodo de espera).                                                                            |
| Fecha otorgada                                                                                                     | Cuando la recompensa fue realmente emitida al participante.                                                                                                                          |
| Fecha de expiración                                                                                                | La fecha de expiración de la recompensa (si corresponde).                                                                                                                            |
| Fecha cancelada                                                                                                    | La fecha en la que la recompensa fue anulada o cancelada.                                                                                                                            |
| Fecha canjeada                                                                                                     | 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 porción restante sin usar o no canjeada de la recompensa.                                                                                                                         |
| **Estado y mensajería de la recompensa**                                                                           |                                                                                                                                                                                      |
| Estados                                                                                                            | Estado actual de la recompensa (p. ej., *Pendiente*, *Programada*, *Otorgada*, *Expirada*, *Cancelada*).                                                                             |
| meta.status                                                                                                        | Estado técnico o a nivel de sistema (útil para diagnósticos o manejo de errores).                                                                                                    |
| meta.message                                                                                                       | Mensaje vinculado a la entrega de la recompensa (p. ej., “Recompensa entregada con éxito”).                                                                                          |
| meta.internal Message                                                                                              | Notas internas solo para administradores (p. ej., explicaciones de fallos o indicadores).                                                                                            |
| meta.date Modified                                                                                                 | Última vez que se actualizó la metadata relacionada 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 al usuario en Advocate.                                                                                                                                     |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Información básica del participante incluida como referencia o para coincidencia con CRM.                                                                                            |
| **Contexto de la referencia (si la recompensa se basa en una referencia)**                                         |                                                                                                                                                                                      |
| referral.id                                                                                                        | El ID de la referencia que desencadenó esta recompensa.                                                                                                                              |
| referral.date Referral Started                                                                                     | Cuando comenzó la acción de referencia (p. ej., clic o evento de compartición).                                                                                                      |
| referral.date Modified                                                                                             | Cuando se actualizó por última vez el registro de la referencia.                                                                                                                     |
| referral.referral Code Used                                                                                        | El código que el usuario referido usó 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 referido.                                                                                                                                                  |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Los datos de contacto básicos del referido.                                                                                                                                          |
| **Información del referidor (Advocate)**                                                                           |                                                                                                                                                                                      |
| referral.referrer User.id                                                                                          | ID de la persona que hizo la referencia (el “defensor”).                                                                                                                             |
| referral.referrer User.account Id                                                                                  | El ID de cuenta único del referido.                                                                                                                                                  |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Los datos de contacto básicos del referido.                                                                                                                                          |
| referral.date Converted                                                                                            | La fecha en la que la referencia se convirtió oficialmente (p. ej., registro o compra completada), activando la recompensa.                                                          |

</details>

#### Historial de referencias

El *Historial de referencias* informe proporciona un registro del estado de cada conexión de referencia realizada en tu programa de referencias. Esta información puede ser útil al verificar el éxito de tu programa y rastrear la cantidad de nuevos clientes que ha aportado tu programa.

<details>

<summary>Detalles del informe</summary>

Por defecto, 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 cliente como nombre, ID de usuario y de cuenta, dirección de correo electrónico y más
* Estado de la referencia
* Estado de moderación
* IDs de recompensa

Se puede encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](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 referencias.

**Referencia de columnas del informe**

| Columna                                                                                                                 | Descripción                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadatos de la referencia**                                                                                          |                                                                                                                                         |
| ID                                                                                                                      | Identificador único del registro de la referencia en Advocate.                                                                          |
| Fecha modificada                                                                                                        | La fecha más reciente en la que se actualizó cualquier parte del registro de la referencia.                                             |
| Fecha de inicio de la referencia                                                                                        | Cuando la referencia se inició por primera vez (p. ej., cuando el usuario referido hizo clic en un enlace de referencia).               |
| Fecha de conversión                                                                                                     | Cuando la referencia 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 involucrado en esta referencia (referidor o referido).                          |
| ID de programa                                                                                                          | El ID del programa de referencias de Advocate al que pertenece esta referencia.                                                         |
| Nombre del programa                                                                                                     | El nombre del programa de referencias, útil si gestionas múltiples programas.                                                           |
| **Información del amigo referido (nuevo cliente)**                                                                      |                                                                                                                                         |
| <p>Correo electrónico del usuario referido</p><p>Nombre del usuario referido</p><p>Apellido del usuario referido</p>    | Información básica de identidad del usuario referido.                                                                                   |
| Código de referencia del usuario referido                                                                               | El código de referencia asignado al usuario referido (en caso de que también pueda referir a otros más adelante).                       |
| <p>IP vista por primera vez del usuario referido</p><p>IP vista por última vez del usuario referido</p>                 | Direcciones IP registradas en la primera y en la actividad más reciente del usuario referido.                                           |
| URL de imagen del usuario referido                                                                                      | URL de imagen o avatar, si se capturó o asignó al usuario referido.                                                                     |
| Configuración regional del usuario referido                                                                             | Configuración de idioma/región (p. ej., *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 vinculada al usuario referido (usado en programas con varias cuentas).                                          |
| **Información del referidor (defensor cliente)**                                                                        |                                                                                                                                         |
| <p>Correo electrónico del usuario referidor</p><p>Nombre del usuario referidor</p><p>Apellido del usuario referidor</p> | Información básica de identidad del participante que refiere.                                                                           |
| Código de referencia del usuario referidor                                                                              | El código de referencia perteneciente al referidor, el código que probablemente usó el usuario referido.                                |
| <p>IP vista por primera vez del usuario referidor</p><p>IP vista por última vez del usuario referidor</p>               | Direcciones IP registradas en la primera y en la actividad más reciente del referidor.                                                  |
| URL de imagen del usuario referidor                                                                                     | La URL de la imagen o avatar del referidor.                                                                                             |
| Configuración regional del usuario referidor                                                                            | Configuración regional del referidor.                                                                                                   |
| Fecha de creación del usuario referidor                                                                                 | Cuando el referidor se unió por primera vez o fue registrado en el sistema.                                                             |
| Usuario referidor                                                                                                       | ID interno del referidor en Advocate.                                                                                                   |
| Cuenta del referidor                                                                                                    | ID de cuenta asociado con el referidor.                                                                                                 |
| **Moderación y estado**                                                                                                 |                                                                                                                                         |
| Estado de moderación                                                                                                    | Estado general de moderación de la referencia. (Por ejemplo, *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                                                                                          | Cuando se pagó cualquier recompensa asociada a la referencia.                                                                           |
| Fecha de finalización de la referencia                                                                                  | Cuando el registro de la referencia se cerró oficialmente (p. ej., por expiración o finalización).                                      |
| Estado de moderación del referido                                                                                       | Estado de moderación específico para la parte del usuario referido en la referencia.                                                    |
| Estado de moderación del referidor                                                                                      | Estado de moderación específico para la parte del referidor en la referencia.                                                           |
| **Referencias de recompensa**                                                                                           |                                                                                                                                         |
| Recompensa del referido                                                                                                 | El ID de la recompensa o referencia emitida al usuario referido (si corresponde).                                                       |
| Recompensa del referidor                                                                                                | El ID de la recompensa o referencia emitida al referidor (si corresponde).                                                              |

</details>

#### Saldos de recompensa por usuario

El *Saldos de recompensa por usuario* informe proporciona un registro de recompensas pendientes, incluido el valor y el destinatario previsto, que se generaron a través de tu programa de referencias. Este informe se usa a menudo como parte del cumplimiento manual de recompensas, o como parte de un proceso por lotes a un sistema como Tango Card. También puede ser útil para rastrear cuánto pagó tu programa de referencias en un periodo de tiempo determinado.

<details>

<summary>Detalles del informe</summary>

Por defecto, 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
* Monto de la recompensa

Se puede encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) informe de saldos de recompensa.

**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 al 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 el cumplimiento 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 filtrado durante el procesamiento de recompensas.                                                                                          |
| Código de referencia             | El código de referencia asignado al participante. Esto es lo que comparte para referir a otros y rastrear la elegibilidad para recompensas.                                                                      |
| **Información de la recompensa** |                                                                                                                                                                                                                  |
| Tipo                             | La categoría o método de recompensa (p. ej., *Efectivo*, *Tarjeta regalo*, *Puntos*, *Personalizado*). Ayuda a determinar cómo deben cumplirse o agruparse las recompensas.                                      |
| Unidad                           | La unidad del valor de la recompensa (p. ej., *USD*, *ZAR*, *Puntos*, *%*). Importante para calcular saldos y para el manejo regional de pagos.                                                                  |
| Cantidad                         | El saldo total disponible de recompensas pendientes para este usuario. Esta es la cifra central utilizada al preparar pagos o exportaciones.                                                                     |
| Crédito total asignado           | La cantidad total de crédito que se le ha asignado a este usuario (independientemente del canje). Refleja el costo total del programa asignado a este participante.                                              |
| Crédito total canjeado           | La porción total de recompensas que este participante ya ha canjeado. Útil para auditar costos reales frente a pasivos.                                                                                          |
| Crédito total caducado           | Recompensas totales que se asignaron al usuario pero caducaron antes de ser canjeadas. Ayuda a rastrear recompensas no reclamadas u oportunidades de cumplimiento perdidas.                                      |
| **Metadatos del usuario**        |                                                                                                                                                                                                                  |
| URL de imagen                    | URL de la imagen de perfil o avatar del participante (si se recopiló). Principalmente estético o usado en paneles dirigidos al usuario, si corresponde.                                                          |
| IP vista por primera vez         | La primera dirección IP registrada cuando el participante fue añadido o se activó. Útil para cumplimiento, etiquetado de ubicación o análisis de fraude.                                                         |
| IP vista por última vez          | La dirección IP más reciente asociada con el participante. Ayuda a determinar si el usuario sigue activo o comprometido.                                                                                         |
| Fecha de creación                | La fecha en que se creó la cuenta del participante en Advocate. Útil para análisis por cohortes o comportamiento de recompensas a lo largo del tiempo.                                                           |
| Fuente de referencia             | La fuente u canal original a través del cual se adquirió el participante (p. ej., *correo electrónico*, *orgánico*, *socio*). Ayuda a evaluar el alcance y la efectividad del programa de referencias por canal. |
| Configuración regional (Locale)  | El idioma y la configuración regional del participante (p. ej., *en-US*, *fr-FR*). Importante para comunicaciones personalizadas u opciones regionales de recompensas.                                           |

</details>

#### Saldos de recompensa disponibles por usuario

El *Saldos de recompensa disponibles por usuario* informe proporciona una lista de recompensas no canjeadas. Este tipo de informe está destinado a usarse como parte del cumplimiento de recompensas mediante el [canje masivo de recompensas](https://help.impact.com/brand/es/advocate-program/advocate-rewards/redeem-rewards-in-bulk) proceso.

<details>

<summary>Detalles del informe</summary>

Por defecto, 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
* Monto disponible

Se puede encontrar una lista completa de los campos al [descargar nuestro CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](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 recompensa disponibles.

{% hint style="info" %}
**Nota**: Este informe no incluye detalles sobre Descuento porcentual, Fuel Tank o recompensas de Tarjeta regalo. Usa el *Saldos de recompensa por usuario* informe para 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 emparejar con sistemas externos como un CRM o proveedor de recompensas.                                                                                                                                                           |
| ID de usuario                            | El identificador único asignado al participante dentro de Advocate.                                                                                                                                                                                                                                                    |
| ID de cuenta                             | El ID interno de cuenta vinculado al participante.                                                                                                                                                                                                                                                                     |
| Segmentos                                | Etiquetas o categorías utilizadas para [agrupar participantes](https://help.impact.com/brand/es/advocate-program/manage-advocate-participants/manage-advocate-user-segments) (por ejemplo, *por región*, *etapa del ciclo de vida*, *tipo de cliente*). Útil para filtrar o aplicar diferentes reglas de cumplimiento. |
| **Estado y cronograma de la recompensa** |                                                                                                                                                                                                                                                                                                                        |
| Fecha de bloqueo                         | La fecha en que se bloqueó al usuario para recibir recompensas, si procede. Un estado de bloqueo podría impedir la redención; este campo indica cuándo se aplicó ese bloqueo.                                                                                                                                          |
| **Datos de la recompensa**               |                                                                                                                                                                                                                                                                                                                        |
| Nombre de la unidad                      | La etiqueta o nombre que se muestra de la unidad de recompensa (por ejemplo, *Efectivo por referidos*, *Crédito en tienda*). Esto ayuda a distinguir entre varios tipos de recompensa que un programa pueda ofrecer.                                                                                                   |
| Moneda                                   | El código de moneda del valor de la recompensa (por ejemplo, *USD*, *ZAR*, *EUR*). Necesario al cumplir recompensas, especialmente entre países o sistemas de pago.                                                                                                                                                    |
| Valor disponible                         | La cantidad de recompensa no redimida actualmente disponible para este participante. Este es el valor principal que se usa para determinar qué pagar.                                                                                                                                                                  |
| Valor a redimir                          | El valor actualmente en cola para redención (por ejemplo, pendiente en un cumplimiento masivo o esperando procesamiento). Útil para evitar redenciones dobles o asegurar que no haya solapamiento en las redenciones.                                                                                                  |
| Valor total redimido                     | El valor total de las recompensas que este participante ya ha redimido. Ofrece información sobre redenciones pasadas y puede ser útil para el seguimiento de límites de recompensa                                                                                                                                     |
| Unidad                                   | El código interno o del sistema para la unidad de recompensa (por ejemplo, *USD*, *puntos*, etc.). Podría usarse en llamadas API o lógica interna durante el cumplimiento.                                                                                                                                             |

</details>

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

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

<details>

<summary>Detalles del informe</summary>

Por defecto, 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ó el formulario W-9 del participante como recopilado
* Valor imponible en EE. UU. de las recompensas ganadas por año fiscal
* Número total de recompensas ganadas por cada participante en el año fiscal

**Referencia de columnas del informe**

| Columna                                                                 | Descripción                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información del participante**                                        |                                                                                                                                                                                                                                                             |
| ID de usuario                                                           | El identificador único del participante en Advocate.                                                                                                                                                                                                        |
| ID de cuenta                                                            | ID de cuenta interno asociado con el participante.                                                                                                                                                                                                          |
| Correo electrónico                                                      | La dirección de correo electrónico del participante.                                                                                                                                                                                                        |
| Nombre                                                                  | El nombre del participante.                                                                                                                                                                                                                                 |
| Apellido                                                                | El apellido del participante.                                                                                                                                                                                                                               |
| **Información fiscal W-9**                                              |                                                                                                                                                                                                                                                             |
| <p>Fecha de envío del formulario fiscal de EE. UU.</p><p>AAAA-MM-DD</p> | La fecha en la que el formulario W-9 del participante se marcó como enviado y recopilado en Advocate. Importante para el cumplimiento con el IRS y para verificar el estado de la documentación fiscal.                                                     |
| **Resumen del año fiscal**                                              |                                                                                                                                                                                                                                                             |
| Año                                                                     | El año fiscal en el que el participante ganó recompensas. Se utiliza 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 sujetas a impuestos en EE. UU. ganadas por este participante en el año fiscal especificado, expresado en centavos (por ejemplo, 2500 = $25.00). Ayuda con cálculos sin procesar 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 (por ejemplo, 25.00). Más fácil para revisión o inclusión en resúmenes oficiales.                                                                                                            |
| Recuento de recompensas                                                 | Número total de instancias individuales de recompensas ganadas por el participante en el año fiscal especificado. Útil para auditorías o para entender la frecuencia de recompensas y la participación en el programa.                                      |

</details>

#### Pagos y impuestos

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

Si su programa ofrece pagos en efectivo a los participantes, ciertos campos relacionados con el estado del formulario fiscal del participante estarán disponibles.

<details>

<summary>Detalles del informe</summary>

Por defecto, 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— fue marcado como enviado
* Valor imponible en EE. UU. de las recompensas ganadas por año fiscal
* Número total de recompensas ganadas por cada participante en el año fiscal
* El estado del formulario fiscal, p. ej., *válido*, *en espera*, o *pendiente*. También se incluyen en el informe las razones de retención del pago

**Referencia de columnas del informe**

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

</details>
