Guida per integrare 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.

PASSO 1. Download e installazione del modulo Magento 2

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

• Se hai una versione precedente a Magento 2.2, consulta la sezione A di questo passo.
• Se hai una versione successiva a Magento 2.2, consulta la sezione B di questo passo.
• Se hai Magento + Hyvä, consulta la sezione corrispondente alla tua versione e il punto 6 delle domande frequenti.

A. Versioni precedenti a Magento 2.2

A.1. Download del modulo

1. Accedi al tuo account Connectif.

2. Vai su Impostazioni Negozio nel menu laterale sinistro.

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

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

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

5. Copia la cartella "Connectif" con tutto il suo contenuto dentro la cartella "/app/code/", situata nella radice dell’installazione di Magento 2.

A.3. Installazione del modulo

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

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

8. Segui i passaggi indicati dall’installazione del modulo Connectif e clicca su Avanti:

• Readiness Check: in questo passaggio vengono effettuati controlli relativi alla versione di PHP, crons, dipendenze ed estensioni.

• Backup: in questo passaggio viene effettuato un backup dell’eCommerce prima dell’installazione del modulo. 

• Enable module: in questo passaggio viene attivato il modulo. 

B. Versioni successive a Magento 2.2

B.1. Download del modulo

1. Accedi al tuo account Connectif.

2. Vai su Impostazioni Negozio nel menu laterale sinistro.

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

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

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, usando la linea di comando (shell), vai nella directory radice di Magento dove è installato Magento 2.

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

16. Estrai il file in una directory temporanea.

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

mkdir –p app/code/Connectif/

18. Copia il contenuto della cartella estratta nella cartella creata nel passo precedente:

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

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

php bin/magento setup:upgrade

20. Compila il modulo installato con:

php bin/magento setup:upgrade

21. Pulisci la cache con:

php bin/magento cache:flus

PASSO 2. Attivazione del modulo

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

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

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

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

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

Domande frequenti

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

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

Il modulo Connectif in Magento è composto da diverse sezioni, ognuna con funzioni differenti:

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

• Banners (2): questa sezione è obsoleta, poiché i contenuti in formato banner si configurano direttamente da Connectif.

• 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 associa l’ID del campo creato in Connectif (selettore destro, Connectif Field ID).

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

• Public Urls (5): questa sezione serve per consultare le URL di attivazione del ServiceWorker e quelle di notifica iscrizione alle notifiche.

Queste URL vengono generate e comunicate a Connectif quando il modulo viene installato in Magento. 

• Advanced Configuration (5): questa sezione serve per stabilire determinati comportamenti dell’integrazione con Connectif:
  • Print only mandatory fields on cart tags?: questa opzione permette di determinare se lo script di Connectif raccoglierà solo i campi obbligatori del carrello (Id 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 dei prodotti nel carrello, raccoglierà il prodotto di default o la variante specifica.
  • Product imagen 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 per essere registrati via API (notifiche offline) in Connectif. 
  • Create newsletter subscribers if customer does not exist?: questa opzione permette di scegliere se creare il contatto in Magento come Iscritto alla newsletter se questo non esiste in Magento quando si notifica 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 fatta tramite scraping web. Permette di indicare se, quando il meccanismo di Connectif visita il sito per sincronizzare/verificare un prodotto, lo faccia con la stessa valuta configurata in Connectif.

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

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

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

3. Clicca su Save Config.

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

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

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

7. Clicca su Save Config.

3. Come configurare Connectif in un negozio Magento multilingua?

Magento permette di creare tre livelli di entità in un account:

• Website: solitamente ce n’è uno solo e corrisponde al dominio.
• Store: i diversi negozi, per esempio, per lingua.
• Store view: altri dettagli per i negozi, per esempio, stessa lingua ma valuta diversa.

Il modulo Connectif può essere configurato a uno qualsiasi di questi livelli secondo le esigenze dell’eCommerce, ma bisogna considerare alcuni aspetti:

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

Se si hanno più lingue e/o valute da configurare, è comune fare gli aggiustamenti indicati nell’articolo a livello di Store View separatamente.

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

(In questa sezione si spiega come funziona la URL di Recupero Carrello per ottenere gli articoli associati a un carrello specifico).

Attraverso l’integrazione con Magento, viene inviata a Connectif una URL di Recupero Carrello, cioè un link per recuperare gli articoli legati a quel carrello che può essere usato in workflow e contenuti.

Per ottenere la URL di recupero carrello tramite un workflow, deve essere fatto attraverso il nodo "Ottieni ultimo carrello" e "Al abbandono carrello", poi mappato nelle variabili del contenuto da mostrare o inviare.

• Scopri come funziona questa URL nei diversi CMS e come usarla in questo articolo. 

5. Come raccogliere la marca 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, così che venga trasmesso automaticamente.

Questo campo non è attivo di default in Magento, quindi per attivarlo devi seguire questi passi:

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

2. Trova il gruppo di attributi "Default".

3. Fai doppio clic per entrare nella modifica e, una volta dentro, aggiungi il campo "manufacturer" alla cartella "Product Details", cliccando su di esso e trascinandolo dentro la cartella.

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

5. Se hai altri gruppi di attributi prodotti nel tuo catalogo da cui vuoi trasmettere la marca, dovrai ripetere il processo.

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

6. Cosa devo considerare se il mio negozio Magento 2 usa Hyvä?

Se il tuo negozio usa Magento 2 con Hyvä, devi verificare che il template usi il sistema standard di inizializzazione JavaScript di Magento *-init per lanciare correttamente gli script di Connectif.

Questa configurazione è necessaria perché Hyvä modifica il sistema frontend di Magento e può cambiare il modo in cui si inizializzano alcuni script. Il modulo Connectif si basa sul meccanismo standard di Magento per eseguire gli script di tracking e identificazione del contatto.

Per completare l’integrazione, verifica con il tuo team di sviluppo che gli script Connectif si inizializzino tramite *-init, usando data-mage-init o text/x-magento-init, a seconda del caso.

Una volta applicata questa configurazione, controlla che l’integrazione raccolga correttamente gli eventi principali del negozio. Puoi vedere come farlo in questo articolo.

Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli:

• Onboarding, per acquisire dimestichezza con la nostra interfaccia.

• Workflows iniziali, per implementare le tue prime strategie nell’account.

• Integrazioni con sistemi esterni, per integrarti con Facebook, form e webhook del tuo sito.

• Integrazioni via API, per gestire eventi come registrazioni acquisti o iscrizioni contatti.