Sistema de Importación/Exportación

Disponible en:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Descripción General

El Sistema de Importación/Exportación en Post Affiliate Pro proporciona herramientas potentes para operaciones masivas de datos. Ya sea que estés migrando desde otra plataforma, gestionando grandes conjuntos de datos o sincronizando datos entre sistemas, la funcionalidad de importación/exportación ahorra tiempo y reduce errores manuales.

El sistema soporta la importación y exportación de:

• Afiliados - Cuentas de usuario con todos los datos de perfil y opciones de pago
• Campañas - Configuraciones de campaña, tipos de comisión, grupos y tasas
• Banners - Definiciones de banners y materiales promocionales
• Transacciones - Ventas, comisiones y registros de transacciones
• Temas - Temas y plantillas personalizadas del panel

Importación/Exportación de Afiliados

Exportación de Afiliados

La función de exportación de afiliados crea un archivo CSV completo que contiene todos los datos de afiliados de tu instalación. La exportación incluye:

Campos Principales de Afiliados:

• ID de Usuario (identificador único)
• ID de Referencia (refid)
• Nombre de Usuario (email)
• Nombre y Apellido
• Estado de Cuenta (pendiente, aprobado, rechazado)
• Fecha de Inserción y Fecha de Aprobación
• ID de Usuario Padre (para estructuras multi-nivel)
• Umbral de Pago Mínimo
• Notas y Foto

Campos de Datos Personalizados:

• Data1 a Data25 (campos personalizados de afiliados)

Opciones de Pago: La exportación también incluye una sección separada para opciones de pago, que contiene:

• ID de Usuario
• Nombre del campo de pago
• Valor del campo de pago

Importación de Afiliados

Al importar afiliados, el sistema procesa el archivo CSV y crea nuevas cuentas de afiliados o actualiza las existentes basándose en el ID de Usuario.

Campos Requeridos:

• !USERID - El identificador único para el afiliado

Comportamientos Clave:

• Si existe un afiliado con el ID de Usuario especificado, el registro se actualiza
• Si el ID de Usuario no existe, se crea una nueva cuenta de afiliado
• Los campos de estado vacíos por defecto son “Aprobado”
• El sistema maneja automáticamente las relaciones de usuario padre para estructuras multi-nivel
• Las contraseñas pueden importarse con o sin cifrado salt

Mapeo de Campos: La fila de encabezado del CSV define los nombres de campos usando el formato !NOMBRECAMPO. Por ejemplo:

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

Ejemplo de Formato CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,john@example.com,John,Smith,A,50.00
def67890,REF002,jane@example.com,Jane,Doe,A,100.00

Valores de estado:

• A - Aprobado
• P - Pendiente
• D - Rechazado

Importación/Exportación de Campañas

Qué Se Exporta

La exportación de campañas crea un respaldo completo de tu estructura de campañas incluyendo:

Campañas:

• ID de Campaña, Nombre y Descripción
• Tipo y Estado
• Fecha de Inserción
• Orden de Visualización
• Vida Útil de Cookie y configuraciones de Sobrescritura
• Configuraciones de Geo-targeting (países, reglas de visualización)
• Configuraciones de rango de fechas válidas
• URL del Logo e ID de Producto

Tipos de Comisión:

• ID del Tipo de Comisión
• Tipo (venta, lead, clic, etc.)
• Nombre y Código
• Estado y configuraciones de Aprobación
• Configuraciones preestablecidas de Recurrencia
• Opciones de manejo de comisión cero
• Restricciones de país y ciudad

Grupos de Comisiones:

• ID del Grupo y Nombre
• Asociación de Campaña
• Indicador de grupo predeterminado

Comisiones:

• ID de Comisión
• Nivel de tier
• Tipo de comisión (porcentaje, fijo)
• Valor
• Asociación a tipos de comisión y grupos

Importación de Campañas

La importación de campañas soporta la creación o actualización de campañas con todas sus estructuras de comisiones asociadas.

Campos Requeridos por Sección:

• Campañas: !CAMPAIGNID
• Tipos de Comisión: !COMMTYPEID
• Grupos de Comisiones: !COMMISSIONGROUPID
• Comisiones: !COMMISSIONID

La importación procesa cada sección secuencialmente, asegurando relaciones apropiadas entre campañas, tipos de comisión, grupos y tasas de comisión.

Importación/Exportación de Banners

Estructura de Datos de Banners

La importación/exportación de banners maneja los metadatos y configuración de tus materiales promocionales:

Campos Exportados:

• ID de Banner
• ID de Cuenta e ID de Campaña
• Tipo de Banner (imagen, HTML, enlace de texto, etc.)
• Estado (activo/inactivo)
• Nombre y Descripción
• URL de Destino
• Dimensiones de tamaño
• Campos de datos (Data1-Data4) para contenido específico del tipo
• Orden de Visualización
• Cadena SEO
• ID de Wrapper
• Fecha de Inserción

Nota Importante: La importación/exportación de banners maneja solo las definiciones, no los archivos de imagen físicos o activos. Asegúrate de que las imágenes referenciadas estén disponibles en las URLs especificadas después de la importación.

Campo Requerido:

• !BANNERID - Identificador único del banner

Ejemplo de Formato CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Banner de Venta de Verano,https://example.com/venta,A
ban67890,camp001,T,Promo de Enlace de Texto,https://example.com/promo,A

Tipos de banner:

• I - Banner de imagen
• T - Enlace de texto
• H - Banner HTML
• Y otros tipos soportados

Importación de Transacciones

Descripción General

La importación de transacciones es una función potente para cargar masivamente ventas, comisiones y otros registros de transacciones. Esto es particularmente útil para:

• Migrar datos históricos de otras plataformas
• Importar ventas offline
• Procesamiento por lotes de actualizaciones de transacciones
• Sincronización con sistemas externos

Campos Disponibles

La importación de transacciones soporta un conjunto completo de campos:

Campos Principales de Transacción:

• ID de Transacción
• ID de Cuenta
• ID de Usuario (afiliado) - soporta ID, refid o nombre de usuario
• ID de Banner e ID de Banner Padre
• ID de Campaña
• ID de Pedido e ID de Producto
• Estado (pendiente, aprobado, rechazado)
• Tipo (venta, lead, clic, reembolso, contracargo)
• Fecha de Inserción y Fecha de Aprobación
• Monto de comisión
• Costo Total y Costo Fijo
• Nivel de tier

Información de Seguimiento:

• Código de País
• Dirección IP
• Navegador
• URL de Referencia
• Método de Seguimiento
• Conteo de Clics
• Canal
• ID de Visitante

Datos Adicionales:

• Campos de Datos Extra (Data1-Data5)
• Nota de Comerciante y Nota del Sistema
• ID o Código de Cupón
• Información de moneda (ID, valor, tasa)
• ID de Tipo de Comisión e ID de Grupo
• Comisión de Red
• ID de Venta e información de División

Opciones de Importación

Coincidencia de Transacciones: La importación puede coincidir transacciones existentes por:

• ID de Pedido - Actualiza transacciones con ID de pedido coincidente
• ID de Transacción - Actualiza transacción específica por ID
• ID de Pedido (Todos los Tiers) - Actualiza todas las transacciones de tier para un pedido

Cálculo Automático de Comisiones: Habilita el cómputo automático de comisiones para que el sistema calcule los montos de comisión basándose en:

• Configuraciones de comisión de campaña
• Grupo de comisiones del afiliado
• Valor del costo total
• Reglas del tipo de comisión

Generación de Comisiones Multi-Tier: Cuando está habilitada, la importación crea automáticamente comisiones de tier basándose en la estructura de línea ascendente del afiliado y las configuraciones de campaña.

Manejo de Estado:

• Establecer un estado específico para todas las transacciones importadas
• Usar el estado del archivo (valor del campo)
• Preservar el estado original al actualizar transacciones existentes

Presets de Formato de Importación

Puedes guardar y reusar configuraciones de formato de importación:

• Definir mapeos de columnas
• Establecer opciones de importación
• Guardar como presets nombrados para importaciones recurrentes

Ejemplo de Formato CSV

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,ORD-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,ORD-002,P,2025-01-10 11:45:00

Manejo de Reembolsos y Contracargos

Al importar reembolsos o contracargos:

• Establece el tipo de transacción a reembolso (R) o contracargo (H)
• Proporciona el ID de transacción padre o ID de pedido como referencia
• Los montos de comisión se calculan automáticamente como valores negativos al usar cómputo automático

Importación/Exportación de Temas

Exportación de Temas

Exporta tus temas personalizados como paquetes completos para respaldo o migración:

Qué Se Exporta:

• Configuración del tema (configuraciones de theme.php)
• Todos los archivos de plantilla (.tpl y .stpl)
• Archivos CSS personalizados (custom.css, custom_colors.css)
• Activos de imagen (JPEG, PNG, GIF, BMP)

La exportación crea un archivo ZIP que contiene la estructura completa del tema.

La Configuración del Tema Incluye:

• Nombre y descripción del tema
• Autor y URL
• Módulo (panel de comerciante/afiliado)
• Modo de visualización (individual/ventana)
• Configuraciones de fondo de pantalla predeterminado
• Imagen en miniatura
• Configuraciones de anulación de CSS
• Referencia al tema original

Importación de Temas

Importa temas desde paquetes ZIP para desplegar rápidamente diseños personalizados:

Requisitos:

• Archivo ZIP válido con configuración theme.php
• Sintaxis de plantilla apropiada (validada durante la importación)
• Referencia de tema original válida
• Imagen en miniatura especificada

Validación: El proceso de importación valida:

• Completitud de la configuración del tema
• Sintaxis de plantillas Smarty
• Existencia del tema original
• Restricciones de tipo de archivo (solo extensiones permitidas)

Tipos de Archivo Soportados:

• Plantillas: .tpl, .stpl
• Estilos: .css (solo custom.css, custom_colors.css)
• Imágenes: .jpg, .jpeg, .png, .gif, .bmp

Requisitos de Formato de Datos

Estructura de Archivo CSV

Requisitos Generales:

• Usar codificación UTF-8 para manejo apropiado de caracteres
• La primera fila debe contener encabezados de columna
• Delimitador consistente en todo el archivo (coma, punto y coma o tabulación)
• Caracteres especiales apropiadamente escapados

Formato de Nombre de Campo:

• Los campos requeridos tienen prefijo ! (ej., !USERID)
• Los nombres de campo no distinguen mayúsculas y minúsculas
• El mapeo personalizado permite orden flexible de columnas

Formato de Fecha: Las fechas deben estar en un formato reconocible:

• YYYY-MM-DD HH:MM:SS (recomendado)
• Los formatos de fecha estándar se analizan automáticamente

Valores Numéricos:

• Usar punto (.) como separador decimal
• Sin separadores de miles
• Se soportan valores negativos (ej., para reembolsos)

Archivos Multi-Sección

Algunas exportaciones (afiliados, campañas) incluyen múltiples secciones de datos:

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Cada sección se identifica por un marcador de encabezado y tiene su propia estructura de columnas.

Mejores Prácticas para Operaciones Masivas

Antes de Importar

1. Crear un Respaldo Siempre exporta tus datos actuales antes de realizar importaciones masivas, especialmente cuando uses la opción de eliminar.

2. Validar Tus Datos

   • Verificar IDs duplicados
   • Verificar que los campos requeridos estén presentes
   • Asegurar que los formatos de fecha sean consistentes
   • Validar códigos de estado y tipo

3. Probar con Conjunto de Datos Pequeño Importa unos pocos registros primero para verificar el mapeo y comportamiento antes de procesar archivos grandes.

4. Verificar Dependencias

   • Asegurar que las campañas referenciadas existan antes de importar banners
   • Verificar que las cuentas de afiliados existan antes de importar transacciones
   • Confirmar que los tipos de comisión estén configurados antes de importar comisiones

Durante la Importación

5. Monitorear el Progreso La importación se ejecuta como una tarea en segundo plano con seguimiento de progreso. Verifica las notificaciones de tareas para actualizaciones de estado y mensajes de error.

6. Manejar Errores con Gracia El sistema registra errores para registros individuales mientras continúa procesando entradas válidas. Revisa el registro de importación para abordar los registros fallidos.

Después de Importar

7. Verificar Resultados

   • Revisar registros importados aleatoriamente
   • Verificar que los totales y conteos coincidan con las expectativas
   • Probar inicios de sesión de afiliados si se importaron contraseñas

8. Actualizar Registros Relacionados Algunas importaciones pueden requerir acciones de seguimiento:

   • Asignar afiliados a campañas
   • Subir imágenes de banners
   • Configurar tasas de comisión

Consideraciones de Rendimiento

9. Manejo de Archivos Grandes El sistema de importación procesa datos en lotes para prevenir timeouts. Los archivos muy grandes pueden tardar varios minutos en completarse.

10. Programar Durante Baja Actividad Para mejor rendimiento, programa importaciones grandes durante horas de menor actividad cuando la carga del sistema es menor.

Notas de Seguridad

11. Datos Sensibles

    • Los campos de contraseña se manejan de forma segura con cifrado salt
    • Evitar importar información de pago sensible a través de canales no seguros
    • Revisar archivos de importación por exposición no intencional de datos

12. Control de Acceso Las funciones de importación/exportación requieren permisos apropiados de administrador comerciante.

Casos de Uso Comunes

Migrar desde Otra Plataforma

1. Exportar datos de tu plataforma existente en formato CSV
2. Mapear columnas a nombres de campo de Post Affiliate Pro
3. Importar afiliados primero para establecer cuentas de usuario
4. Importar campañas y estructuras de comisiones
5. Importar transacciones históricas
6. Subir banners y materiales promocionales

Sincronización Mensual de Transacciones

1. Crear un preset de formato de importación para tu sistema externo
2. Exportar transacciones de tu plataforma de e-commerce
3. Importar usando coincidencia por ID de Pedido para actualizar transacciones existentes
4. Revisar el registro de importación por cualquier discrepancia

Respaldo y Despliegue de Temas

1. Personalizar tu tema en un entorno de desarrollo
2. Exportar el tema como un paquete ZIP
3. Importar en la instalación de producción
4. Verificar la apariencia y funcionalidad del tema

Actualizaciones Masivas de Afiliados

1. Exportar datos actuales de afiliados
2. Modificar el archivo CSV con información actualizada
3. Importar con coincidencia por ID de Usuario
4. Verificar que las actualizaciones se aplicaron correctamente