# Importar los datos de tu programa de referidos

Al cambiar de otra plataforma de referidos a Advocate, no solo estás importando datos: estás mejorando el potencial de tu programa con seguimiento avanzado, experiencias personalizables y soporte experto. Este artículo te guía por:

* Por qué la migración importa
* Cómo es un plan de migración estratégico
* Qué datos se pueden importar
* Cómo preparar tus archivos
* Errores comunes de validación y cómo evitarlos

#### ¿Por qué planear una migración estratégica?

Migrar tu programa de referidos no es solo una tarea técnica: es una oportunidad para mejorar la forma en que involucras y recompensas a tus clientes. Una migración bien planificada ayuda a:

* Minimizar la interrupción de la experiencia de referidos
* Preservar los datos históricos y asegurar la continuidad de las recompensas ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media)
* Permitir una separación limpia de los sistemas heredados
* Reintroducir tu programa de referidos con entusiasmo y claridad

![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) La migración de referidos y recompensas depende de tu capacidad para exportar datos desde tu sistema actual. Tu equipo de Advocate puede informarte qué es posible en función de los datos de exportación que proporciones.

Tu equipo de Advocate trabajará contigo para revisar tus archivos de exportación, identificar lo que es factible y crear un plan que coincida con las necesidades y objetivos de tu programa.

#### Lo que necesitarás hacer

* Exporta el *datos de usuario*, *datos de referidos*, y *datos de recompensas*. Ponte en contacto con tu CSM en tu antigua plataforma de referidos para obtener ayuda, o utiliza una herramienta de exportación dentro de la plataforma si está disponible.
* Descarga cada uno de los 3 informes de datos en un archivo CSV separado, p. ej., `user_data.CSV`, `referral_data.CSV`, y `reward_data.CSV`.
  * Consulta los ejemplos a continuación para ver cómo podría ser el contenido de cada archivo .csv, o consulta la referencia completa del campo Destination.

Esto incluye correos electrónicos, códigos de referido, enlaces para compartir ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media), y campos personalizados. Los afiliados deben filtrarse para evitar recompensas dobles.

![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) Dependiendo del formato del enlace para compartir y del uso de un subdominio personalizado.

El archivo de Datos de Usuario contendrá información detallada sobre cada participante en tu programa. Exporta una lista de todos los participantes para mantener tu programa actualizado con sus enlaces para compartir y códigos de referido.

Los siguientes campos son **obligatorios**:

* ID de usuario
* ID de cuenta

Usa el correo electrónico del usuario como su *ID de usuario* y *ID de cuenta*. Las fechas deben formatearse en [milisegundos desde el epoch de unix](https://currentmillis.com/). Descarga un [ejemplo de los campos requeridos](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) o utiliza el ejemplo de abajo en `.csv` formato.

```programlisting
id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments
User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US,
User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser"
User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,,
User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser
```

Esto incluye fechas de inicio y conversión, y relaciones referente/referido. Permite mapear el rendimiento histórico de referidos.

El archivo de datos de referidos proporciona un registro del estado de cada conexión de referido realizada en tu programa de referidos.

Los siguientes campos son **obligatorios**:

* ID de usuario Advocate
* ID de cuenta Advocate
* ID de usuario referido
* ID de cuenta referida

Usa el correo electrónico del usuario como su *ID de usuario* y *ID de cuenta*. Las fechas deben formatearse en [milisegundos desde el epoch de unix](https://currentmillis.com/). Descarga un [ejemplo de los campos requeridos](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) o utiliza el ejemplo de abajo en `.csv` formato.

```programlisting
referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId
User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435
User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435
User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435
User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435
```

Esto incluye valores, fechas otorgadas/canjadas y tipos y estados de recompensas. Permite preservar la credibilidad y la equidad con los usuarios.

El archivo de Datos de Recompensas proporciona un registro del historial de recompensas de los participantes, incluyendo su valor y el monto canjeado generado a través de tu programa de referidos.

Los siguientes campos son **obligatorios**:

* ID de usuario Advocate
* ID de cuenta Advocate
* Nombre de la recompensa
* Unidad de recompensa
* Valor de la recompensa
* Fecha de creación
* Fecha otorgada
* Fecha canjeada
* Monto canjeado

Usa el correo electrónico del usuario como su *ID de usuario* y *ID de cuenta*. Las fechas deben formatearse en [milisegundos desde el epoch de unix](https://currentmillis.com/).

El valor de la recompensa es el valor numérico de la recompensa en su unidad de medida más pequeña (por ejemplo, para una recompensa en efectivo de $1.00, el valor sería 100 centavos). Si la unidad de recompensa es dinero en efectivo, debe incluir el código de moneda en el siguiente formato `<unitName>/<Currency>` (Por ejemplo, Cash/USD).

{% hint style="warning" %}
**Importante**: Si los *Fecha canjeada* y *Monto canjeado* campos no se establecen adecuadamente — es decir, se dejan en blanco o contienen valores incorrectos (por ejemplo, una fecha futura o un monto canjeado inexacto) — la recompensa podría quedar disponible para que el usuario la canjee de nuevo.
{% endhint %}

Descarga un [ejemplo de los campos requeridos](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) o utiliza el ejemplo de abajo en `.csv` formato.

```programlisting
User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed
User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000
User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682
User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075
User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888
User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986
User1@example.com,User1@example.com,User7@example.com,User7@example.com,Crédito de cuenta,USD,8000,8000,1726164289997,1726164289997,1726164289997
User1@example.com,User1@example.com,,,Tarjeta regalo,USD,10000,10000,1726163864871,1726163864871,1726163864871
User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392
User1@example.com,User1@example.com,,,Tarjeta regalo,USD,30000,30000,1726163769157,1726163769157,1726163769157
User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034
```

{% hint style="warning" %}
**Importante:** Los 3 archivos de exportación deben contener datos de un único programa solamente. Si los archivos contienen datos de múltiples programas, la importación los consolidará en un solo programa.
{% endhint %}

<details>

<summary>Un plan de migración de muestra</summary>

Cada migración es única, pero las exitosas siguen una estructura similar que equilibra preparación, comunicación y ejecución. A continuación hay un plan de migración que garantiza continuidad y una experiencia fluida tanto para tu equipo como para tus defensores. Los plazos y fases pueden ajustarse según la configuración de tu programa.

**Fase 1: Planificación y preparación (1–2 semanas)**

Esta es tu etapa de establecimiento de bases, sentando el fundamento para una transición sin contratiempos.

|           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objetivos | <p>• Alinear a las partes interesadas.</p><p>• Configuración técnica.</p><p>• Confirmar el alcance de la migración.</p><p>• Planificar la comunicación con los usuarios.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Tareas    | <p>• Asegurar un conjunto de muestra de tus datos históricos (usuarios, referidos, recompensas) y compartirlo con el equipo de Advocate para su revisión y mapeo de campos <img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt="">.</p><p>• Exportar los conjuntos de datos completos una vez que la muestra haya sido validada. Es muy probable que los datos de exportación necesiten ser manipulados (p. ej., ajustar encabezados, nombres de campos o estructura de archivos) para coincidir con los requisitos de importación.</p><p>• Establecer una fecha de inicio y una ventana de reversión.</p><p>• Agregar widgets de Advocate en modo oculto (entorno de prueba o páginas no vinculadas).</p><p>• Configurar las integraciones necesarias (p. ej., Shopify, HubSpot, Segment).</p><p>• Completar la configuración del programa en Advocate (p. ej., configuración de recompensas, reglas del programa, plantillas de correo electrónico, segmentación).</p><p>• Probar la funcionalidad del programa de extremo a extremo: confirmar que las comparticiones, conversiones y recompensas se rastrean correctamente en un entorno de prueba antes de pasar a producción.</p><p>• Redactar los mensajes para comunicar la transición a los defensores.</p><p><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt=""> La migración de referidos y recompensas depende de tu capacidad para exportar datos desde tu sistema actual. Tu equipo de Advocate puede informarte qué es posible en función de los datos de exportación que proporciones.</p> |
| Consejos  | <p>• Si tienes plataformas superpuestas, asegúrate de que solo una esté emitiendo recompensas.</p><p>• Identificar usuarios clave que puedan necesitar un tratamiento especial (VIPs, influencers).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

**Fase 2: Corte y puesta en marcha (1–2 días)**

Este es tu momento de transición. Planifica una breve pausa en el seguimiento entre sistemas y programa la migración durante horas de bajo tráfico si es posible.

|           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objetivos | <p>• Cambiar sin problemas de tu plataforma heredada a Advocate.</p><p>• Asegurar que los usuarios puedan acceder a la nueva experiencia de inmediato.</p><p>• Evitar la pérdida de datos de referidos o recompensas.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Tareas    | <p>• Eliminar los scripts/widgets de la plataforma antigua de tu sitio.</p><p>• Poner los widgets de Advocate en producción.</p><p>• Importar los datos finales de usuarios, referidos y recompensas.</p><p>• Rastrear/manualmente marcar cualquier conversión entre el apagado del sistema y el lanzamiento.</p><p>• Monitorear el panel de Advocate en busca de actividad.</p><p>• Enviar la comunicación de lanzamiento a tus defensores. Informar a los usuarios que sus enlaces de referido han sido actualizados e incluir idealmente los nuevos enlaces directamente en el correo electrónico para facilitar que comiencen a compartir de inmediato.</p> |
| Consejos  | <p>• Incluir un breve periodo de bloqueo de recompensas si es necesario (p. ej., “Los referidos realizados el 15 de mayo serán revisados y añadidos después del lanzamiento.”).</p><p>• Usar la comunicación dirigida a los defensores para generar entusiasmo (p. ej., “¡Hemos mejorado tu experiencia de referidos!”).</p>                                                                                                                                                                                                                                                                                                                                    |

**Fase 3: Post-migración y limpieza (1–2 días)**

Ahora que estás en producción, asegúrate de que tu programa funcione como se espera y atiende cualquier asunto pendiente.

|           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objetivos | <p>• Verificar la integridad de los datos y el seguimiento de recompensas.</p><p>• Capturar cualquier conversión perdida.</p><p>• Brindar soporte y educar a los usuarios.</p>                                                                                                                                                                                                                                                                                                          |
| Tareas    | <p>• Validar que las relaciones referente/referido funcionen en modo en vivo.</p><p>• Importar las conversiones perdidas que ocurrieron durante el corte.</p><p>• Realizar una prueba de control de calidad (refiérete a ti mismo, confirma el seguimiento y la lógica de recompensas).</p><p>• Proporcionar preguntas frecuentes internas y externas o documentos de ayuda.</p><p>• Monitorear la bandeja de entrada de soporte por problemas relacionados con usuarios heredados.</p> |
| Consejos  | <p>• Si vas a dar de baja una cuenta de financiación de recompensas heredada, da a los usuarios un periodo de gracia para canjear.</p><p>• Usar recordatorios por correo electrónico o en la app para fomentar la actividad temprana de referidos en el nuevo programa.</p>                                                                                                                                                                                                             |

</details>

#### Importa los datos de tu programa

1. En el menú de navegación izquierdo, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Reporting → Imports & Exports**.
2. En la esquina superior derecha, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **Importar**.
3. Seleccione el *Tipo de importación* de las opciones disponibles:

   | Tipo de importación                          | Descripción                                                                                                                                                                                                                                                         |
   | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Usuarios                                     | Selecciona esta opción para cargar usuarios nuevos o datos de usuarios existentes. También puedes optar por importar estos datos desde otra cuenta o plataforma.                                                                                                    |
   | Actualizar saldos de recompensas de usuarios | Selecciona esta opción para actualizar y canjear los saldos de recompensas de los usuarios.                                                                                                                                                                         |
   | Eventos de usuario                           | Selecciona esta opción para cargar datos de eventos de usuario.                                                                                                                                                                                                     |
   | Eliminar usuarios                            | <p>Selecciona esta opción si deseas eliminar masivamente usuarios existentes de tu programa.</p><p>También puedes eliminar el manejo de usuarios y optar por:</p><p>• Conservar cuentas vacías</p><p>• Evitar que los usuarios eliminados sean creados de nuevo</p> |
   | Historial de recompensas                     | Selecciona esta opción para cargar un registro de toda la información de recompensas. También puedes optar por importar estos datos desde otra cuenta o plataforma.                                                                                                 |
   | Historial de referidos                       | Selecciona esta opción para cargar un registro de todas las conexiones de referidos. También puedes optar por importar estos datos desde otra cuenta o plataforma.                                                                                                  |
4. Selecciona **Elegir archivo** o arrastra y suelta el archivo que deseas importar.
5. Selecciona **Importar** para cargar tus datos.
   * Si vas a eliminar masivamente usuarios existentes, selecciona **Eliminación masiva**.

#### Referencia de errores de validación

Puedes obtener 3 tipos de errores de validación:

1. **Mensaje de error en línea:** estos aparecen en la tabla de validación previa y hacen que las filas con error se resalten en rojo:

   * `CAMPO_INVALIDO` — p. ej., el *Fecha de creación* campo no estaba formateado en [milisegundos desde el epoch de unix](https://currentmillis.com/) .
   * `CAMPO_FALTANTE` — p. ej., falta un campo obligatorio como *ID de usuario* o *ID de cuenta* está ausente.

   <div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-eb521fbbc452c243d6b3763ebcb90053b4e9e4dc%2Ff969fa535707c24f4913282d07287a546b348f2448bdb4ca2eef0a30c871fbb6.png?alt=media" alt=""><figcaption></figcaption></figure></div>
2. **Aviso de error:** estos aparecen en lugar de la tabla de validación previa como mensajes de advertencia en rojo:

   * `ENCABEZADO_FALTANTE` — p. ej., falta un encabezado de columna obligatorio como *ID de cuenta* o *Valor de la recompensa* está ausente.
   * `PARSING_CSV` — p. ej., el archivo CSV contiene caracteres especiales que están mal formateados.
   * `REF_IO_ARCHIVO` — p. ej., el archivo está dañado y no se puede leer.

   <div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9afd5a59441e6c97e033920161875e7cee1fd2e7%2Fc864941cfd589a88e11ae387f25173e7a9543504b234f8340a71b59c01ae2533.png?alt=media" alt=""><figcaption></figcaption></figure></div>
3. **Errores listados:** estos aparecen como una lista de recuentos de errores en la pantalla *Imports & Exports* dentro de la sección *Reporting* cuando el tipo de importación no tiene una tabla de validación previa. Los errores de fila y de archivo se mostrarán juntos:

   <div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a2c99edcc8f6f7080232fb391e6b8b5be6aa4226%2Fc8da480b7e5374d0d1b0fab59bda48e561fd813c46d91598b9d8f259d825b92c.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

#### Soporte

No tienes que navegar la migración solo. Nuestro equipo de incorporación de Advocate está listo para ayudar con:

* Soporte para mapeo de campos
* Guía de formato de datos
* Estrategia de migración de recompensas
* Pruebas y control de calidad

Contacta a tu [equipo de soporte de Advocate](mailto:support-advocate@impact.com).
