Il passaggio dal vecchio plugin a quello nuovo per Shopware 6

Con la nuova versione del nostro plugin per Shopware 6, ti offriamo prestazioni ancora migliori e funzionalità potenziate. Il processo di migrazione è parzialmente automatizzato tramite una finestra modale e richiede solo pochi minuti.
In questa guida ti spiegheremo, passo dopo passo, come passare dalla tua attuale integrazione al nuovo plugin.

• Una panoramica delle principali differenze
• Prerequisiti e preparazione
• Installazione:
  • Passaggio 1: Installare un nuovo plugin
  • Passaggio 2: Apri la finestra modale di migrazione e avvia il trasferimento dei dati
  • Passaggio 3: Configurare le impostazioni di importazione
  • Passaggio 4: Completamento e verifica del funzionamento
• Cosa rimane uguale e cosa cambia?
• Modello di autorizzazioni e ruoli
• Problemi noti (limitazioni note)
• Domande frequenti

Nota importante: 
La vecchia connessione verrà disattivata automaticamente non appena clicchi nella finestra modale di migrazione opzione di trasferimento automatico su Applica impostazioni . Se scegli la configurazione manuale Configura manualmente , la disattivazione automatica non avverrà.

Le differenze più importanti in sintesi

Prerequisiti e Preparazione

Per garantire che la migrazione e la successiva sincronizzazione procedano senza intoppi, assicurati di aver curato in anticipo i seguenti punti:

Passo 1: Installa il nuovo plugin

1. Accedi al tuo account Shopware e vai su Estensioni > Negozio.
2. Cerca il nuovo plugin CleverReach e clicca su Installa estensione.
   
   

Passo 2: Apri la finestra modale di migrazione e avvia il trasferimento dei dati

1. Clicca sulla voce di menu Le mie estensioni. Qui ora sono elencati sia il vecchio che il nuovo plugin di CleverReach. Attiva il nuovo plugin usando il cursore. 
   
   
2. Nel menu, clicca su Marketing e seleziona il nuovo plugin CleverReach .

3. Non appena apri il nuovo plugin per la prima volta, il sistema rileva automaticamente la connessione esistente. Appare una finestra (modale) con due opzioni:
   
   

   Importazione automatica (consigliata): Il plugin importa l’elenco dei destinatari già collegati direttamente dal vecchio plugin.

   Nota tecnica importante: Inoltre, durante questa fase, la connessione tra il vecchio plugin e CleverReach viene automaticamente interrotta e il plugin viene disattivato automaticamente nelle estensioni di Shopware. Si tratta di un meccanismo di sicurezza pensato per:

   • Prevenire sincronizzazioni duplicate.

   • Mantenere le prestazioni del tuo negozio.

   • Nel passaggio successivo, potrai collegare la nostra nuova app al tuo account CleverReach .

   Collegamento manuale: Seleziona questa opzione se vuoi collegarti a un altro account CleverReach . Nota: La vecchia app non verrà disattivata. Tieni presente che questo potrebbe causare incongruenze nei dati.

4. Nel passaggio successivo, seleziona quali liste di destinatari vuoi importare e clicca su Avanti.
   
   

Passaggio 3: Configura le impostazioni di importazione

In questo passaggio, ci sono tantissime impostazioni di importazione. 

• Quali gruppi di clienti importare (iscritti alla newsletter, clienti che hanno effettuato un acquisto, altri contatti)
• Se trasferire la cronologia degli ordini (impostazione predefinita: ultimi 12 mesi, modificabile fino a 24 mesi)
• Se importare i tag 
• Se i campi dati devono essere mappati. 

Infine, clicca su Avvia importazione.

Nota: L' importazione avviene in background. Puoi passare da una scheda all'altra o continuare a lavorare in altri menu. Tieni aperta la scheda del browser finché il processo non è completato.

Passaggio 4: Completamento e verifica del funzionamento

Una volta completata la migrazione, riceverai una conferma nella finestra modale. La tua nuova dashboard è pronta e puoi tornare a sfruttare appieno la tua integrazione con CleverReach. 

Nota: Il vecchio plugin è stato automaticamente disattivato. Ora puoi tranquillamente disinstallare ed eliminare la vecchia versione del plugin dal backend di Shopware.

Cosa rimane uguale e cosa cambia?

Uso dei tag
Il formato dei tag corrisponde esattamente a quello dell’interfaccia precedente. I tuoi segmenti e le tue automazioni esistenti continueranno quindi a funzionare senza problemi e non richiedono alcuna modifica.

Utilizzo dei moduli
La nuova integrazione utilizza il nostro attuale modulo moduli. I vecchi moduli non sono più supportati. Crea il modulo che desideri direttamente in CleverReach, così potrai poi integrarlo tramite l’interfaccia.

Creazione di segmenti
Al momento non è prevista la creazione di nuovi segmenti direttamente tramite l’integrazione. Tuttavia, puoi continuare a utilizzare i tuoi segmenti esistenti senza alcuna limitazione: Poiché il formato dei tag rimane invariato, tutte le segmentazioni e i filtri basati sui campi dati funzioneranno come al solito.

Utilizzo delle automazioni
Hai già impostato delle automazioni basate sui tag? Queste continueranno a funzionare senza alcun intervento manuale. Ti consigliamo semplicemente di fare un rapido controllo per assicurarti che tutti i trigger si attivino come previsto.

Modello di autorizzazioni e ruoli

Grazie alla gestione delle autorizzazioni di Shopware, puoi assegnare diversi ruoli per l’accesso al plugin CleverReach:

• Problema/Argomento	Causa/Soluzione
  L'importazione in CleverReach si blocca quando è attiva la protezione con password (.htaccess)	Causa: Negli ambienti protetti da password (Basic Auth / Staging), l’importazione si blocca in un ciclo infinito (Spinner infinito), perché i processi in background sono bloccati (401 ). Soluzione: Disattiva temporaneamente la protezione con password per l’importazione, oppure abilita i seguenti percorsi API nella configurazione del tuo server: /api/crsw-on-prem-CleverReach/webhook/receiver   /api/crsw-on-prem-CleverReach/webhook/abandonedCart
  La sincronizzazione non parte	Controlla:  1. I worker della coda dei messaggi o quelli di amministrazione sono in esecuzione? 2. L’autenticazione CleverReach è valida? 3. I file di log del plugin contengono errori?
  La sincronizzazione si interrompe prima del completamento	Controlla: 1. La coda dei messaggi. 2. I file di log del plugin. 3. La validità della connessione OAuth.
  Problemi con sincronizzazioni di grandi dimensioni (50.000 voci o più)	Causa: Il valore predefinito per il timeout della query è di 3600 secondi (1 ora). Se il processo richiede più tempo, un worker recupererà nuovamente il messaggio. Soluzione: Imposta il timeout per il trasporto DSN redeliver_timeout su un valore più alto (consigliato: 8 ore): MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0&redeliver_timeout=28800
  Le email relative ai carrelli abbandonati non vengono inviate.	Controlla quanto segue: 1. L’automazione di CleverReach per i “Carrelli abbandonati ” è abilitata? 2. I worker per le attività pianificate (Attività pianificate) sono in esecuzione? 3. I log mostrano errori relativi ai webhook o all’automazione?
  Le email relative ai carrelli abbandonati vengono inviate con un leggero ritardo	Spiegazione: Il plugin esegue un controllo programmato ogni 15 minuti (Esecuzione programmata) per verificare la presenza di nuovi carrelli abbandonati. A seconda dell’intervallo di tempo, l’invio potrebbe quindi subire un leggero ritardo.
  Il gruppo collegato non deve essere eliminato in CleverReach	Spiegazione: La “Modalità offline” per il rilevamento automatico dei gruppi eliminati non è ancora integrata. Soluzione: Non cancellare manualmente la lista dei destinatari collegata in CleverReach.
  I vecchi moduli non funzionano più dopo il cambio di plugin	Soluzione: Quando passi al nuovo plugin, i moduli precedentemente integrati negli Shopware Experience Worlds devono essere sostituiti manualmente con i nuovi moduli.
  Sincronizzazione bidirezionale dai moduli Flow di CleverReach a Shopware	Soluzione: Per garantire la sincronizzazione in entrambe le direzioni, il Flow Form in CleverReach deve essere configurato con lo stesso elenco di destinatari del plugin.

• Domanda	Risposta
  Posso passare semplicemente dalla vecchia interfaccia a quella nuova senza perdere nessun dato?	Sì. La migrazione è parzialmente automatizzata tramite una finestra modale e richiede solo pochi minuti. La tua lista di destinatari esistente verrà trasferita automaticamente. Durante questo processo, viene disattivato automaticamente anche il vecchio plugin di CleverReach. Dopo aver selezionato la lista dei destinatari, puoi configurare individualmente i dati aggiuntivi per l’importazione.
  Devo prima disinstallare il vecchio plugin?	No. Lascia attivo il vecchio plugin per ora. Non appena il primo passo (finestra modale di migrazione) nel nuovo plugin sarà completato con successo , la vecchia connessione verrà automaticamente interrotta e il vecchio plugin disattivato. Una volta completata l’ importazione nella nuova interfaccia, potrai disinstallare il vecchio plugin.
  Quale versione di Shopware mi serve per il nuovo plugin?	Il plugin supporta Shopware 6.6 e 6.7, oltre a PHP 8.2 o versioni successive.
  Quali dati vengono trasferiti durante la migrazione?	Utilizzando la finestra modale di migrazione nel nuovo plugin, puoi scegliere se caricare i dati automaticamente o configurarli manualmente. Se selezioni “Automatico”, leggeremo l’elenco dei destinatari CleverReach già collegato e lo importeremo nel nuovo plugin. Puoi comunque modificare questa impostazione in un secondo momento. Inoltre, nei successivi passaggi di configurazione, puoi selezionare singolarmente altre nuove opzioni di importazione (dati degli ordini, tag, campi dati).
  Devo reinserire i miei moduli di iscrizione alla newsletter?	Sì. La nuova interfaccia utilizza il nostro nuovo modulo per i moduli. I vecchi moduli presenti nei tuoi “worlds” non funzioneranno più con la nuova interfaccia e devono essere sostituiti con nuovi moduli.
  Cosa succede con la conferma del double opt-in quando uso CleverReach?	Se attivi la funzione di double opt-in di CleverReach, CleverReach invia l’email di conferma e l’email di Shopware viene soppressa. L’intero processo di conferma viene quindi gestito tramite il tuo modulo CleverReach.
  I miei segmenti e le mie automazioni esistenti continueranno a funzionare?	Sì. Il formato dei tag rimane identico a quello della vecchia interfaccia, quindi i segmenti esistenti e le automazioni basate sui tag continueranno a funzionare senza bisogno di intervenire manualmente. Ti consigliamo di fare un rapido controllo delle funzionalità dopo la migrazione.
  Più dipendenti con permessi diversi possono accedere all’integrazione?	Sì. Usando la gestione dei permessi di Shopware, puoi assegnare diversi ruoli: dall’accesso in sola lettura (visualizzazione solo della dashboard/dei log) ai permessi di modifica (cambiamento delle impostazioni, avvio della sincronizzazione/importazione) fino all’accesso amministrativo completo.
  L’email relativa al carrello abbandonato non arriva esattamente all’ora impostata. È normale?	Sì, il plugin controlla la presenza di nuovi carrelli abbandonati ogni 15 minuti, quindi l’invio potrebbe subire un ritardo fino a questo periodo di tempo.
  Il mio negozio è protetto da password (ad es. ambiente di staging) — l’importazione si è bloccata. Cosa devo fare?	Negli ambienti protetti da password (autenticazione di base), la protezione tramite password blocca i processi in background dell’importazione (errore 401), causando un caricamento infinito. Consenti i seguenti due percorsi API nella tua configurazione .htaccess (whitelist), oppure disattiva temporaneamente la protezione con password per l’importazione: /api/crsw-on-prem-CleverReach/webhook/receiver /api/crsw-on-prem-CleverReach/webhook/abandonedCart

Aiuto e assistenza

Se hai domande o hai bisogno di aiuto, non esitare a contattare il nostro team di assistenza in qualsiasi momento.