Guida all'integrazione con Magento 2

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

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

PASSAGGIO 1. Download e installazione del modulo Magento 2

A seconda della versione di Magento utilizzata dal 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.
• 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. Accedi a Impostazioni del negozio nel menu laterale sinistro.

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

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

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

5. Copia la cartella "Connectif" e tutto il suo contenuto nella 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 dall'installazione del modulo Connectif e fai clic su Avanti:

• Readiness Check: in questo passaggio vengono effettuati controlli relativi alla versione di PHP, ai cron, alle dipendenze e alle 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. Accedi a Impostazioni del negozio nel menu laterale sinistro.

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

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

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

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

14. Dopo aver effettuato correttamente l'accesso SSH, utilizzando la riga di comando (shell), vai alla directory principale di Magento in cui è installato Magento 2.

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

16. Decomprimi il file in una directory temporanea.

17. Il modulo decompresso deve essere copiato nel percorso “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 directory principale: 

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:flus

PASSAGGIO 2. Attivazione del modulo

22. Vai a "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. Vai al tuo account Connectif e, nella sezione "Integrazioni > Magento" , copia l'ID cliente e la Chiave segreta.

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

26. Fai clic 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 delle quali svolge funzioni differenti:

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

• Customer (2): questa sezione consente di configurare le informazioni dei contatti Magento che verranno inviate a Connectif.
  • Create newsletter subscribers if customer does not exist?: questa opzione consente di selezionare se creare il contatto in Magento come iscritto alla newsletter nel caso in cui non esista in Magento quando Connectif notifica l'iscrizione o la cancellazione.
  • Configure Customer Fields: questa opzione consente di collegare i campi di contatto disponibili nel CMS (selettore sinistro, Customer Field) all'ID del campo creato in Connectif (selettore destro, Connectif Field ID).

• Product (3): questa sezione serve a configurare gli aspetti di base dei tuoi prodotti Magento da sincronizzare con Connectif:
  • Use product SKU identifier?: questa opzione consente di utilizzare lo SKU come identificatore dei prodotti nel catalogo Connectif.
  • Product imagen ID: questa opzione consente di determinare la dimensione dell'immagine che Connectif raccoglierà. 
  • Use full category path: questa opzione consente di inviare il percorso completo delle categorie del prodotto, comprese le categorie superiori, anche se non sono assegnate direttamente al prodotto.
  • Show product view with proper currency when Connectif verify the product: questa opzione influisce nel caso in cui la sincronizzazione dei prodotti venga effettuata tramite Scrapping web. Consente di indicare se, quando il meccanismo di Connectif visita il sito per sincronizzare/verificare un prodotto, debba farlo utilizzando la stessa valuta configurata in Connectif.
  • Custom Field 1, Custom Field 2 y Custom Field 3: queste opzioni consentono di configurare i campi personalizzati delle varianti di prodotto che verranno inviate a Connectif.

• Cart and order (4): questa sezione consente di configurare le informazioni sui carrelli e sugli acquisti che invierai a Connectif:
  • Print only mandatory fields on cart tags?: questa opzione consente di determinare se lo script di Connectif raccoglierà esclusivamente i campi obbligatori del carrello (ID del prodotto, nome, prezzo e URL). Questa opzione consente di migliorare le prestazioni del tag del carrello in Magento.
  • Use product variants on cart and orders?: questa opzione consente di determinare se, quando Connectif riceve le informazioni sui prodotti del carrello, raccoglierà il prodotto predefinito o la variante specifica.
  • Notify orders offline: questa opzione consente di determinare se l'eCommerce notificherà a Connectif gli acquisti offline tramite API e senza contesto web.
  • Order Status: questa opzione consente di determinare lo stato che devono avere gli acquisti per essere registrati tramite API (notifiche offline) in Connectif. 

• Advanced Configuration (5): questa sezione serve a stabilire determinati comportamenti dell'integrazione con Connectif:
  • Use optimized Connectif tags: questa opzione consente di ottimizzare la generazione dei tag Connectif per migliorare i tempi di caricamento. Quando viene attivata, si attiva automaticamente anche la sincronizzazione in tempo reale dei dati di contatto.
  • Real-time customer data sync: questa opzione consente di sincronizzare in tempo reale con Connectif le modifiche apportate ai dati dei contatti, come informazioni, indirizzi e iscrizioni alla newsletter.

• Banners (6): questa sezione non è più in uso, poiché i contenuti in formato banner vengono configurati direttamente da Connectif.

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

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

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

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

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

3. Fai clic su Save Config.

4. Vai alla sezione "Cart and Order > Notify purchases offline" e seleziona l'opzione Yes.

5. Nella sezione "Order Status" seleziona lo stato che devono avere gli acquisti da registrare offline in Connectif.

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

7. Fai clic su Save Config.

3. Come configurare Connectif in un negozio Magento multilingua?

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

• Website: solitamente ce n'è uno solo e corrisponde al dominio.
• Store: il/i negozio/i diversi, ad esempio per lingua.
• Store view: altri dettagli dei negozi, ad esempio la stessa lingua ma una valuta diversa.

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

• I tipi di configurazione di Magento, poiché se una configurazione viene effettuata in modalità "Default", verrà applicata a tutti i livelli di Magento.
• Per inviare allo stesso negozio Connectif i dati di livelli Magento diversi, nella configurazione dovranno essere utilizzati lo stesso Client ID e la stessa Secret Key.
• È consigliabile, salvo nei casi più 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, è consuetudine effettuare separatamente le impostazioni dell'articolo a livello di Store View .

4. Come recuperare i carrelli abbandonati con l'URL di recupero del carrello

(In questa sezione viene spiegato come funziona l'URL di recupero del carrello per ottenere gli articoli associati a un determinato carrello).

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

Per ottenere l'URL di recupero del carrello tramite un workflow, è necessario utilizzare il nodo "Ottieni ultimo carrello" e "Quando il carrello viene abbandonato", quindi mapparlo nelle variabili del contenuto da mostrare o inviare.

• Scopri come funziona questo URL nei diversi CMS e come utilizzarlo 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 inserire i valori corrispondenti, affinché vengano trasmessi 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. Individua il gruppo di attributi "Default".

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

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

5. Se nel catalogo hai altri gruppi di attributi dei prodotti dai quali vuoi trasmettere la marca, dovrai ripetere il processo.

6. Per assicurarti che il campo venga trasmesso nei diversi gruppi di prodotti, puoi controllare un prodotto qualsiasi del catalogo appartenente a uno di essi e verificare che nella scheda Magento sia incluso il campo "manufacturer". Nella stessa scheda potrai anche modificarlo, se necessario, tramite il menu a discesa.

6. Cosa devo tenere presente se il mio negozio Magento 2 utilizza Hyvä?

Se il tuo negozio utilizza Magento 2 con Hyvä, dovrai verificare che il tema utilizzi il sistema standard di inizializzazione JavaScript di Magento *-init per avviare correttamente gli script di Connectif.

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

Per completare l'integrazione, verifica con il tuo team di sviluppo che gli script di Connectif vengano inizializzati tramite *-init, utilizzando data-mage-init o text/x-magento-init, a seconda dei casi.

Una volta applicata questa configurazione, verifica che l'integrazione raccolga correttamente i principali eventi del negozio. Puoi vedere come farlo in questo articolo.

Continua a imparare!

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

• Onboarding, per acquisire dimestichezza 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.

• Integrazioni tramite API, per gestire eventi come la registrazione degli acquisti o l'iscrizione dei contatti.