# Installare il modulo PrestaShop

> Installare e configurare il modulo DataFirefly Server-Side su PrestaShop 1.7.6 e successivi: caricamento dello zip, chiave di connessione, consenso tarteaucitron.

- Pagina originale: https://server-side.datafirefly.com/it/docs/prestashop.html
- Lingua: it
- Aggiornato il: 2026-09-05
- Editore: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/it/

---

Compatibile con PrestaShop 1.7.6 e versioni successive. Installazione in 5 minuti dal gestore dei moduli. Una consegna fallita viene messa in coda e ritrasmessa, a partire dagli acquisti: un'interruzione passeggera non costa nulla.

## Prerequisiti

- PrestaShop 1.7.6 o più recente.
- Lo zip del modulo, da scaricare dalla pagina [**Modules**](https://admin.datafirefly.com/app/connectors) della tua area clienti.
- La [chiave di connessione del tuo sito](https://server-side.datafirefly.com/it/docs/connect-your-site.html).

## Installazione

1. Back office PrestaShop: **Moduli > Gestione moduli > Carica un modulo**.
2. Carica lo zip così com’è, senza decomprimerlo.
3. Clicca **Configura**.

## Configurazione

1. Compila **Tenant ID**, **HMAC secret** ed **Events endpoint**: i tre valori della pagina del tuo sito DataFirefly.
2. Opzione **Require consent**: il modulo lascia partire un evento solo quando il visitatore ha accettato la pubblicità. Riconosce da solo, senza configurazione: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, nel browser e sul server, la stessa lista dei moduli WooCommerce e Shopware. Consigliato se il suo negozio ha un banner di consenso.
3. Imposta **Enable tracking** su Yes: è disattivato di default.
4. Salva, poi clicca **Send test event**.

Non hai ancora un banner di consenso sul tuo negozio? Il modulo [Cookie Manager per PrestaShop](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) installa tarteaucitron pronto all’uso, con Consent Mode v2.

## Verificare

1. L’evento di test deve comparire come **Delivered** nel Monitoring della tua area clienti.
2. Effettua un ordine di prova: il modulo invia gli acquisti alla convalida dell’ordine.

## Coda di reinvio

Vale dalla versione 1.29.0 in poi.

- Un invio non riuscito viene messo in coda e ritrasmesso man mano che arrivano visite al negozio: al massimo ogni 30 secondi, mai due ritrasmissioni insieme, a blocchi di massimo 20 eventi inviati in parallelo.
- Negozio con poco traffico: un URL di cron facoltativo, protetto da un token e raggiungibile solo in https, avvia la ritrasmissione senza aspettare una visita.
- Acquisti e rimborsi hanno la precedenza, poi gli eventi più recenti.
- Un evento esce dalla coda solo quando ha più di 7 giorni **e** aspetta da più di 7 giorni. A quel punto viene conteggiato come scaduto: niente sparisce senza lasciare traccia.
- Se DataFirefly non risponde (errore di rete, HTTP 429 o 5xx), il negozio smette di inviare direttamente per 60 secondi e mette subito gli eventi in coda. Così un guasto da parte nostra non rallenta mai il tuo negozio né il checkout. La ritrasmissione continua a provare e, appena riesce, l'invio diretto riprende.
- La pagina del tuo sito nell'area clienti mostra lo stato di questa coda. Gli stati sono spiegati nella pagina [Risoluzione dei problemi](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

## In caso di problemi

- Log: **Parametri avanzati > Log**, filtra sul prefisso `[DataFirefly SS]`.
- Se usi una versione del modulo precedente alla 1.8.0, aggiorna: le versioni recenti correggono un possibile doppio conteggio degli acquisti in GA4.
- Le altre cause frequenti sono elencate nella [guida alla risoluzione dei problemi](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

Aggiornato: 1 settembre 2026
