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.

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.

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" e tutto il suo contenuto all'interno della cartella "/app/code/", situata nella directory principale 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 Activate.

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.

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

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

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.

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, 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

PASSO 2. Attivazione del modulo

22. Vai su "Stores > Configuration > " e individua 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. Accedi al tuo account Connectif e, nella sezione "Integrazioni > Magento" copia il ID Cliente e la Chiave Segreta.

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

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

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. 

• Banners (2): questa sezione è in disuso, poiché i contenuti in formato banner vengono configurati 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 associalo con 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 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.

• 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. 

• 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.

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

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

2. Disattiva il modulo di 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 verranno registrati in Connectif in modalità offline.

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

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.

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".

2. Trova il gruppo di attributi "Default".

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.

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.

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

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.

Continua a imparare!

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

• Onboarding, per acquisire familiarità con la nostra interfaccia.

• Workflow iniziali, per implementare le tue prime strategie nell'account.

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

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