Advanced Newsletter Suite para Magento 2 - instrucciones de instalación y configuración

Objetivo del documento

Este documento describe la instalación y configuración del paquete magento-2-package-advanced-newsletter-suite. Es un paquete completo de newsletter y email marketing para Magento 2, que abarca destinatarios, captación, campañas, contenido, envío, tracking, panel operativo y puntos de suscripción en el frontend.

Requisitos previos

Antes de la implementación, prepare:

• Magento Open Source 2.4.x,
• Composer,
• acceso CLI a bin/magento,
• cuenta de administrador de Magento,
• datos de acceso SMTP,
• cron de Magento configurado,
• disponibilidad para ejecutar consumidores de colas,
• entorno de pruebas para comprobar la suscripción, las campañas y los envíos.

Qué instala el paquete

El paquete incluye:

• Kowal_MarketingCore,
• Kowal_EmailTransport,
• Kowal_EmailSmtp,
• Kowal_EmailEvents,
• Kowal_EmailTemplateStudio,
• Kowal_NewsletterAudience,
• Kowal_NewsletterCapture,
• Kowal_NewsletterCampaigns,
• Kowal_NewsletterConsole,
• Kowal_NewsletterFrontend.

Es el nivel más alto de agregación en el ecosistema de módulos de email marketing para Magento.

Instalación

1. Instalación del paquete Composer

Recibirá por correo electrónico los datos de acceso al repositorio Composer (dirección de email del cliente y token de licencia) tras la compra. También están disponibles en el panel de cliente después de iniciar sesión en kowal.store. Sustituya TWOJ_EMAIL_KLIENTA por la dirección de email de su cuenta y TWOJ_TOKEN por el token recibido. Ejecute los comandos en el directorio raíz de Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/package-advanced-newsletter-suite

2. Activación de los módulos en Magento

bin/magento module:enable \ Kowal_MarketingCore \ Kowal_EmailTransport \ Kowal_EmailSmtp \ Kowal_EmailEvents \ Kowal_EmailTemplateStudio \ Kowal_NewsletterAudience \ Kowal_NewsletterCapture \ Kowal_NewsletterCampaigns \ Kowal_NewsletterConsole \ Kowal_NewsletterFrontendbin/magento setup:upgradebin/magento cache:flush

En modo producción, ejecute además:

bin/magento setup:di:compilebin/magento setup:static-content:deploy -f

Configuración

1. Sección de administración

La configuración básica debería estar disponible en:

Kowal / Email Marketing

De acuerdo con la especificación, los grupos de ajustes esperados son:

• general,
• transport,
• smtp,
• campaigns,
• double_opt_in,
• events.

2. Configuración del envío

Primero configure la base de delivery:

• actividad del módulo,
• tipo de transporte predeterminado,
• registro de envíos,
• cuenta o cuentas SMTP,
• routing de mensajes,
• fallback para cuentas de respaldo, si se utiliza.

La implementación del paquete completo sigue requiriendo una capa SMTP y de transporte operativa.

3. Configuración de destinatarios y suscripciones

A continuación, confirme la configuración de la capa de destinatarios:

• integración con newsletter_subscriber,
• listas de mailing,
• segmentos,
• estados de suscripción,
• metadatos adicionales del suscriptor,
• fuentes de captación,
• consentimientos de marketing.

Configure también el proceso de suscripción:

• formularios y puntos de suscripción,
• double opt-in,
• plantilla del mensaje de confirmación,
• tiempo de validez del token de confirmación.

4. Configuración de campañas

En la sección campaigns configure:

• batch_size,
• max_retry_count,
• send_rate_limit_per_run,
• watchdog_timeout_minutes.

El paquete admite:

• definición de campañas,
• calendario,
• cola de destinatarios,
• envío por lotes,
• historial de ejecución de campañas,
• envíos de prueba.

5. Configuración de Template Studio

Si la implementación incluye trabajo con el contenido del newsletter, configure EmailTemplateStudio de acuerdo con el alcance del MVP:

• trabajo sobre plantillas nativas de newsletter de Magento,
• selección de layouts de producto,
• guardado de la sección generada en la plantilla nativa,
• importación del contenido preparado a la campaña.

6. Configuración de eventos de email

En la sección events configure:

• procesamiento de eventos,
• retención de payloads,
• política de aceptación de eventos duplicados de proveedores.

La capa EmailEvents se encarga de la observabilidad del proceso de entrega y de vincular los eventos con los logs de transporte y las campañas.

7. Configuración del panel de administración y del frontend

El paquete completo incluye:

• Kowal_NewsletterConsole como panel operativo,
• Kowal_NewsletterFrontend como capa de formularios y widgets de suscripción en el frontend.

Después de la instalación, verifique:

• disponibilidad del dashboard,
• accesos directos a la configuración y a los módulos operativos,
• vista de los últimos errores y envíos,
• presencia de formularios de suscripción en el frontend de la tienda.

Cron y consumidores de colas

El paquete completo requiere que funcione el procesamiento asíncrono.

1. Cron de Magento

bin/magento cron:install

Cron debería encargarse de:

• planificación de campañas,
• recuperación de tareas,
• watchdog operativo.

2. Queue consumers

Los consumidores de colas deberían encargarse del procesamiento real de los lotes de envío. Los nombres de los consumidores deben tomarse de los archivos actuales etc/queue_consumer.xml de los módulos implementados.

En el entorno de producción, asegúrese de:

• ejecutar consumers en segundo plano,
• autostart tras el reinicio del servidor,
• monitorizar fallos,
• registrar errores.

Pasos posteriores a la instalación

Después de la implementación, complete toda la lista de comprobación:

1. Configure y pruebe la cuenta SMTP.
2. Verifique el routing de mensajes.
3. Compruebe la suscripción del suscriptor y el double opt-in.
4. Confirme la compatibilidad con el newsletter nativo de Magento.
5. Cree una lista o segmento de prueba.
6. Prepare una campaña de prueba.
7. Realice un envío de prueba.
8. Compruebe la planificación de campañas mediante cron.
9. Verifique el procesamiento de la cola por parte de consumers.
10. Confirme el registro de logs y eventos de email.
11. Compruebe el dashboard de administración.
12. Verifique los formularios y widgets de suscripción del frontend.

Prueba de aceptación posterior a la implementación

El paquete está correctamente implementado si:

• los módulos se instalan correctamente en Magento 2.4.x,
• el envío SMTP funciona desde las cuentas y el routing,
• la suscripción del suscriptor sigue siendo compatible con el newsletter nativo de Magento,
• la campaña se planifica mediante cron y se procesa mediante queue consumer,
• los estados de entrega actualizan los logs y los eventos de email,
• el panel de administración muestra los datos operativos básicos,
• los puntos de suscripción del frontend funcionan correctamente,
• tras desactivar los módulos, el mecanismo base Magento_Newsletter puede seguir funcionando.

Notas de implementación

• Conviene implementar el paquete completo junto con una configuración SMTP y de tracking verificada.
• Los datos ampliados deben almacenarse en tablas propias, sin duplicar la tabla nativa newsletter_subscriber.
• La documentación operativa de la implementación debería incluir además el procedimiento de gestión de colas, webhooks y pruebas de regresión de la configuración administrativa.