Guida per integrare con PrestaShop

Se il tuo eCommerce è sviluppato su 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 PrestaShop.

 
Tempo di implementazione: 10 min.
Difficoltà: Bassa.
Quando utilizzarlo?: Quando apri il tuo account su Connectif.

 

PASSO 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 PrestaShop e fai clic su  Modifica.

Guida per integrare con Prestashop 2025 - 15-min.png

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

Integrazione 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. Accedi al backoffice di PrestaShop.

6. Vai su “Moduli > Moduli e Servizi”.

7. In alto a destra, fai clic su  Carica un modulo.

Guida per integrare con PrestaShop 2025 - 2-min.png

8. Nella finestra pop-up, fai clic su Seleziona il file o trascinalo all'interno del riquadro tratteggiato. L'assistente avvierà automaticamente l'installazione.

Integrazione_Prestashop_-_4__senza_figma_.png

9. Quando il modulo sarà installato, fai clic su Configura.

Integrazione_Prestashop_-_5__senza_figma_.png

 

È anche possibile accedere alla configurazione in un secondo momento da “Moduli > Moduli e Servizi > Connectif” facendo clic su Configura.

 

PASSO 3. Configurazione del modulo su PrestaShop

3.1. Collegamento dell'account PrestaShop con il modulo Connectif

(In questa sezione viene spiegato come collegare l'account PrestaShop con il modulo Connectif, un passaggio necessario per completare l'integrazione).

10. Nella sezione Configurazione di base fai clic su Gestisci negozi collegati.

Guida per integrare con Prestashop 2025 - 13-min.png

11. Nella finestra pop-up, accedi al tuo account PrestaShop.

12. Accetta i permessi per collegare il tuo account PrestaShop con Connectif.

13. Una volta collegati gli account, verrà visualizzato un messaggio di conferma nella schermata di configurazione del modulo.

Guida per integrare con Prestashop 2025 - 14-min.png

 

3.2. Configurazione di base

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

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

Integrazione con PrestaShop - 3-min.png

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

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

17. (Opzionale). Se hai un codice di riferimento, dovrai inserirlo in questa schermata, nell'area Codice di riferimento.

18. Fai clic su   Salva.

Guida per integrare con Prestashop 2025 - 3-min.png

 

3.3. Banners

 I banner sono una funzione obsoleta in Connectif. Puoi trovare maggiori informazioni al riguardo  qui.

19. Non è necessario eseguire alcuna azione in questa sezione.

Guida per integrare con Prestashop 2025 - 4-min.png

 

3.4. URL pubbliche

(In questa sezione vengono compilati automaticamente gli URL per l'iscrizione/cancellazione dalla newsletter, nonché per il Service Worker delle notifiche push).

 20. Non è necessario eseguire alcuna azione in questa sezione.
 
Puoi consultare questi URL nel tuo account Connectif:

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

Integrazione con PrestaShop - 4-min.png

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

Integrazione con PrestaShop - 5-min.png

 

3.5 Campi del formulario di registrazione

(In questa sezione vengono indicati le proprietà del contatto raccolte in PrestaShop che si desidera sincronizzare con Connectif).

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

 

Per registrare i dati selezionati nel profilo di ciascun contatto, sarà necessario creare un campo personalizzato con ciascuno di essi, utilizzando lo stesso ID indicato nell'elenco (ad esempio, id_gender). Questo passaggio deve essere eseguito per tutti i campi opzionali attivati, ad eccezione del campo “Newsletter” che raccoglie automaticamente le iscrizioni. Puoi trovare maggiori informazioni al riguardo qui.

Guida per integrare con Prestashop 2025 - 5-min.png

 

3.6. Parametri avanzati

(In questa sezione vengono configurate opzioni avanzate dell'integrazione).

22. Per un'integrazione di base, non è necessario eseguire alcuna azione in questa fase. Se desideri una configurazione più avanzata, attiva/disattiva le opzioni che desideri sincronizzare con Connectif:

Impostazioni generali

  • Attivare multi-lingua: raccogliere dati di interazione dei contatti distinguendoli per lingua.
  • Includere la categoria radice nella categoria della pagina: indicare che la categoria “Root” appaia nelle categorie di prodotto.
  • Verificare che l'hook top non venga renderizzato più di una volta: attivare/disattivare il calcolo della percentuale di sconto basato sui prezzi.
  • Abilitare log di debug: attivare/disattivare i log.
  • Sincronizzare le informazioni del contatto in Connectif quando si aggiorna il cliente dal backoffice di PrestaShop: sincronizzare nel contatto di Connectif, oltre ai campi base e nativi del modulo, anche i campi attivati nel modulo nella scheda Campi del formulario di registrazione nella sezione Campi del contatto. Se l'opzione multi-lingua è attivata, la sincronizzazione avverrà in ogni negozio Connectif in cui esiste l'email del contatto.

 

Queste modifiche non vengono inviate a Connectif se si effettua un'importazione di clienti in PrestaShop né se si elimina un cliente da PrestaShop.

Guida per integrare con Prestashop 2025 - 6-min.png

Eventi

  • Eventi di acquisto: registrare tutti gli acquisti.

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

  • Eventi di login: registrare gli accessi del contatto.

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

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

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

Guida per integrare con Prestashop 2025 - 7-min.png

Impostazioni prodotto

  • Utilizzare la descrizione lunga: raccogliere la descrizione lunga dei prodotti.
  • Utilizzare combinazioni di prodotto nel carrello e negli acquisti: determinare se, quando Connectif riceve le informazioni sui prodotti nel carrello, raccoglierà il prodotto predefinito o la combinazione specifica (taglia, colore, ecc.).
  • Utilizzare SKU come identificatore del prodotto: utilizzare l'SKU dei tuoi prodotti in PrestaShop come ID dei prodotti in Connectif.
  • Calcolare la percentuale di sconto basata sui prezzi: attivare/disattivare il calcolo automatico degli sconti.
  • Includere IVA nello sconto: includere l'IVA nei prodotti scontati.
  • Arrotondare i prezzi: arrotondare i prezzi dei prodotti in Connectif.
  • Massima disponibilità in giorni: imposta il periodo in giorni, precedente alla data di riassortimento, durante il quale un prodotto sarà disponibile per l'acquisto anticipato.
  

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

  • Selezionare la dimensione dell'immagine del prodotto: indicare il tipo di immagine dei prodotti da sincronizzare (si consiglia di selezionare la stessa utilizzata nella scheda prodotto di PrestaShop).

Guida per integrare con Prestashop 2025 - 8-min.png

 

PASSO 4. Configurazione nei negozi con più lingue

 

Questo passaggio è necessario solo se il tuo PrestaShop è configurato con più lingue e/o valute.

 

Gli eCommerce con multi-lingua 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 passaggio precedente (17) deve essere stata attivata l'opzione “Attivare multi-lingua”.

23. Nella scheda Configurazione di base, fai clic su  .

Guida per integrare con Prestashop 2025 - 9-min.png

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

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

26. Seleziona la lingua e la valuta che desideri sincronizzare con questo account Connectif.

27. Nel campo “Enabled”, fai clic su YES.

28. Fai clic su   Salva.

Guida per integrare con Prestashop 2025 - 10-min.png

 

 

 Successo!
L'integrazione del tuo account in Connectif con PrestaShop è ora completata.

 

Per verificare che l'integrazione sia stata completata correttamente e che i dati di interazione vengano già raccolti, fai clic qui.

 


RISOLUZIONE DEI PROBLEMI

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

1. Non vengono registrati dati sugli acquisti, sui contatti e/o sugli eventi del carrello

  • In Parametri avanzati, verifica che siano attivate le seguenti opzioni:
      • Eventi di acquisto”, per registrare i dati degli acquisti.
      • Eventi di registrazione”, per raccogliere i dati dei contatti.
      • Eventi del carrello”, per catturare gli stati del carrello.

Se sono disattivati, fai clic su Yes nei campi necessari e su Salva per abilitarli.

Guida per integrare con Prestashop 2025 - 11-min.png

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

Integrazione_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 seguente modo:
    {hook h='displayTop'}
  

Puoi consultare la documentazione ufficiale di PrestaShop facendo clic qui.

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

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

 

2. Gli stati di iscrizione alla newsletter non si sincronizzano

  • Verifica che gli URL autocompletati nell'integrazione con PrestaShop del tuo account Connectif coincidano con gli URL del modulo installato su PrestaShop in “Configurazione > URL pubblici
    Integrazione con PrestaShop - 4-min.png


    Guida per integrare con Prestashop 2025 - 12-min.png

  • Controlla che gli URL esistano copiandoli e incollandoli nella barra degli indirizzi del browser. Se restituisce un errore 404, dovrà essere corretto direttamente nell'eCommerce.

 

3. 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 PrestaShop, viene inviato a Connectif un URL di Recupero 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 carrello tramite un workflow, è necessario utilizzare il nodo "Ottenere l'ultimo carrello" e "Abbandono del carrello", quindi mappare le variabili nel contenuto da mostrare o inviare.

  • Scopri come funziona questo URL nei diversi CMS e come utilizzarlo in questo articolo

 

 

 


Continua a imparare!

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

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 1 su 1