Requirements
- PrestaShop 1.7.6 or later.
- The module zip, downloaded from the Modules page of your client area.
- Your site's connection key.
Installation
- PrestaShop back office: Modules > Module Manager > Upload a module.
- Upload the zip as is, without unzipping it.
- Click Configure.
Configuration
- Fill in Tenant ID, HMAC secret and Events endpoint: the three values from your DataFirefly site page.
- Require consent option: the module lets an event out only once the visitor has accepted advertising. It recognises these on its own, with nothing to configure: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, in the browser and on the server, the same list as the WooCommerce and Shopware modules. Recommended if your shop has a consent banner.
- Set Enable tracking to Yes: it ships disabled by default.
- Save, then click Send test event.
No consent banner on your store yet? The Cookie Manager for PrestaShop ships tarteaucitron ready to use, with Consent Mode v2.
Verify
- The test event must show as Delivered in your client area's Monitoring.
- Place a test order: the module sends purchases on order validation.
Retry queue
Applies to version 1.29.0 and later.
- A failed delivery is queued, then replayed as visitors browse the shop: at most every 30 seconds, never two replays at once, in batches of up to 20 events sent in parallel.
- Low-traffic shop: an optional cron URL, protected by a token and served over https only, triggers the replay without waiting for a visit.
- Purchases and refunds go first, then the most recent events.
- An event leaves the queue only when it is more than 7 days old and has been waiting for more than 7 days. It is then counted as expired: nothing disappears silently.
- If DataFirefly does not answer (network failure, HTTP 429 or 5xx), the shop stops sending directly for 60 seconds and puts events straight into the queue. An outage on our side therefore never slows down your shop or its checkout. The replay keeps trying, and as soon as it succeeds, direct sending resumes.
- Your site page in the client area shows the state of this queue. The states are explained in the troubleshooting guide.
If something goes wrong
- Logs: Advanced Parameters > Logs, filter on the
[DataFirefly SS]prefix. - If you run a module version older than 1.8.0, update: recent versions fix a possible double count of purchases in GA4.
- The other frequent causes are listed in the troubleshooting guide.
Updated: September 1, 2026