Guida all'integrazione con Magento 2

Se il tuo eCommerce è sviluppato in Magento, potrai integrarlo facilmente con Connectif e iniziare a raccogliere dati sui tuoi clienti per creare le tue campagne.

In questo articolo imparerai come installare e configurare il modulo di Connectif per Magento 2.

 
Tempo di implementazione: 15-20 min.
Difficoltà: Avanzata (richiede conoscenze tecniche).
Quando utilizzarlo?: All'apertura del tuo account in Connectif.

 

PASSO 1. Download e installazione del modulo Magento 2

A seconda della versione di Magento che utilizza il tuo eCommerce, dovrai seguire passaggi diversi:

  • Se hai una versione precedente a Magento 2.2, consulta la sezione A di questo passaggio.
  • Se hai una versione successiva a Magento 2.2, consulta la sezione B di questo passaggio.

 

A. Versioni precedenti a Magento 2.2

A.1. Download del modulo

1. Accedi al tuo account Connectif.

2. Accedi a Impostazioni del Negozio nel menu laterale sinistro.

3. Nella sezione Piattaforme e-commerce, cerca Magento e clicca su Modifica.

Guida per integrare con Magento 2 Ene 25 - 10-min.png

 

4. Nella sezione Configurazione, clicca su  Scarica Modulo Magento 2 per scaricare il file “connectif.zip” sul tuo computer.

Guida per integrare con Magento 2 Ene 25 - 11-min.png

 

A.2. Copia della cartella Connectif nell'installazione di Magento

5. Copia la cartella "Connectif" e tutto il suo contenuto all'interno della cartella "/app/code/", situata nella directory principale dell'installazione di Magento 2.

 

Se la cartella "/app/code/" non esiste, dovrà essere creata manualmente.

 

Ad esempio, se il percorso di installazione di Magento 2 è "/var/www/html" la cartella "Connectif" dovrà essere copiata in "/var/www/html/app/code/Connectif".

 

A.3. Installazione del modulo

6. Accedi al pannello di amministrazione di Magento 2 e vai alla sezione "System > Web Setup Wizard".

 

Il SetUp Wizard è stato rimosso a partire dalla versione 2.4.0 di Magento, quindi sarà necessario abilitare l'integrazione tramite comandi, disponibili nel punto 2b della documentazione di installazione allegata al file "connectif.zip" scaricato nel passo 2. Maggiori informazioni sono disponibili nella documentazione di Magento.

Magento_Integracion_-_3.png

7. In Module Manager, cerca il modulo Connectif_Integration e seleziona Activate.

Magento_Integracion_-_4.png

8. Segui i passaggi indicati per l'installazione del modulo Connectif e clicca su Avanti:

  • Readiness Check: in questa fase vengono effettuati controlli relativi alla versione di PHP, ai cron job, alle dipendenze e alle estensioni.

Magento_Integracion_-_5.png

  • Backup: in questa fase viene creata una copia di sicurezza dell'eCommerce prima dell'installazione del modulo. 

Magento_Integracion_-_7.png

  • Enable module: in questa fase viene attivato il modulo. 

Magento_Integracion_-_8.png

 

B. Versioni successive a Magento 2.2

B.1. Download del modulo

1. Accedi al tuo account Connectif.

2. Accedi a Impostazioni del Negozio nel menu laterale sinistro.

3. Nella sezione Piattaforme e-commerce, cerca Magento e clicca su Modifica.

Guida per integrare con Magento 2 Ene 25 - 10-min.png

12. Nella sezione Configurazione, clicca su  Scarica Modulo Magento 2 per scaricare il file “connectif.zip” sul tuo computer.

Guida per integrare con Magento 2 Ene 25 - 11-min.png

B.2. Copia della cartella Connectif nell'installazione di Magento

13. Accedi al negozio Magento 2.x tramite una connessione SSH.

14. Dopo un accesso SSH riuscito, utilizzando la riga di comando (shell), vai alla directory principale di Magento dove è installato Magento 2.

15. Carica il modulo (come Zip o tar.gz) nella directory principale di installazione di Magento 2.

16. Decomprimi il file in una directory temporanea.

17. La posizione in cui copiare il modulo decompresso deve essere “app/code/Connectif/”. Crea questa cartella con il seguente comando:

mkdir –p app/code/Connectif/

18. Copia il contenuto della cartella decompressa nella cartella creata nel passaggio precedente:

cp -R Connectif/* app/code/Connectif/

19. Esegui il comando di installazione di Magento 2 dalla root: 

php bin/magento setup:upgrade

20. Compila il modulo installato con:

php bin/magento setup:upgrade

21. Svuota la cache con:

php bin/magento cache:flush
 

Il modulo sarà installato e visibile in Stores > Configuration > Advanced > Advanced. Il modulo apparirà in questa sezione nell'elenco dei moduli installati in Magento.

 

PASSO 2. Attivazione del modulo

  

Questa configurazione è la stessa sia per le versioni precedenti che per quelle successive a Magento 2.2.

22. Vai su "Stores > Configuration > " e individua la configurazione di Connectif.

Magento_Integracion_-_9.png

23. In Basic Configuration, seleziona l'opzione Yes nel campo Activate, per poter completare le opzioni Client ID e Secret Key.

 

Non chiudere questa scheda, ti servirà per completare i dati del tuo account.

Guida per integrare con Magento 2 Ene 25 - 6-min.png

24. Accedi al tuo account Connectif e, nella sezione "Integrazioni > Magento" copia il ID Cliente e la Chiave Segreta.

Guida per integrare con Magento 2 Ene 25 - 12-min.png

25. Torna su Magento 2 e incollali nei campi corrispondenti.

Guida per integrare con Magento 2 Ene 25 - 7-min.png

26. Clicca su "Save Config" per salvare le modifiche.

 

 

Successo!
L'integrazione di Connectif con Magento è pronta.

  

Una volta completata la configurazione del plugin, è consigliabile verificare la corretta integrazione. Puoi vedere come farlo in questo articolo.

 


Domande frequenti

Hai dubbi sul modulo di Connectif in Magento? Qui troverai informazioni utili:

1. A cosa serve ciascuna sezione del modulo di Connectif in Magento?

Il modulo di Connectif in Magento è composto da diverse sezioni, ognuna delle quali svolge funzioni diverse:

  • Basic Configuration (1): questa sezione serve per configurare gli aspetti di base del tuo account Connectif in Magento, documentati in questo articolo, e per iniziare con la tua strategia. 

Guida per integrare con Magento 2 Ene 25 - 8-min.png

  • Banners (2): questa sezione è in disuso, poiché i contenuti in formato banner vengono configurati direttamente da Connectif.
  

I contenuti di tipo "Finestre modali" e "Banners" sono in disuso dal 2021. In questo articolo viene spiegato come migrarli a Connectif.

Guida per integrare con Magento 2 Ene 25 - 2-min.png

  • Customer (3): questa sezione permette di collegare i campi personalizzati del contatto in Connectif con quelli di Magento. Per farlo, seleziona uno dei campi contatto disponibili nel CMS (selettore sinistro, Customer Field) e associalo con l'ID del campo creato in Connectif (selettore destro, Connectif Field ID).

Guida per integrare con Magento 2 Ene 25 - 3-min.png

  • Product (4): questa sezione permette di collegare i campi personalizzati del prodotto in Connectif con i campi nativi in Magento. Per farlo, clicca sul selettore Select Attribute del campo che desideri associare (Custom Field 1, 2 o 3) e seleziona l'attributo del prodotto per quel campo.

Guida per integrare con Magento 2 Ene 25 - 4-min.png

  • Public Urls (5): questa sezione serve per consultare gli URL di attivazione del ServiceWorker e quelli di notifica dell'iscrizione.

Questi URL vengono generati e comunicati a Connectif quando il modulo viene installato in Magento. 

Guida per integrare con Magento 2 Ene 25 - 9-min.png

  • Advanced Configuration (5): questa sezione serve per impostare determinati comportamenti dell'integrazione con Connectif:
    • Print only mandatory fields on cart tags?: questa opzione consente di determinare se lo script di Connectif raccoglierà solo i campi obbligatori del carrello (ID del prodotto, nome, prezzo e URL). Questa opzione migliora le prestazioni del tag carrello in Magento.
    • Use product variants on cart and purchases?: questa opzione permette di determinare se, quando Connectif riceve le informazioni sui prodotti nel carrello, raccoglierà il prodotto predefinito o la variante specifica.
    • Product image ID: questa opzione permette di determinare la dimensione dell'immagine che Connectif raccoglierà. 
    • Notify purchases offline: questa opzione permette di determinare se l'eCommerce notificherà a Connectif gli acquisti offline via API e senza contesto web. 
    • Order Status: questa opzione permette di determinare lo stato in cui devono trovarsi gli acquisti affinché vengano registrati via API (notifiche offline) in Connectif. 
    • Create newsletter subscribers if customer does not exist?: questa opzione consente di scegliere se creare il contatto in Magento come iscritto alla newsletter se questo non esiste in Magento nel momento in cui viene notificata l'iscrizione o la cancellazione da Connectif.
    • Show product view with proper currency when Connectif verify the product: questa opzione influisce nel caso in cui la sincronizzazione dei prodotti venga eseguita tramite scraping web. Permette di specificare se, quando il sistema di Connectif visita il sito per sincronizzare/verificare un prodotto, lo visualizzi nella stessa valuta configurata in Connectif.

Guida per integrare con Magento 2 Ene 25 - 5-min.png

 

2. Come attivare la notifica degli acquisti offline (via API)?

  

Notificare gli acquisti offline significa che non hanno un contesto web, ma vengono notificati via API in modo asincrono. Se esiste una strategia che reagisce all'acquisto con un contenuto web, non avrà effetto sui contatti il cui acquisto è registrato tramite API. 

1. Nel tuo account Magento, vai su "Stores > Configuration", clicca su Connectif e poi su Settings.

Magento_Integracion_-_18.png

2. Disattiva il modulo di Connectif dalla sezione "Basic Configuration > Activate", selezionando l'opzione No.

Magento_Integracion_-_19.png

3. Clicca su Save Config.

 

È necessario salvare la configurazione subito dopo questo passaggio per poter attivare gli acquisti offline.

4. Vai alla sezione "Advanced Configuration > Notify purchases offline" e seleziona l'opzione Yes.

Magento_Integracion_-_20.png

5. Nella sezione "Order Status" scegli lo stato in cui devono trovarsi gli acquisti che verranno registrati in Connectif in modalità offline.

  

La selezione dello stato dipenderà dal metodo di pagamento, dalla configurazione di Magento e dal modello di business. È possibile selezionare solo uno stato.

Magento_Integracion_-_21.png

6. Riattiva il modulo di Connectif dalla sezione "Basic Configuration > Activate", selezionando l'opzione Yes.

Magento_Integracion_-_22.png

7. Clicca su Save Config.

 

3. Come configurare Connectif in un negozio multilingua di Magento?

Magento consente di creare tre livelli di entità per un account:

  • Website: solitamente ce n'è solo uno ed è associato al dominio.
  • Store: i diversi negozi, ad esempio, suddivisi per lingua.
  • Store view: altri dettagli per i negozi, ad esempio, nella stessa lingua ma con valuta differente.

Il modulo di Connectif può essere configurato a qualsiasi livello in base alle esigenze dell'eCommerce, ma è necessario tenere in considerazione alcuni aspetti:

  • I tipi di configurazione di Magento: se la configurazione viene effettuata in modalità "Default", si applicherà a tutti i livelli di Magento.
  • Per inviare i dati di diversi livelli di Magento allo stesso negozio Connectif, nella configurazione devono essere utilizzati lo stesso Client ID e la stessa Secret Key.
  • È consigliabile, salvo in casi molto complessi, attivare la configurazione predefinita al momento dell'integrazione, per configurare tutti i livelli allo stesso modo.

Se si hanno più lingue e/o più valute da configurare, è comune effettuare le impostazioni dell'articolo a livello di Store View separatamente.

Group 2-min.png

 

4. Come recuperare i carrelli abbandonati con l'URL di Recupero Carrello

(In questa sezione viene spiegato come funziona l'URL di Recupero Carrello per ottenere gli articoli associati a un carrello specifico).

Attraverso l'integrazione con Magento, viene inviato a Connectif un URL di Recupero Carrello, ovvero un link per recuperare gli articoli correlati a quel carrello e che può essere utilizzato nei workflow e nei contenuti.

Per ottenere l'URL di recupero carrello tramite un workflow, è necessario utilizzare il nodo "Ottenere ultimo carrello" e "Abbandono carrello", e successivamente mappare le variabili nel contenuto da mostrare o inviare.

  • Scopri come funziona questo URL nei diversi CMS e come utilizzarlo in questo articolo

5. Come raccogliere il marchio dei prodotti in Magento

Per raccogliere il campo "Marca" nella scheda prodotto di Connectif nell'integrazione con Magento, è necessario attivare il campo "Manufacturer" di Magento e assegnargli i valori corrispondenti, affinché venga trasmesso automaticamente.

Questo campo non è attivo per impostazione predefinita in Magento, quindi per attivarlo dovrai seguire questi passaggi:

1. Vai alla sezione "Stores > Attributes > Attribute Set".

Integración con Magento campo manufacturer - 1-min.png

2. Trova il gruppo di attributi "Default".

Integración con Magento campo manufacturer - 5-min.png

3. Fai doppio clic per accedere alla modifica e, una volta dentro, aggiungi il campo "manufacturer" alla cartella "Product Details", cliccando su di esso e trascinandolo all'interno della cartella.

Integración con Magento campo manufacturer - 2 (2)-min.png

4. Clicca su Salva per confermare questa configurazione. In questo modo, i dati del campo "manufacturer" verranno trasmessi sempre nei prodotti che utilizzano questo gruppo di attributi.

 

Affinché il marchio venga trasmesso automaticamente a Connectif tramite questo processo, è necessario che sia stato creato all'interno di questo campo. Se è stato inserito tramite un altro campo, sarà necessario adattarlo a questa procedura.

Integración con Magento campo manufacturer - 3-min.png

5. Se hai altri gruppi di attributi dei prodotti nel tuo catalogo dai quali desideri trasmettere il marchio, dovrai ripetere il processo.

Integración con Magento campo manufacturer - 4-min.png

6. Per assicurarti che il campo venga trasmesso nei diversi gruppi di prodotti, puoi controllare qualsiasi prodotto del tuo catalogo appartenente a uno di questi gruppi e verificare che il campo "manufacturer" sia presente nella sua scheda in Magento. All'interno della stessa, inoltre, potrai modificarlo se necessario tramite il menu a tendina.

Integración con Magento campo manufacturer - 6-min.png

 

 


Continua a imparare!

Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: