PS PrestaShop Principiante

DataFirefly Affiliate Program: programa de afiliados para PrestaShop

Instalar, configurar y gestionar el programa de afiliación: panel, seguimiento de enlaces, comisiones con periodo de validación, reglas y simulador, extractos SEPA o PayPal, área de afiliado y material promocional.

Actualizado Versión del módulo 2.0.0

Instalación y actualización

Instala el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP. El mismo ZIP funciona en PrestaShop 1.7.8, 8 y 9.

Al instalarse, el módulo crea sus tablas y sus ajustes por defecto, y añade el menú Vender > Afiliación con siete entradas: Panel, Afiliados, Comisiones, Extractos y pagos, Reglas de comisión, Material promocional y Ajustes. Un menú común en la parte superior de cada página permite pasar de una a otra.

Para pasar de la versión 1.0.0 o 1.1.0 a la 2.0.0, basta con enviar el nuevo ZIP. El script de actualización conserva los afiliados, enlaces, clics, comisiones, extractos, reglas y ajustes, y añade las novedades:

  • los IBAN ya guardados se cifran;
  • las comisiones que siguen dentro de su plazo pasan a la etapa «periodo de validación»;
  • los nuevos ajustes reciben su valor por defecto.

Antes de abrir el programa, revisa en Ajustes el estado o los estados de pedido que confirman el pago, el periodo de validación y el pago mínimo. El Panel muestra después una comprobación de la configuración que indica lo que falta.

Panel

Panel del programa de afiliación: clics, pedidos atribuidos, facturación generada, comisiones por pagar y tareas pendientes
Panel del programa de afiliación: clics, pedidos atribuidos, facturación generada, comisiones por pagar y tareas pendientes

El panel resume la actividad de 7 días, 30 días, 90 días o 12 meses:

  • Indicadores: clics y visitantes únicos, pedidos atribuidos y conversión de los clics, ventas generadas (base de comisión de los pedidos, sin gastos de envío), comisiones generadas y su porcentaje sobre las ventas, comisiones por pagar, afiliados activos, pedidos rechazados por autoafiliación o doble recompensa.
  • Gráfico de clics y ventas por día, o por mes en 12 meses.
  • Dónde están las comisiones: pendientes del pago del pedido, en periodo de validación, pagables, en extractos por pagar, pagadas.
  • Tareas pendientes: solicitudes por revisar, comisiones pendientes, extractos por crear o por pagar, afiliados sin datos de pago, cada uno con un botón que abre la lista correspondiente.
  • Comprobación de la configuración, mejores afiliados, enlaces con más clics y últimas comisiones.

Seguimiento y atribución

Los enlaces de seguimiento

Cada afiliado tiene un código. Dos tipos de enlaces lo transmiten:

  • el parámetro de seguimiento, que se añade a cualquier dirección de la tienda: ?aff=CODE. El nombre del parámetro se cambia en los ajustes;
  • los enlaces cortos /go/… que el afiliado crea en su área. Redirigen a la página elegida y cuentan los clics y los pedidos por enlace. Solo se aceptan direcciones de la tienda: un enlace nunca puede redirigir a otro sitio.

Al hacer clic, la cookie dfaff_ref registra al afiliado. Está firmada (un visitante no puede modificarla), es HttpOnly y SameSite=Lax, y su duración se configura en los ajustes o por afiliado. La atribución también se copia en el carrito, lo que cubre los pagos que el banco confirma más tarde.

Nunca se cuentan:

  • los robots y las vistas previas de enlaces de las redes sociales y las aplicaciones de mensajería;
  • las precargas del navegador y las peticiones HEAD;
  • los clics del propio afiliado;
  • las recargas y los clics repetidos de un mismo visitante en el mismo enlace durante el intervalo elegido (30 minutos por defecto).
Ajustes de seguimiento: parámetro de URL, duración de la cookie, último o primer clic, clics repetidos y espera del consentimiento
Ajustes de seguimiento: parámetro de URL, duración de la cookie, último o primer clic, clics repetidos y espera del consentimiento

El ajuste Cookie de atribución y consentimiento ofrece dos comportamientos:

  • escribir la cookie en cada visita rastreada;
  • esperar al consentimiento: la cookie solo se escribe si la cookie de tu banner de consentimiento está presente y contiene el texto indicado, por ejemplo tarteaucitron y dfaffiliate=true. Sin consentimiento, el clic se sigue contando en las estadísticas, pero solo un código de descuento del afiliado puede atribuir el pedido.

La situación de esta cookie respecto a la normativa depende de tu país y de tu uso: haz que la valide tu asesor. El módulo no garantiza ningún cumplimiento normativo.

Orden de atribución de un pedido

  1. El código de descuento personal de un afiliado usado en el pedido, incluso sin clic.
  2. El enlace o la cookie.
  3. Un cliente ya aportado por ese afiliado, si las comisiones por clientes recurrentes están activadas.

El modelo de atribución decide qué ocurre cuando un visitante hace clic en los enlaces de dos afiliados: último clic (por defecto), gana el último afiliado visitado; primer clic, el primero conserva la venta hasta que caduca la cookie.

Comisiones

Ciclo de una comisión

Comisiones por etapa: pendiente de pago, en periodo de validación hasta una fecha, pagable, pagada o rechazada
Comisiones por etapa: pendiente de pago, en periodo de validación hasta una fecha, pagable, pagada o rechazada
  1. Pendiente del pago del pedido: el pedido se ha realizado. Un pedido pagado por transferencia o cheque permanece en esta etapa hasta que confirmes el pago.
  2. Periodo de validación: el pedido alcanza un estado que confirma el pago. La comisión espera el número de días elegido (30 por defecto) para cubrir el plazo de desistimiento y las devoluciones. Se muestra la fecha de fin.
  3. Pagable: el periodo ha terminado y la comisión entrará en el próximo extracto.
  4. En un extracto y, después, Pagado cuando marcas el extracto como pagado.

Los periodos de validación finalizan solos: mediante la tarea cron si la usas o, si no, al abrir el back office del módulo o el área de afiliado.

Casos particulares:

  • Pedido cancelado o reembolsado: la comisión se rechaza mientras no esté pagada. Si después el pedido se vuelve a pagar, la comisión vuelve con un nuevo periodo de validación.
  • Reembolso parcial (factura por abono): la comisión se reduce de forma proporcional a los productos reembolsados.
  • Después del pago: el módulo ya no modifica la comisión pagada y crea un ajuste negativo, que se descuenta del extracto siguiente. Un segundo cambio de estado no crea un nuevo descuento.
  • Una sola comisión por pedido: volver a cargar la página de confirmación, recibir dos notificaciones de pago o pasar varias veces por el mismo estado nunca crea un duplicado (bloqueo y clave única en la base de datos).

En la lista de comisiones, la acción en bloque Aprobar ahora pone fin al periodo de validación de las comisiones seleccionadas. Rechaza los pedidos que aún no están pagados e indica su referencia.

Cálculo

  • Base: productos sin IVA o con IVA (a elegir), nunca los gastos de envío.
  • Cupones de descuento: se descuentan de forma prorrateada en cada línea si la opción está activada. Un cupón de envío gratuito no se descuenta.
  • Monedas: los pedidos realizados en otra moneda se convierten con el tipo de cambio guardado en el pedido.
  • Redondeo: una sola vez por pedido, al céntimo.
  • Importe fijo: una comisión por pedido, y solo una aunque PrestaShop divida un carrito en varios pedidos.
  • Clientes recurrentes: durante el número de días elegido, los pedidos siguientes de un cliente aportado generan una comisión, a la tasa del afiliado o a una tasa específica.

Ningún importe procede del navegador: todo se recalcula a partir del pedido registrado por PrestaShop.

Reglas de comisión y simulador

Simulador de reglas: un pedido reproducido línea por línea, tasa aplicada y regla que prevalece
Simulador de reglas: un pedido reproducido línea por línea, tasa aplicada y regla que prevalece

Una regla fija una tasa para una categoría o un producto, para todos los afiliados o para uno solo. Para cada línea de pedido, la prioridad es la siguiente:

  1. regla de producto;
  2. regla de la categoría por defecto del producto;
  3. mejor regla de las demás categorías;
  4. tasa del afiliado o del programa.

Una regla reservada a un afiliado prevalece sobre la misma regla para todos. Una regla puede sustituir la tasa (una regla al 0 % excluye los productos) o sumarse a ella: un afiliado al 10 % con una regla «+2» cobra un 12 %, con un máximo del 100 %. Las reglas no se aplican a los importes fijos.

El simulador, en la parte superior de la página de reglas, responde a la pregunta «¿qué tasa se aplica y por qué?» para un producto y un afiliado, o reproduce un pedido existente línea por línea, sin crear nada.

Comisiones manuales

Añadir una comisión manual abona o carga un importe a un afiliado (importe negativo para un descuento), con una nota visible en su área.

Antifraude y doble recompensa

Fraude y pagos: comparación de direcciones, convivencia con el programa de recomendación, pago mínimo y fichero SEPA
Fraude y pagos: comparación de direcciones, convivencia con el programa de recomendación, pago mínimo y fichero SEPA
  • Un pedido realizado con la misma cuenta de cliente, el mismo email o, si la opción está activada, enviado o facturado a una dirección del afiliado se registra como rechazado, con un motivo que pueden leer el comerciante y el afiliado.
  • Con el módulo DataFirefly Loyalty & Referral activo, un pedido que ya recompensa a un padrino no genera comisión de afiliación (ajuste modificable). Los datos del módulo de recomendación solo se leen, nunca se modifican. Los dos módulos usan parámetros de URL y cookies diferentes.
  • Solo clientes nuevos e Importe mínimo de pedido completan estas protecciones.

Afiliados

Solicitudes

Página pública del programa de afiliación: presentación, condiciones, pasos y respuestas a las preguntas
Página pública del programa de afiliación: presentación, condiciones, pasos y respuestas a las preguntas

La página pública del programa presenta tus condiciones (tasa, duración de la cookie, periodo de validación, pago mínimo), los pasos y unas preguntas frecuentes generadas a partir de tus ajustes. El texto de presentación se edita en cada idioma.

Formulario de solicitud: sitio o canal, audiencia y aceptación de las condiciones, revisado luego por el comerciante
Formulario de solicitud: sitio o canal, audiencia y aceptación de las condiciones, revisado luego por el comerciante

El candidato debe haber iniciado sesión con una cuenta de cliente. Indica dónde publica y describe su audiencia. Si se ha elegido una página CMS de condiciones, debe aceptarla. Por defecto, cada solicitud espera tu aprobación y la dirección de notificación recibe un email.

Lista y ficha del afiliado

Lista de afiliados: código, canal, estado, clics, pedidos y saldos, aprobación masiva de solicitudes
Lista de afiliados: código, canal, estado, clics, pedidos y saldos, aprobación masiva de solicitudes

La lista muestra el código, el canal, el estado, los clics, los pedidos y los saldos. Las acciones en bloque aprueban, rechazan o suspenden varias solicitudes a la vez. La exportación CSV neutraliza las celdas que una hoja de cálculo podría interpretar como fórmulas.

Ficha completa del afiliado: indicadores, saldo por etapa, condiciones, IBAN enmascarado, enlaces, comisiones, extractos y datos personales
Ficha completa del afiliado: indicadores, saldo por etapa, condiciones, IBAN enmascarado, enlaces, comisiones, extractos y datos personales

La ficha del afiliado reúne en una sola página:

  • el perfil, con los botones Aprobar, Rechazar, Suspender y Editar;
  • los indicadores y el saldo por etapa;
  • las condiciones (tasa, reglas propias, cookie, código de descuento) y el enlace de seguimiento;
  • los datos de pago, con el IBAN enmascarado;
  • la solicitud;
  • los enlaces de los últimos 30 días, las últimas comisiones y los extractos.

El bloque Datos personales exporta en JSON lo que el módulo guarda sobre el afiliado. También permite anonimizarlo: se borran el nombre, el email, la web, los datos de pago, los enlaces y los clics, y las comisiones y los extractos se conservan para tu contabilidad.

En el formulario de edición, el IBAN nunca se vuelve a mostrar completo: deja el campo vacío para conservar el guardado o introduce uno nuevo.

Lo que ve el afiliado

Área de afiliado: saldos en validación, pagable y pagado, enlace rastreado, estadísticas de los últimos 30 días y condiciones
Área de afiliado: saldos en validación, pagable y pagado, enlace rastreado, estadísticas de los últimos 30 días y condiciones

El área de afiliado se abre con una cabecera que muestra su código, su tasa y sus saldos (en validación, pagable, pagado), seguida de seis pestañas. Funciona con los temas Classic y Hummingbird.

  • Resumen: generador de enlaces, indicadores, gráfico de los últimos 30 días, condiciones y enlaces recientes.
  • Generador de enlaces: creación de un enlace corto a cualquier página de la tienda, lista de enlaces con clics, pedidos, copia y eliminación.
  • Estadísticas: clics, pedidos, conversión, ventas y comisiones de 7 días a 12 meses, origen de los clics y rendimiento por enlace.
  • Comisiones: etapa de cada comisión, fecha prevista de pago, referencia del pedido enmascarada. No se muestra ningún dato del cliente.
  • Pagos: extractos mensuales que se pueden consultar e imprimir, elección entre transferencia SEPA o PayPal, IBAN comprobado mediante sus dígitos de control, cifrado y mostrado enmascarado, emails de ventas.
  • Material promocional: banners y textos listos para usar, con el enlace de seguimiento del afiliado ya incluido.
Generador de enlaces: enlace corto a cualquier página de la tienda, clics y pedidos por enlace
Generador de enlaces: enlace corto a cualquier página de la tienda, clics y pedidos por enlace
Estadísticas del afiliado: clics, pedidos, conversión, ventas generadas por periodo, por origen y por enlace
Estadísticas del afiliado: clics, pedidos, conversión, ventas generadas por periodo, por origen y por enlace
Historial de comisiones: etapas del pago al abono, número de pedido enmascarado, ningún dato del cliente
Historial de comisiones: etapas del pago al abono, número de pedido enmascarado, ningún dato del cliente
Pagos del afiliado: extractos mensuales, transferencia SEPA o PayPal, IBAN cifrado y mostrado enmascarado
Pagos del afiliado: extractos mensuales, transferencia SEPA o PayPal, IBAN cifrado y mostrado enmascarado

Un afiliado solo ve sus propios datos: sus enlaces, sus comisiones y sus extractos se comprueban en cada visualización, y los formularios están protegidos con un token.

Material promocional

Material promocional: banners y textos para los afiliados, con vista previa, tamaño y página de destino
Material promocional: banners y textos para los afiliados, con vista previa, tamaño y página de destino

En Material promocional, añade banners (JPG, PNG, GIF o WebP, 2 MB como máximo) y textos listos para usar, con un nombre y un texto alternativo en cada idioma, y la página de la tienda a la que llevan. El orden se ajusta arrastrando y soltando.

Material promocional para afiliados: banners y texto con el enlace de seguimiento ya integrado, copiados en un clic
Material promocional para afiliados: banners y texto con el enlace de seguimiento ya integrado, copiados en un clic

Cada afiliado copia el código HTML del banner, el texto y el enlace, con su enlace de seguimiento ya incluido. La pestaña solo aparece en el área de afiliado si existe al menos un elemento activo.

Extractos y pagos

Extractos y pagos: extractos mensuales, exportación SEPA o PayPal, pago marcado una sola vez
Extractos y pagos: extractos mensuales, exportación SEPA o PayPal, pago marcado una sola vez

El pago se realiza en cuatro pasos, que se recuerdan en la parte superior de la página:

  1. Crear los extractos: elige el mes, previsualiza los importes por afiliado y crea los extractos. Un extracto agrupa las comisiones pagables creadas antes del final del mes y los ajustes negativos. Por debajo del pago mínimo, el saldo se aplaza.
  2. Exportar el fichero de pago: selecciona los extractos y, después, la acción en bloque Fichero de transferencia SEPA (XML, pain.001.001.03) o Fichero PayPal Payouts (CSV). La exportación contable CSV muestra el IBAN enmascarado.
  3. Pagar desde tu banco o PayPal: el módulo nunca envía dinero.
  4. Marcar como pagado, con la referencia y la fecha de la transferencia.
Extracto de un afiliado: líneas de comisión, importe adeudado, datos bancarios enmascarados y referencia de la transferencia
Extracto de un afiliado: líneas de comisión, importe adeudado, datos bancarios enmascarados y referencia de la transferencia

Un extracto pagado ya no se puede exportar ni pagar por segunda vez. Una exportación de pago se rechaza por completo si un extracto seleccionado ya está pagado o si faltan datos: el mensaje indica el afiliado afectado y dónde completarlos.

Tarea cron (opcional)

La URL cron figura en los ajustes. Finaliza los periodos de validación y, si la opción está activada, crea entre el día 1 y el 5 de cada mes los extractos del mes anterior. Está protegida por un token, nunca se ejecuta dos veces a la vez y nunca paga nada.

Emails

El módulo envía cuatro emails, traducidos a 8 idiomas y enviados en el idioma del destinatario, asunto e importes incluidos: nueva solicitud (al comerciante), cuenta de afiliado activada, nueva venta y extracto disponible.

E-mail de «nueva venta» enviado al afiliado: comisión, importe del pedido y tasa, sin ningún dato del cliente
E-mail de «nueva venta» enviado al afiliado: comisión, importe del pedido y tasa, sin ningún dato del cliente
E-mail del extracto mensual: periodo, importe, número de comisiones y enlace al extracto en el área de afiliado
E-mail del extracto mensual: periodo, importe, número de comisiones y enlace al extracto en el área de afiliado

El email de nueva venta indica la comisión, el importe del pedido y la tasa, nunca los datos del cliente. Cada afiliado puede desactivarlo. Las plantillas están en la carpeta mails/ del módulo.

Ajustes

La página de ajustes se organiza en cinco bloques:

  • Seguimiento y atribución: parámetro de URL, duración de la cookie, modelo de atribución, intervalo antiduplicados, consentimiento, clientes recurrentes.
  • Comisiones: tipo y tasa por defecto, base sin IVA o con IVA, descuento de los cupones, solo clientes nuevos, importe mínimo de pedido, estados que confirman el pago o que rechazan la comisión, periodo de validación.
  • Fraude y dobles recompensas.
  • Extractos y pagos: pago mínimo, extractos por cron, datos SEPA de la empresa.
  • Solicitudes y página del programa: aprobación automática, emails, texto de presentación, página de condiciones, color de acento.

Los mensajes de error indican qué corregir, por ejemplo «IBAN de la empresa: los dígitos de control no coinciden».

RGPD

El módulo se registra en el módulo RGPD oficial de PrestaShop. La exportación de los datos de un cliente incluye su perfil de afiliado y sus comisiones, con el IBAN enmascarado. La supresión anonimiza al afiliado y conserva las comisiones y los extractos. Las mismas acciones están disponibles desde la ficha del afiliado. Estas herramientas te ayudan a tramitar las solicitudes, pero no constituyen una garantía de cumplimiento normativo.

Solución de problemas

No se cuenta ningún clic

Haz la prueba en una ventana de navegación privada, sin haber iniciado sesión con la cuenta del afiliado. Los navegadores automatizados se filtran como robots. Con la opción «esperar al consentimiento», acepta primero el servicio en tu banner. Si tu tienda usa una caché de páginas completas, utiliza los enlaces cortos /go/, que siempre pasan por PrestaShop.

Una comisión sigue «pendiente del pago»

Comprueba que el estado actual del pedido esté marcado en Pedido pagado en. Un pedido por transferencia o cheque sigue pendiente mientras no hayas confirmado el pago.

Se rechaza la exportación SEPA

Lee el mensaje que se muestra: indica el extracto ya pagado o el afiliado al que le falta el IBAN. Comprueba también la razón social y el IBAN de la empresa, y que el euro sea la moneda por defecto.

Compatibilidad

  • PrestaShop 1.7.8, 8 y 9: el mismo ZIP cubre las tres ramas, con los temas Classic y Hummingbird.
  • Multitienda: afiliados, comisiones y estadísticas filtrados por tienda. Multimoneda: conversión al tipo de cambio del pedido.
  • Módulo y emails en inglés, francés, español, alemán, italiano, neerlandés, polaco y portugués.
¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte