Migrar desde PromoteKit
Lleva tu programa de PromoteKit a Rekomi con una sola extracción por API. Rekomi importa tus afiliados (con sus códigos de referido ?via=, sus correos de pago y sus totales de clics), tus leads registrados y tu historial de comisiones directamente desde la API de PromoteKit.
Esta guía es para marcas que se cambian de PromoteKit a Rekomi. PromoteKit es una plataforma de afiliados nativa de Stripe para SaaS. El camino principal es una extracción por API con una sola clave: pegas tu clave de API de PromoteKit y Rekomi importa tu lista de afiliados (con el código de referido ?via=, el correo de pago y el total histórico de clics de cada uno), tus leads registrados y tu historial de comisiones en una sola pasada.
La mayoría de los equipos completan el cambio en una sola tarde. La migración está disponible en Starter o superior; el aviso automático, en Growth o superior.
Importar por API (recomendado)
Las exportaciones del panel de PromoteKit son solo archivos de pago (en formato de pago masivo de PayPal y Wise), así que la extracción por API es el camino de migración completo. La API de PromoteKit está disponible en su plan Pro o superior; el plan Free no tiene clave de API.
- En PromoteKit, abre Settings → API Keys y copia tu clave de API.
- Abre
/dashboard/settings/migrate, elige PromoteKit, selecciona tu campaña de destino en Rekomi y pega la clave. Se usa una sola vez, en memoria, y nunca se guarda, se registra ni se vuelve a mostrar. - Deja activados los interruptores Importar leads e Importar el historial de comisiones (o desactiva el que no necesites) y haz clic en Extraer de PromoteKit.

Qué importa la extracción:
- Afiliados: correo, nombre y apellidos, correo de pago (PayPal o Wise) y estado. PromoteKit modela el estado con dos booleanos: los afiliados bloqueados se importan como Bloqueado, los aprobados como Aprobado y las solicitudes sin aprobar como Pendiente.
- Códigos de referido: el código del primer enlace de cada afiliado (el valor
?via=) se conserva como su slug de Rekomi cuando pasa las comprobaciones estándar de slug (de 3 a 64 caracteres, letras, números y guiones, y que no esté ocupado). Los enlaces que llevan el código conservado siguen funcionando sin cambios, porqueviaes uno de los parámetros de atribución integrados en Rekomi. Los afiliados con varios enlaces en PromoteKit reciben un solo enlace de Rekomi; el resumen de la importación te dice a cuántos afectó. - Totales de clics: el agregado histórico
clicksde cada afiliado pasa a su contador de clics en Rekomi, así que las clasificaciones y el cálculo del EPC no vuelven a cero. - Leads: los referidos en estado
signed_upde PromoteKit (registrados a través de un afiliado, sin haber empezado a pagar nunca) se importan como registros de lead sin importe, atribuidos a su afiliado, con el correo del cliente y, cuando existe, el id de cliente de Stripe, que viaja con ellos para la atribución recurrente. - Historial de comisiones: las comisiones con el importe de venta, el importe de comisión, la moneda de cada fila y la fecha. PromoteKit expresa el dinero en unidades mayores decimales ("99.0" significa $99.00); Rekomi lo convierte con la escala real de unidades menores de la moneda, así que las monedas sin decimales como JPY se mantienen correctas. Las filas que PromoteKit marcó como
paidse importan con fecha de pago; todo se importa como historial liquidado y bloqueado: nada pasa a ser pagadero desde la extracción por API.
Qué no puede importar la extracción: los saldos pagaderos (usa el flujo CSV del Paso 2 con su vista previa si quieres que los saldos abiertos pasen a ser pagaderos), la atribución por código promocional (cupones) (crea códigos de cupón nuevos en Rekomi), la estructura de campañas y los registros clic a clic (PromoteKit solo expone agregados). Cada lista se obtiene hasta 5,000 filas; el resultado te avisa si alguna obtención se quedó corta.
Repetir la extracción es seguro: los afiliados se deduplican por correo y las filas de historial se deduplican por los ids de PromoteKit.
La alternativa por CSV
El panel de PromoteKit no tiene exportación de la lista de afiliados, pero un archivo facilitado por soporte o generado desde la API funciona con el importador de CSV de abajo.
Qué trae el importador de CSV
| Campo | Columna de origen | Notas |
|---|---|---|
| Correo | email | Obligatorio. En minúsculas y sin espacios sobrantes. Clave principal de deduplicación. |
| Nombre completo | name, o first_name + last_name | Si existe name, tiene prioridad; si no, las dos partes se unen con un espacio. |
| Estado | los booleanos approved + banned, o status | Consulta la tabla de correspondencias de abajo. |
| Correo de pago | payout_email o paypal_email | Opcional. Se conserva como destino de pago del afiliado cuando existe. |
| Slug de seguimiento | ref_code, referral_code, code, o el ?via= extraído de una columna de enlace | Consulta Cómo se conservan los slugs. |
| Total de clics | clicks o click_count | Agregado histórico opcional. |
Correspondencia de estados
PromoteKit modela el estado del afiliado con dos booleanos en lugar de un enumerado:
| PromoteKit | Rekomi |
|---|---|
banned = true | Bloqueado |
approved = true (sin bloquear) | Aprobado |
approved = false | Pendiente |
| ninguno legible | Pendiente |
Las campañas de PromoteKit pueden exigir aprobación (approval_needed), así que un afiliado sin aprobar se trata como una solicitud pendiente. Puedes reclasificar cualquier fila con la acción de cambio de estado en bloque en /dashboard/affiliates después de importar.
Cómo se conservan los slugs
Los enlaces de referido de PromoteKit usan el parámetro de consulta ?via=, por ejemplo brand.com?via=alex. via es uno de los parámetros de atribución integrados en Rekomi y funciona sin configurar nada, así que los enlaces ?via= de tus afiliados siguen atribuyendo en Rekomi en cuanto cambias el snippet de seguimiento, siempre que el código se haya conservado como slug (las condiciones de abajo).
El importador conserva el slug tal cual cuando:
- La extracción (o el archivo) incluye el código de enlace del afiliado.
- Ese valor es un alias válido: de 3 a 64 caracteres, letras, números y guiones, sin guion al principio ni al final.
- El slug no está ya ocupado en el espacio de nombres global de Rekomi (los slugs son únicos en toda la plataforma, no por organización).
Cuando se cumplen las tres, el afiliado conserva exactamente su slug. Si no, recibe un slug aleatorio nuevo de 12 caracteres; su cuenta se importa igualmente sin problemas.
El cambio paso a paso
1. Ejecuta la extracción por API
Copia tu clave de API desde Settings → API Keys en PromoteKit y ejecuta la extracción desde /dashboard/settings/migrate (consulta Importar por API más arriba). Una sola pasada trae tu lista, los códigos de referido, los leads y el historial.
2. Parámetros de atribución: nada que configurar para via
via es uno de los parámetros de atribución integrados en Rekomi y se reconoce siempre, así que los enlaces de PromoteKit existentes resuelven al afiliado correcto en Rekomi sin configurar nada.
3. Revisa el resultado de la importación
La importación se ejecuta de forma síncrona y muestra un resultado fila a fila: importada, omitida (duplicada o sin correo) o con error. Cada trabajo aparece en el Historial de importaciones con un panel de detalle por fila y un botón Deshacer.
4. Activa el aviso automático (solo Growth o superior)
Marca Avisar a los afiliados después de importar y escribe una nota personal breve. Haz clic en Enviarme una muestra para verla antes del envío masivo escalonado (un correo por segundo).
5. Cambia el snippet de seguimiento
Instala el snippet de seguimiento de Rekomi en tu sitio de marketing y luego quita la etiqueta script de PromoteKit y su marcado de metadatos en Stripe. En cuanto el snippet nuevo está activo, todos los enlaces brand.com?via=alex existentes atribuyen a Rekomi en lugar de a PromoteKit. Mantén PromoteKit activo durante un periodo de sombra de 24 a 48 horas si quieres una garantía extra, y después cancélalo.
Qué NO se importa
| Datos | Estado | Solución |
|---|---|---|
| Totales históricos de clics | Solo por extracción por API | Los agregados históricos clicks se importan con la extracción por API; los registros clic a clic no se pueden trasladar. |
| Leads | Solo por extracción por API | PromoteKit no tiene exportación de referidos; la extracción trae los referidos en estado signed_up como registros de lead sin importe. |
| Atribución por código promocional | No se importa | El cupón de PromoteKit se apoya en los códigos promocionales de Stripe; crea códigos de cupón nuevos en Rekomi. |
| Qué saldos están abiertos | Parcialmente | Todo se importa como historial bloqueado; el indicador paid de PromoteKit decide qué filas llevan fecha de pago. Para que los saldos abiertos pasen a ser pagaderos hace falta el flujo CSV del Paso 2 con su vista previa. |
| Reglas de comisión personalizadas | No se importan | Configura los modelos de comisión de Rekomi directamente. |
Problemas habituales
Mi plan de PromoteKit no tiene clave de API. El acceso a la API empieza en el plan Pro de PromoteKit. En el plan Free, pide a soporte de PromoteKit una exportación de datos y usa la alternativa por CSV, o sube de plan un mes para ejecutar la extracción.
Un afiliado tenía varios enlaces. Se importa una sola vez con el código de su primer enlace; los enlaces que usan ese código conservado siguen atribuyendo, mientras que los que llevan sus otros códigos dejan de resolver después del cambio (un parámetro reconocido no puede resolver un código que no está registrado).
Ajustes por reembolso. Las filas de comisión negativas (ajustes por reembolso) se omiten en la importación en lugar de importarse como historial negativo.
Comprobar que la importación quedó bien
- Abre
/dashboard/affiliatesy compara 3 a 5 filas al azar con el origen en PromoteKit. - Abre la página de detalle de un afiliado y confirma que conserva su slug
?via=(o que tiene un slug nuevo si no se pudo conservar). - Haz clic en un enlace
?via=existente de un afiliado con el snippet nuevo instalado; confirma que aparece una fila de clic bajo ese afiliado en unos segundos. - Envíate una notificación de muestra antes de lanzar el envío masivo.
Importar el historial y las ganancias
La extracción por API ya importa tu historial de comisiones (y los leads) como registros liquidados y bloqueados. Usa el flujo CSV del Paso 2 cuando quieras que los saldos abiertos pasen a ser pagaderos en Rekomi: solo el flujo CSV previsualiza el saldo exacto sin pagar y te pide que lo autorices. Un archivo del Paso 2 para PromoteKit usa las columnas genéricas (correo del afiliado, importe, comisión, moneda, fecha, pagado). Consulta la visión general de migraciones para la referencia completa.
Siguientes pasos
- Seguimiento y atribución: el parámetro
via, la ventana de cookie y la persistencia de la atribución. - Migrar desde otra plataforma: la matriz completa de conservación de URLs.
- Planes y pruebas: qué incluye cada nivel y cómo funciona la prueba gratuita de 14 días.
Migrar desde impact.com
Lleva tu lista de socios de impact.com a Rekomi. Rekomi extrae los socios, hasta 3 años de historial de conversiones y los totales de clics históricos a través de la Advertiser API de impact.com; nada que exportar.
Migrar desde LeadDyno
Lleva tu programa de LeadDyno a Rekomi con una sola extracción por API. Rekomi importa tus afiliados (con sus códigos ?afmc=, correos de PayPal y recuentos de visitantes históricos), tus leads Registered y tu historial de comisiones directamente desde la API de LeadDyno.