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 multilingua: raccogliere dati di interazione dei contatti distinguendo per lingua.
  • Includere la categoria radice nella categoria della pagina: includere la categoria “Radice” nelle categorie del tag cn_page_category.
  • Verificare che l’hook top non venga renderizzato più di una volta: abilitare/disabilitare il calcolo della percentuale di sconto basato sui prezzi.
  • Abilitare i log di debug: abilitare/disabilitare 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 di base e nativi del modulo, i campi attivati nel modulo nella scheda «Campi del modulo di registrazione» della sezione «Campi del contatto». Se l’opzione multilingua è attivata, la sincronizzazione avverrà in ogni negozio Connectif in cui esiste l’email del contatto.

 

Queste modifiche non vengono inviate a Connectif se viene effettuata un’importazione di clienti in PrestaShop o se un cliente viene eliminato 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

  • Usare descrizione lunga: raccogliere la descrizione lunga dei prodotti.
  • Usare combinazioni di prodotto in carrello e acquisti: determinare se, quando Connectif riceve le informazioni del carrello, raccoglierà il prodotto predefinito o la combinazione specifica (taglia, colore, ecc.).
  • Usare SKU come identificatore del prodotto: utilizzare lo SKU dei tuoi prodotti PrestaShop come ID prodotto in Connectif.
  • Includere la categoria radice senza doverla selezionare nelle impostazioni del prodotto: inviare a Connectif la categoria radice all’interno delle categorie del prodotto.

  • Includere la categoria solo se attiva: inviare a Connectif la categoria del prodotto solo se è attiva in PrestaShop.
  • Calcolare la percentuale di sconto basata sui prezzi: abilitare/disabilitare il calcolo automatico.
  • Includere imposta nello sconto: includere l’IVA nei prodotti scontati.
  • Arrotondare i prezzi: arrotondare i prezzi dei prodotti in Connectif.
  • Disponibilità massima in giorni: impostare il periodo in giorni, prima della data di riassortimento, in cui un prodotto sarà disponibile per l’acquisto anticipato.
  

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

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

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

 

3.7. Invio degli acquisti

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

23. Tramite la sezione Invio degli acquisti, puoi inviare gli acquisti effettuati nel tuo negozio a Connectif, specificando un intervallo di date e gli stati da importare.

 

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

Invio degli acquisti da PrestaShop - 3.png

 

PASSO 4. Configurazione nei negozi con più lingue

 

Devi eseguire questo passo solo se il tuo PrestaShop ha più lingue e/o valute.

 

Gli e-commerce con multi-lingua richiedono un account individuale per ogni lingua e valuta. Per ulteriori informazioni, contatta accountmanager@connectif.es.

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

24. Nella scheda Configurazione di base, clicca su  .

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

25. In una nuova finestra del browser, accedi al tuo account Connectif per la lingua corrispondente e copia i dati identificativi (“Identificatore Cliente” e “Chiave Segreta”), come indicato al punto 10.

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

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

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

29. Clicca su   Salva.

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

 

 

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

 

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

 


Risoluzione dei problemi

Trova soluzioni rapide ai problemi più comuni durante l'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, vengono trasferite, per impostazione predefinita, alcune informazioni sui Contatti:

  • email

  • _name

  • _surname

  • _birthdate

  • _newsletter_subscription_status

Inoltre, nelle impostazioni del modulo Connectif in PrestaShop, c'è una sezione che consente di abilitare altri campi di contatto. Questi campi saranno aggiunti al tag cn_client_info con lo stesso identificatore presente in questa sezione. Affinché Connectif memorizzi il valore, deve esserci un campo personalizzato nel negozio Connectif con lo stesso ID (vedi passaggio 3.5).

b. Informazioni raccolte dai Prodotti

Nelle integrazioni con PrestaShop, tramite il tag cn_product_visited e la sincronizzazione quotidiana del catalogo, vengono raccolte, per impostazione predefinita, alcune informazioni 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 dagli Acquisti

Nelle integrazioni con PrestaShop, tramite il tag cn_purchase, vengono raccolte, per impostazione predefinita, alcune informazioni sugli Acquisti:

  • purchase_id

  • purchase_date

  • payment_method

  • cart_id

  • total_quantity

  • total_price

 

2. Nessun dato sugli acquisti, contatti e/o eventi del carrello viene registrato

  • In Parametri avanzati, verifica che le seguenti opzioni siano attivate:
      • 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 disabilitati, fai clic su Yes nei campi che desideri e su Salva per abilitarli.

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

  • Verifica che il modulo Connectif sia agganciato al hook displayTop in “Design > Positions” di PrestaShop.

Integrazione PrestaShop - 16.png

  • Assicurati che il tuo template non modifichi le pagine base di PrestaShop (come, ad esempio, il Checkout) ed esegua il hook displayTop nel seguente modo:
    {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 automaticamente reindirizzato alla pagina di Conferma acquisto dell'eCommerce.
 

In caso di impossibilità ad eseguire il hook displayTop a causa di incompatibilità con altri moduli, si consiglia di eseguire il hook displayConnectifTags su tutte le pagine e assicurarsi che il modulo sia correttamente agganciato a questo hook.

 

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

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

Grazie all'integrazione con PrestaShop, viene inviata a Connectif una URL di Recupero Carrello, cioè un link per recuperare gli articoli legati a quel carrello, che può essere utilizzato nei workflow e nei contenuti.

Per ottenere l'URL di recupero carrello tramite un workflow, deve essere fatto tramite il nodo "Ottenere ultimo carrello" e "Abbandono carrello", e successivamente mappato nelle variabili del contenuto da mostrare o inviare.

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

 

 

 


Continua a imparare!

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