Advanced Newsletter Suite pentru Magento 2 - instrucțiuni de instalare și configurare

Scopul documentului

Acest document descrie instalarea și configurarea pachetului magento-2-package-advanced-newsletter-suite. Este un pachet complet de newsletter și email marketing pentru Magento 2, care include destinatari, captare, campanii, conținut, trimitere, tracking, panou operațional și puncte de abonare pe frontend.

Cerințe preliminare

Înainte de implementare, pregătiți:

• Magento Open Source 2.4.x,
• Composer,
• acces CLI la bin/magento,
• cont de administrator Magento,
• date de acces SMTP,
• cron Magento configurat,
• pregătirea pentru rularea consumatorilor de cozi,
• mediu de testare pentru verificarea abonării, campaniilor și trimiterilor.

Ce instalează pachetul

Pachetul include:

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

Acesta este cel mai înalt nivel de agregare din ecosistemul modulelor de email marketing pentru Magento.

Instalare

1. Instalarea pachetului Composer

Datele de acces la repository-ul Composer (adresa de e-mail a clientului și tokenul de licență) le veți primi prin e-mail după achiziție. Acestea sunt disponibile și în panoul clientului după autentificare pe kowal.store. Înlocuiți TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului dvs., iar TWOJ_TOKEN cu tokenul primit. Executați comenzile în directorul principal 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. Activarea modulelor în 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

În modul de producție, executați suplimentar:

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

Configurare

1. Secțiunea de administrare

Configurarea de bază ar trebui să fie disponibilă în:

Kowal / Email Marketing

Conform specificației, grupurile de setări așteptate sunt:

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

2. Configurarea trimiterii

Mai întâi configurați fundamentul livrării:

• activitatea modulului,
• tipul implicit de transport,
• logarea trimiterilor,
• contul sau conturile SMTP,
• rutarea mesajelor,
• fallback pentru conturile de rezervă, dacă este utilizat.

Implementarea pachetului complet necesită în continuare un strat SMTP și de transport funcțional.

3. Configurarea destinatarilor și abonărilor

Apoi confirmați configurarea stratului de destinatari:

• integrarea cu newsletter_subscriber,
• listele de mailing,
• segmentele,
• statusurile abonamentelor,
• metadatele suplimentare ale abonatului,
• sursele de achiziție,
• acordurile de marketing.

Configurați de asemenea procesul de abonare:

• formularele și punctele de abonare,
• double opt-in,
• șablonul mesajului de confirmare,
• durata de valabilitate a tokenului de confirmare.

4. Configurarea campaniilor

În secțiunea campaigns setați:

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

Pachetul acceptă:

• definirea campaniei,
• programarea,
• coada destinatarilor,
• procesarea pe loturi a trimiterii,
• istoricul execuției campaniei,
• trimiteri de test.

5. Configurarea Template Studio

Dacă implementarea include lucrul cu conținutul newsletterului, configurați EmailTemplateStudio conform domeniului MVP:

• lucrul pe șabloanele native de newsletter Magento,
• selectarea layouturilor de produse,
• salvarea secțiunii generate în șablonul nativ,
• importul conținutului pregătit în campanie.

6. Configurarea evenimentelor email

În secțiunea events configurați:

• procesarea evenimentelor,
• retenția payload-urilor,
• politica de acceptare a duplicatelor de evenimente de la furnizori.

Stratul EmailEvents răspunde de observabilitatea procesului de livrare și de corelarea evenimentelor cu logurile de transport și campaniile.

7. Configurarea panoului de administrare și a frontendului

Pachetul complet include:

• Kowal_NewsletterConsole ca panou operațional,
• Kowal_NewsletterFrontend ca strat al formularelor și widgeturilor de abonare pe frontend.

După instalare, verificați:

• disponibilitatea dashboardului,
• scurtăturile către configurare și modulele operaționale,
• vizualizarea ultimelor erori și trimiteri,
• prezența formularelor de abonare pe frontendul magazinului.

Cron și consumatorii de cozi

Pachetul complet necesită funcționarea procesării asincrone.

1. Cron Magento

bin/magento cron:install

Cron ar trebui să răspundă de:

• planificarea campaniilor,
• recuperarea sarcinilor,
• watchdog operațional.

2. Queue consumers

Consumatorii de cozi ar trebui să răspundă de procesarea efectivă a loturilor de trimitere. Numele consumatorilor trebuie preluate din fișierele actuale etc/queue_consumer.xml ale modulelor implementate.

În mediul de producție, asigurați:

• rularea consumers în fundal,
• autostart după repornirea serverului,
• monitorizarea defecțiunilor,
• logarea erorilor.

Pași după instalare

După implementare, parcurgeți lista completă de verificare:

1. Configurați și testați contul SMTP.
2. Verificați rutarea mesajelor.
3. Verificați abonarea abonatului și double opt-in.
4. Confirmați compatibilitatea cu newsletterul nativ Magento.
5. Creați o listă sau un segment de test.
6. Pregătiți o campanie de test.
7. Executați test send.
8. Verificați planificarea campaniei prin cron.
9. Verificați procesarea cozii de către consumers.
10. Confirmați salvarea logurilor și a evenimentelor email.
11. Verificați dashboardul administrativ.
12. Verificați formularele și widgeturile de abonare de pe frontend.

Test de acceptanță după implementare

Pachetul este implementat corect dacă:

• modulele se instalează corect în Magento 2.4.x,
• trimiterea SMTP funcționează la nivelul conturilor și rutării,
• abonarea abonatului rămâne compatibilă cu newsletterul nativ Magento,
• campania este planificată de cron și procesată de queue consumer,
• statusurile de livrare actualizează logurile și evenimentele email,
• panoul de administrare afișează date operaționale de bază,
• punctele de abonare de pe frontend funcționează corect,
• după dezactivarea modulelor, mecanismul de bază Magento_Newsletter poate funcționa în continuare.

Observații de implementare

• Merită să implementați pachetul complet împreună cu o configurare SMTP și tracking verificată.
• Datele extinse trebuie stocate în tabele proprii, fără duplicarea tabelului nativ newsletter_subscriber.
• Documentația operațională a implementării ar trebui să includă suplimentar procedura de gestionare a cozilor, webhookurilor și testelor de regresie ale configurării administrative.