Smart Content – Documentación

Visión general

DataFirefly Smart Content personaliza el contenido de tu tienda PrestaShop según el perfil, el comportamiento, el carrito y el contexto de cada visitante. El principio es sencillo: defines segmentos (audiencias) y luego campañas que asocian un segmento a un contenido HTML mostrado en una zona del tema. En cada página, el módulo evalúa al visitante y muestra el contenido de la campaña de mayor prioridad cuyo segmento coincide.

El módulo cubre todo el ciclo: segmentación por comportamiento, difusión multizona, test A/B, estadísticas de conversión y dos asistentes de IA (generación de contenido y sugerencia de segmentos).

Instalación

1. Coloca la carpeta dfsmartcontent en el directorio /modules/ de tu tienda, o instala el ZIP desde Módulos → Gestor de módulos → Subir un módulo.
2. Haz clic en Instalar. Las tablas y las pestañas de administración se crean automáticamente.
3. Aparece un nuevo menú Smart Content, con cuatro subsecciones: Panel, Campañas, Segmentos y Ajustes.

Configuración de los ajustes

Ve a Smart Content → Ajustes. Allí hay dos familias de parámetros.

Parámetros de IA

• URL del endpoint de IA: el endpoint de chat-completions (compatible con OpenAI / Mistral). Valor por defecto: https://api.mistral.ai/v1/chat/completions.
• Modelo de IA: por ejemplo mistral-large-latest o gpt-4o-mini.
• Clave API de IA: tu clave, almacenada en el servidor y nunca expuesta al front. Mientras esté vacía, las funciones de IA están desactivadas pero el resto del módulo funciona con normalidad.

Privacidad

• Respetar el consentimiento de cookies: activado por defecto. Las balizas de seguimiento (impresiones / clics) solo se activan cuando se detecta el consentimiento.

Crear un segmento

Un segmento es una audiencia definida por una o varias reglas. Ve a Smart Content → Segmentos → Añadir segmento.

• Nombre: una etiqueta interna (p. ej. «Clientes VIP»).
• Lógica de coincidencia: Todas las reglas (Y) exige que cada regla sea verdadera; Cualquier regla (O) basta con que una lo sea.
• Prioridad: los segmentos de mayor prioridad se evalúan primero.
• Reglas: añade tus condiciones fila por fila con el constructor visual.

Referencia de reglas

Cada regla tiene un atributo, un operador y un valor. Para las listas, separa los valores con comas. Para los rangos (operador between), indica dos valores separados por coma.

• customer_group — grupo de cliente (IDs). Operadores: in / not_in.
• logged_in — visitante conectado (1 o 0). Operador: eq.
• new_returning — new o returning según el historial de pedidos. Operador: eq.
• country — país (IDs). Operadores: in / not_in.
• language — idioma (IDs). Operadores: in / not_in.
• currency — moneda (IDs). Operadores: in / not_in.
• device — desktop, tablet o mobile. Operador: in.
• orders_count — número de pedidos válidos. Operadores: gte / lte / eq / between.
• total_spent — total gastado. Operadores: gte / lte / between.
• days_since_order — días desde el último pedido. Operadores: gte / lte / between.
• cart_total — total del carrito actual. Operadores: gte / lte / between.
• cart_has_category — categoría presente en el carrito (IDs). Operador: in.
• cart_has_product — producto presente en el carrito (IDs). Operador: in.
• newsletter — suscriptor de la newsletter (1 o 0). Operador: eq.
• source_utm — fuente UTM de la sesión. Operadores: eq / contains.
• referrer — sitio de referencia. Operadores: contains / not_contains.
• hour_range — franja horaria (p. ej. 9,18). Operador: between.
• weekday — día de la semana (1 = lunes … 7 = domingo). Operador: in.
• visits — número de visitas del visitante. Operadores: gte / lte / eq.

Ejemplo — segmento «Grandes compradores a reactivar», lógica Y: total_spent gte 200 + days_since_order gte 60.

Crear una campaña

Una campaña difunde un contenido a uno o varios segmentos en una zona del tema. Ve a Smart Content → Campañas → Añadir campaña.

• Nombre: etiqueta interna.
• Zona de visualización: el hook donde aparece el contenido (ver la lista más abajo).
• Segmentos objetivo: uno o varios segmentos. Déjalo vacío para dirigirte a todos los visitantes.
• Prioridad: si varias campañas apuntan a la misma zona, gana la de mayor prioridad que coincida.
• Test A/B: actívalo para difundir varias variantes (ver la sección dedicada).
• Límite de frecuencia: número máximo de impresiones por visitante (0 = ilimitado), sobre una ventana expresada en días.
• Fechas de inicio / fin: programación opcional de la campaña.
• Variantes de contenido: el contenido HTML, editable por idioma.

Zonas de visualización disponibles

displayHome, displayTop, displayNav1, displayBanner, displayWrapperTop, displayWrapperBottom, displayLeftColumn, displayRightColumn, displayFooter, displayProductAdditionalInfo, displayShoppingCartFooter.

Test A/B

Activa la opción Test A/B en la campaña y luego añade varias variantes. Cada variante tiene una etiqueta (A, B, …) y un peso. El módulo sortea una variante en cada visualización, proporcionalmente a los pesos. Sin test A/B, se usa la primera variante activa.

El contenido de cada variante se introduce por idioma. El panel compara después el rendimiento de cada variante (impresiones, CTR, CVR, ingresos).

Generador de contenido por IA

En el editor de campaña, el panel Generador de contenido por IA redacta un bloque HTML orientado a la conversión. Indica el nombre del segmento, una descripción de la audiencia, el objetivo del mensaje y el tono, elige el idioma y haz clic en Generar. El contenido producido se inserta en el área de texto de la variante / idioma activos.

Sugerencia de segmentos por IA

Desde Smart Content → Segmentos, el botón Sugerencias de segmentos por IA abre una página que resume las estadísticas reales de tu tienda (clientes activos, pedidos, compradores recurrentes, suscriptores de la newsletter…). Haz clic en Generar sugerencias: la IA propone de 3 a 5 segmentos de alto valor, cada uno con una descripción, una justificación y un conjunto de reglas listas para copiar en el formulario de creación.

Panel y estadísticas

Smart Content → Panel agrega el rendimiento del periodo elegido: impresiones, clics y tasa de clics (CTR), conversiones y tasa de conversión (CVR), e ingresos atribuidos. Una tabla desglosa los resultados por campaña y otra compara las variantes A/B.

Cómo se atribuyen las conversiones

Al hacer clic en un bloque personalizado, la última interacción (campaña, variante, segmento) se guarda en la cookie de sesión. Al validar un pedido, el módulo atribuye la conversión y sus ingresos a esa campaña, y luego borra la atribución para evitar el doble cómputo.

Privacidad y RGPD

• No se almacena ningún dato personal: el seguimiento se basa en un identificador de visitante anónimo (un hash), usado para el límite de frecuencia y la deduplicación.
• La opción Respetar el consentimiento de cookies condiciona cuándo se activa la medición. Señales reconocidas: window.dfscConsentGranted = true, o las cookies hideBanner=1, axeptio_authorized, cookieconsent_status=allow.
• Para conectar tu propia CMP, asigna window.dfscConsentGranted a true una vez obtenido el consentimiento.

Inserción mediante widget

El módulo implementa la interfaz de widget de PrestaShop. Por tanto, puedes insertar un bloque directamente en una plantilla:

{widget name='dfsmartcontent' hook='displayHome'}

El parámetro hook indica qué zona evaluar.

FAQ y resolución de problemas

Mi bloque no se muestra

Comprueba que la campaña esté activa, que su zona corresponda a un hook presente en tu tema, que al menos una variante tenga contenido para el idioma actual y que el visitante coincida con un segmento objetivo. Si se alcanza un límite de frecuencia, el bloque deja de mostrarse a ese visitante durante la ventana definida.

Las estadísticas siguen a cero

Si la opción de consentimiento está activa, las balizas solo se activan tras la aprobación. Comprueba que tu banner de cookies emita una de las señales reconocidas, o asigna window.dfscConsentGranted.

Las funciones de IA devuelven un error

Asegúrate de que la clave API, la URL y el modelo sean correctos en los Ajustes, y de que tu servidor pueda alcanzar el endpoint en salida.