Guida all'integrazione con Magento 2

Se il tuo eCommerce è sviluppato in 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 di Connectif per Magento 2.

PASSAGGIO 1. Download e installazione del modulo Magento 2

A seconda della versione di Magento del 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 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 nella 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 Activate.

8. Segui i passaggi indicati dall'installazione del modulo Connectif e fai clic su Avanti:

• Readiness Check: in questo passaggio vengono eseguiti controlli relativi alla versione di PHP, ai cron, alle dipendenze e alle estensioni.

• Backup: in questo passaggio viene eseguito 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 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 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 la cartella con il comando seguente:

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 di 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 qualora non esista in Magento quando viene notificata l'iscrizione o la disiscrizione da Connectif.
  • Configure Customer Fields: questa opzione consente di collegare i campi di contatto disponibili nel CMS (selettore sinistro, Customer Field) e associarli all'ID del campo creato in Connectif (selettore destro, Connectif Field ID).

• Product (3): questa sezione serve a configurare gli aspetti di base dei 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 image 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 eseguita 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 e 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, debba raccogliere 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 di Connectif per migliorare i tempi di caricamento. Attivandola, viene attivata 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 alle newsletter.

• Banners (6): questa sezione non è più utilizzata, 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" scegli 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: di solito ce n'è uno solo e corrisponde al dominio.
• Store: i diversi negozi, 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é una configurazione in modalità "Default" verrà applicata a tutti i livelli di Magento.
• Per inviare allo stesso negozio Connectif i dati provenienti da diversi livelli Magento, nella configurazione dovranno essere utilizzati lo stesso Client ID e la stessa Secret Key.
• Si consiglia, tranne nei casi molto complessi, di attivare la configurazione predefinita al momento dell'integrazione, per configurare allo stesso modo tutti i livelli.

Se si desidera configurare più lingue e/o più valute, è 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

(Questa sezione spiega 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 il brand dei prodotti in Magento

Per raccogliere il campo "Brand" nella scheda prodotto di Connectif nell'integrazione con Magento, è necessario attivare il campo "Manufacturer" di Magento e assegnargli i valori corrispondenti, in modo che vengano trasferiti automaticamente.

Questo campo non è attivo per impostazione predefinita in Magento; per attivarlo, segui 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 sul campo 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 tuo catalogo sono presenti altri gruppi di attributi dei prodotti per i quali desideri trasmettere il brand, dovrai ripetere il processo.

6. Per assicurarti che il campo venga trasmesso nei diversi gruppi di prodotti, puoi controllare un prodotto del tuo catalogo appartenente a uno di essi e verificare che nella relativa scheda Magento sia incluso il campo "manufacturer". Inoltre, dalla stessa scheda potrai 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 Magento 2 utilizza Hyvä, assicurati di avere installato la versione 1.46.0 o successiva del modulo Connectif, che include la compatibilità con questo tema.

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.

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