Advanced Newsletter Suite per Magento 2 - istruzioni di installazione e configurazione

Scopo del documento

Questo documento descrive l'installazione e la configurazione del pacchetto magento-2-package-advanced-newsletter-suite. È una suite completa per newsletter ed email marketing per Magento 2, che include destinatari, capture, campagne, contenuti, invio, tracking, pannello operativo e punti di iscrizione sul frontend.

Prerequisiti

Prima dell'implementazione, prepara:

• Magento Open Source 2.4.x,
• Composer,
• accesso CLI a bin/magento,
• account amministratore Magento,
• dati di accesso SMTP,
• cron Magento configurato,
• disponibilità ad avviare i consumer delle code,
• ambiente di test per verificare iscrizione, campagne e invii.

Cosa installa il pacchetto

Il pacchetto include:

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

È il massimo livello di aggregazione nell'ecosistema dei moduli di email marketing per Magento.

Installazione

1. Installazione del pacchetto Composer

Riceverai via e-mail i dati di accesso al repository Composer, ovvero l'indirizzo e-mail del cliente e il token di licenza, dopo l'acquisto. Sono disponibili anche nel pannello cliente dopo l'accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l'indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di 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. Attivazione dei moduli in 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

In modalità produzione, esegui inoltre:

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

Configurazione

1. Sezione amministrativa

La configurazione di base dovrebbe essere disponibile in:

Kowal / Email Marketing

Secondo la specifica, i gruppi di impostazioni previsti sono:

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

2. Configurazione dell'invio

Per prima cosa configura la base del delivery:

• attività del modulo,
• tipo di trasporto predefinito,
• logging degli invii,
• account o account SMTP,
• routing dei messaggi,
• fallback per gli account di riserva, se utilizzato.

L'implementazione della suite completa richiede comunque un livello SMTP e di trasporto funzionante.

3. Configurazione di destinatari e iscrizioni

Successivamente conferma la configurazione del livello destinatari:

• integrazione con newsletter_subscriber,
• liste mailing,
• segmenti,
• stati di sottoscrizione,
• metadati aggiuntivi del sottoscrittore,
• fonti di acquisizione,
• consensi marketing.

Configura anche il processo di iscrizione:

• moduli e punti di iscrizione,
• double opt-in,
• template del messaggio di conferma,
• tempo di validità del token di conferma.

4. Configurazione delle campagne

Nella sezione campaigns imposta:

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

Il pacchetto supporta:

• definizione della campagna,
• pianificazione,
• coda dei destinatari,
• invio in batch,
• cronologia di esecuzione della campagna,
• invii di test.

5. Configurazione di Template Studio

Se l'implementazione include il lavoro sui contenuti della newsletter, configura EmailTemplateStudio in conformità con l'ambito MVP:

• lavoro sui template newsletter nativi di Magento,
• selezione dei layout prodotto,
• salvataggio della sezione generata nel template nativo,
• importazione dei contenuti pronti nella campagna.

6. Configurazione degli eventi email

Nella sezione events configura:

• elaborazione degli eventi,
• retention dei payload,
• policy di accettazione dei duplicati degli eventi dai provider.

Il livello EmailEvents è responsabile dell'osservabilità del processo di consegna e del collegamento degli eventi con i log di trasporto e le campagne.

7. Configurazione del pannello amministrativo e del frontend

Il pacchetto completo include:

• Kowal_NewsletterConsole come pannello operativo,
• Kowal_NewsletterFrontend come livello per moduli e widget di iscrizione frontend.

Dopo l'installazione verifica:

• disponibilità della dashboard,
• scorciatoie alla configurazione e ai moduli operativi,
• vista degli ultimi errori e invii,
• presenza dei moduli di iscrizione sul frontend del negozio.

Cron e consumer delle code

Il pacchetto completo richiede il funzionamento dell'elaborazione asincrona.

1. Cron Magento

bin/magento cron:install

Cron dovrebbe essere responsabile di:

• pianificazione delle campagne,
• recupero delle attività,
• watchdog operativo.

2. Queue consumers

I consumer delle code dovrebbero essere responsabili dell'elaborazione effettiva dei batch di invio. I nomi dei consumer devono essere recuperati dai file aggiornati etc/queue_consumer.xml dei moduli implementati.

Nell'ambiente di produzione assicurati di:

• eseguire i consumer in background,
• abilitare l'avvio automatico dopo il riavvio del server,
• monitorare i guasti,
• registrare gli errori.

Passaggi dopo l'installazione

Dopo l'implementazione, esegui la checklist completa:

1. Configura e testa l'account SMTP.
2. Verifica il routing dei messaggi.
3. Controlla l'iscrizione del sottoscrittore e il double opt-in.
4. Conferma la compatibilità con la newsletter nativa di Magento.
5. Crea una lista o un segmento di test.
6. Prepara una campagna di test.
7. Esegui un invio di test.
8. Controlla la pianificazione della campagna tramite cron.
9. Verifica l'elaborazione della coda da parte dei consumer.
10. Conferma il salvataggio dei log e degli eventi email.
11. Controlla la dashboard amministrativa.
12. Verifica i moduli e i widget di iscrizione frontend.

Test di accettazione dopo l'implementazione

Il pacchetto è implementato correttamente se:

• i moduli si installano correttamente in Magento 2.4.x,
• l'invio SMTP funziona a livello di account e routing,
• l'iscrizione del sottoscrittore rimane conforme alla newsletter nativa di Magento,
• la campagna viene pianificata tramite cron ed elaborata da queue consumer,
• gli stati di consegna aggiornano i log e gli eventi email,
• il pannello amministrativo mostra i dati operativi di base,
• i punti di iscrizione frontend funzionano correttamente,
• dopo la disattivazione dei moduli, il meccanismo di base Magento_Newsletter può continuare a funzionare.

Note di implementazione

• Conviene implementare il pacchetto completo insieme a una configurazione SMTP e di tracking verificata.
• I dati di estensione devono essere conservati in tabelle dedicate, senza duplicare la tabella nativa newsletter_subscriber.
• La documentazione operativa dell'implementazione dovrebbe includere inoltre la procedura di gestione di code, webhook e test di regressione della configurazione amministrativa.