Guida per integrare con PrestaShop

Se il tuo eCommerce è sviluppato in PrestaShop, potrai sincronizzarlo con il tuo account Connectif in pochi minuti e iniziare a raccogliere dati di interazione dei tuoi contatti sul sito web.

In questo articolo, imparerai come integrare il tuo account Connectif con il tuo PrestaShop.

 
Tempo di implementazione: 10 min.
Difficoltà: Bassa.
Quando usarlo?: All'apertura del tuo account Connectif.

 

PASSO 1. Download del modulo

1. Effettua il login nel tuo account Connectif.

2. Accedi a Impostazioni Negozio nel menu laterale sinistro.

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

Guía para integrar con Prestashop 2025 - 15-min.png

 

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

Integración con PrestaShop - 2-min.png

 

Non chiudere questa finestra! Ti servirà più avanti per estrarre i dati identificativi del tuo account.

 

PASSO 2. Installazione del modulo su PrestaShop

5. Effettua il login nel backoffice del tuo PrestaShop.

6. Accedi a “Moduli > Moduli e Servizi”.

7. In alto a destra, clicca su  Carica un modulo.

Guía para integrar con PrestaShop 2025 - 2-min.png

 

8. Nella finestra popup, clicca su Seleziona il file o trascinalo dentro il riquadro punteggiato. L'assistente inizierà automaticamente l'installazione.

Integraci_n_Prestasho_-_4__sin_figma_.png

 

9. Quando il modulo sarà installato, clicca su Configura.

Integraci_n_Prestasho_-_5__sin_figma_.png

 

È possibile accedere più tardi alla configurazione da “Moduli > Moduli e Servizi > Connectif” cliccando su Configura.

 

PASSO 3. Configurazione del modulo in PrestaShop

3.1. Configurazione base

(In questa sezione si inseriscono i dati identificativi del tuo account per sincronizzarlo e iniziare a raccogliere dati di interazione dei contatti in tempo reale sul web).

10. Torna al tuo Negozio Connectif (sezione “Integrazioni > PrestaShop”) e copia i dati identificativi del tuo account (Identificatore cliente e Chiave segreta).
 

Integración con PrestaShop - 3-min.png

 

11. Torna alla scheda di PrestaShop che hai lasciato aperta (configurazione del modulo) e incolla i dati copiati nei campi “Client ID” e “Secret KEY”, rispettivamente.

12. Verifica che nel campo “Enabled” sia selezionato YES.

13. Clicca su   Salva.

Guía para integrar con PrestaShop - 1.png

 

3.2. Banner

 I banner sono una funzione in disuso in Connectif. Puoi consultare maggiori informazioni a riguardo  qui.

14. Non è necessario effettuare alcuna azione in questa sezione.

Guía para integrar con PrestaShop - 2.png

 

3.3. URL pubbliche

(In questa sezione vengono compilate automaticamente le URL di iscrizione/cancellazione alla newsletter, così come quella del Service Worker per le notifiche push).

15. Non è necessario effettuare alcuna azione in questa sezione.
 
Puoi consultare queste URL nel tuo account Connectif:

— Iscrizioni/cancellazioni newsletter, nelle impostazioni dell'integrazione:

Integración con PrestaShop - 4-min.png

 

Service worker delle notifiche push, nelle Impostazioni Negozio, “Canali > Notifiche Push”.

Integración con PrestaShop - 5-min.png

 

3.4. Campi del modulo di registrazione

(In questa sezione si indicano le proprietà del contatto raccolte in PrestaShop che si vogliono sincronizzare con Connectif).

16. Nella sezione Campi del contatto, sono selezionati di default firstname (nome), “lastname” (cognome) e birthday (data di nascita). Se vuoi che Connectif sincronizzi anche altre opzioni di questa sezione o di Campi dell'indirizzo, seleziona “” nei campi desiderati.

 

Per registrare i dati selezionati nel profilo di ogni contatto, sarà necessario creare un campo personalizzato per ciascuno di essi, con l'ID uguale a quello indicato nella lista (ad esempio, id_gender). Questo passaggio deve essere eseguito per tutti i campi opzionali attivati, eccetto il campo “Newsletter” che cattura automaticamente le iscrizioni. Puoi consultare maggiori informazioni a riguardo qui.

Guía para integrar con PrestaShop - 3.png

 

3.5. Parametri avanzati

(In questa sezione si configurano opzioni avanzate dell'integrazione).

17. Per un'integrazione base, non è necessario effettuare azioni in questo passaggio. Se desideri una configurazione più avanzata, attiva/disattiva le opzioni che vuoi sincronizzare con Connectif:

Impostazioni generali

  • Attiva multi-lingua: raccogliere dati di interazione dei contatti distinguendo per lingua.

  • Includi categoria radice nella categoria della pagina: includere la categoria “Radice” nelle categorie del tag cn_page_category.

  • Verifica che l'hook top non venga renderizzato più di una volta: attivare/disattivare il calcolo della percentuale di sconto basato sui prezzi.

  • Abilita log di debug: attivare/disattivare i log.

  • Sincronizza le informazioni del contatto in Connectif all'aggiornamento cliente dal backoffice di PrestaShop: sincronizza nel contatto Connectif, oltre ai campi base e nativi del modulo, i campi attivati nel modulo nella scheda Campi del modulo di registrazione nella sezione Campi del contatto. Se l'opzione multi-lingua è attivata, la sincronizzazione avverrà in ogni negozio Connectif dove esiste l'email del contatto.

 

Questi cambiamenti non vengono inviati a Connectif se si effettua un'importazione clienti in PrestaShop né se si elimina un cliente da PrestaShop.

Guía para integrar con PrestaShop - 4.png

 

Eventi

  • Eventi di acquisto: registra tutti gli acquisti.

  • Eventi di registrazione: registra le attività di registrazione.

  • Eventi di login: registra gli accessi del contatto.

  • Eventi di iscrizione alla newsletter: registra le iscrizioni alla newsletter.

  • Stato del carrello: registra gli eventi dello stato del carrello.

  • Eventi di ricerca: registra gli eventi di ricerca nell'eCommerce.

Guía para integrar con PrestaShop - 6.png

 

Impostazioni prodotto

  • Usa descrizione lunga: raccogli la descrizione lunga dei prodotti.

  • Usa combinazioni di prodotto nel carrello e negli acquisti: determina se, ricevendo Connectif le informazioni dei prodotti nel carrello, raccoglierà il prodotto di default o la combinazione specifica (taglia, colore, ecc.).

  • Usa SKU come identificatore del prodotto: utilizza lo SKU dei tuoi prodotti PrestaShop come ID prodotto in Connectif.

  • Include la categoria radice senza necessità di selezionarla nella configurazione del prodotto: invia a Connectif la categoria radice tra le categorie del prodotto.

  • Includi la categoria solo se è attiva: invia a Connectif la categoria del prodotto solo se è attiva in PrestaShop.

  • Calcola la percentuale di sconto basata sui prezzi: attiva/disattiva il calcolo automatico della percentuale di sconto.

  • Includi tasse nello sconto: includi l'IVA nei prodotti scontati.

  • Arrotonda prezzi: arrotonda i prezzi dei prodotti in Connectif.

  • Disponibilità massima in giorni: imposta il periodo in giorni, antecedente alla data di riassortimento, in cui un prodotto sarà disponibile per l'acquisto anticipato.

  

Se i giorni rimanenti fino alla data di disponibilità di un prodotto sono superiori alla disponibilità massima in giorni, l'articolo sarà considerato esaurito e quindi Connectif non lo consiglierà nelle strategie attive.

  • Seleziona la dimensione dell'immagine prodotto: indica il tipo di immagine dei prodotti da sincronizzare (si consiglia di selezionare la stessa usata nella scheda prodotto di PrestaShop).

Guía para integrar con PrestaShop - 7.png

 

3.6. Invio degli acquisti

(In questa sezione si configura l'invio degli acquisti a Connectif dal modulo PrestaShop).

18. Attraverso la sezione Invio Acquisti è possibile inviare a Connectif gli acquisti effettuati nel tuo negozio, indicando un intervallo di date e gli stati da importare.

 

Per imparare come inviare gli acquisti da PrestaShop a Connectif, consulta questo articolo.

Guía para integrar con PrestaShop - 8.png

 

PASSO 4. Configurazione in negozi multilingua

 

Questo passaggio sarà necessario solo se il tuo PrestaShop ha più lingue e/o valute.

 

Gli eCommerce multilingua richiedono l'apertura di un account individuale per ogni lingua e valuta. Per maggiori informazioni, contatta accountmanager@connectif.es.

Per registrare i dati differenziati per lingua, nel punto precedente (17) deve essere stata attivata l'opzione “Attiva multi-lingua”.

19. Nella scheda Configurazione base, clicca su  .

Guía para integrar con PrestaShop - 9.png

 

20. In una nuova finestra del browser, accedi al tuo account Connectif della lingua corrispondente e copia i dati identificativi (“Identificatore cliente” e “Chiave segreta”), come indicato al punto 10.

21. Torna a PrestaShop e incolla i dati identificativi (“Client ID” e “Secret KEY”).

22. Seleziona la lingua e la valuta che desideri sincronizzare con quell'account Connectif.

23. Nel campo “Enabled”, clicca su YES.

24. Clicca su   Salva.

Guía para integrar con PrestaShop - 10.png

 

 

 Successo!
L'integrazione del tuo account Connectif con il tuo PrestaShop è pronta.

 

Per verificare che l'integrazione sia stata effettuata correttamente e che i dati di interazione vengano raccolti, clicca qui.

 


RISOLUZIONE DEI PROBLEMI

Trova soluzioni rapide ai problemi più comuni durante un'integrazione con PrestaShop.

 

1. Quali informazioni raccoglie Connectif tramite questa integrazione

a. Informazioni raccolte dai Contatti

Nelle integrazioni con PrestaShop, tramite il tag cn_client_info, viene trasferita di default una certa informazione sui Contatti:

  • email
  • _name
  • _surname
  • _birthdate
  • _newsletter_subscription_status

Inoltre, nelle impostazioni del modulo Connectif in PrestaShop esiste una sezione che permette di abilitare altri campi contatto. Questi campi saranno aggiunti al tag cn_client_info con lo stesso identificatore indicato in quella sezione. Perché Connectif salvi il valore, deve esistere nel Negozio Connectif un campo personalizzato con lo stesso ID (vedi passo 3.5).

b. Informazioni raccolte sui Prodotti

Nelle integrazioni con PrestaShop, tramite il tag cn_product_visited e la sincronizzazione giornaliera del catalogo, viene raccolta di default una certa informazione sui Prodotti:

  • quantity
  • price url
  • product_id
  • name
  • description
  • image_url
  • unit_price
  • availability
  • brand
  • published_at
  • category
  • related_external_product_id
  • tag

c. Informazioni raccolte sugli Acquisti

Nelle integrazioni con PrestaShop, tramite il tag cn_purchase, viene raccolta di default una certa informazione sugli Acquisti:

  • purchase_id
  • purchase_date
  • payment_method
  • cart_id
  • total_quantity
  • total_price

 

2. Non vengono registrati dati di acquisti, contatti e/o eventi carrello

  • In Parametri avanzati, verifica che siano attivate le seguenti opzioni:

    • Eventi di acquisto”, per registrare dati di acquisti.

    • Eventi di registrazione”, per raccogliere dati dei contatti.

    • Eventi del carrello”, per catturare stati del carrello.

Se disattivate, clicca su Yes nei campi necessari e poi su Salva per abilitarle.

Guía para integrar con Prestashop 2025 - 11-min.png

 

  • Verifica che il modulo Connectif sia ancorato all'hook displayTop in “Design > Posizioni” di PrestaShop.

Integraci_n_PrestaShop_-_16.png

 

  • Assicurati che il tuo tema non modifichi le pagine base di PrestaShop (come, ad esempio, il Checkout) e che esegua l'hook displayTop nel modo seguente:

    {hook h='displayTop'}
  

Puoi consultare le informazioni ufficiali di PrestaShop cliccando qui.

  • Configura la tua piattaforma di pagamento affinché, dopo una transazione, il contatto venga reindirizzato automaticamente alla pagina di Conferma acquisto dell'eCommerce.

 

Se non è possibile eseguire l'hook displayTop per incompatibilità con altri moduli, si consiglia di eseguire l'hook displayConnectifTags in tutte le pagine e assicurarsi che il modulo sia ancorato correttamente a tale hook.

 

3. Non vengono sincronizzati gli stati di iscrizione alla newsletter

  • Verifica che le URL autocompilate nell'integrazione PrestaShop del tuo account Connectif corrispondano alle URL del modulo installato nel tuo PrestaShop in “Configurazione > URL pubbliche
    Integración con PrestaShop - 4-min.png


    Guía para integrar con PrestaShop - 11.png
     

  • Controlla che le URL esistano copiandole e incollandole nella barra degli indirizzi del browser. Se restituiscono errore 404, dovranno essere corrette direttamente nell'eCommerce.

 

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

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

Attraverso l'integrazione con PrestaShop, viene inviato a Connectif un URL di Recupero Carrello, cioè un link per recuperare gli articoli collegati a quel carrello, utilizzabile in workflow e contenuti.

Per ottenere l'URL di recupero carrello tramite un workflow, deve essere fatto tramite i nodi "Ottieni ultimo carrello" e "All'abbandono carrello", successivamente mappati nelle variabili del contenuto da mostrare o inviare.

 

 

 


Continua ad imparare!

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