Conversion Funnel & Heatmap — Documentation

The DataFirefly – Conversion Funnel & Heatmap module (dffunnelheatmap) brings together two behavioral analytics tools for PrestaShop 8 and 9: a 9-step conversion funnel that shows exactly where your visitors drop off, and a heatmap that reveals what they click on and how far they scroll. All tracking is 100% first-party, with no third-party service, no CDN and no advertising cookie.

Installation

1. Download the dffunnelheatmap.zip archive from your customer account.
2. In the back office, go to Modules > Module Manager, click Upload a module and select the ZIP.
3. On install, the module creates its tables, registers its hooks and adds a Funnel & Heatmap tab under Stats.

Accessing the dashboard

Go to Stats > Funnel & Heatmap (or click Configure from the module list). The interface offers four views: Dashboard, Funnel, Heatmap and Settings.

The dashboard shows four key indicators: number of visits, number of orders, global conversion rate and automatic detection of the biggest drop-off in the funnel, along with a visual preview of the funnel.

The conversion funnel

The funnel tracks your visitors step by step, from the first visit to the placed order. For each step, you see the number of sessions involved and the drop-off percentage compared to the previous step. The nine steps are:

1. Visit — any page view (server-side detection).
2. Product page — viewing a product page (server).
3. Add to cart — detected client-side on the “add to cart” action.
4. Cart page — cart display (server).
5. Checkout — entering the checkout (server).
6. Address — checkout address step (client).
7. Shipping — carrier step (client).
8. Payment — payment step (client).
9. Order placed — reliably recorded server-side through the order validation hook.

The heatmap

The heatmap shows a real rendering of the selected page, with the collected behavioral data overlaid on top.

Click map

Clicks are shown as a heatmap, from blue (few clicks) to red (high concentration). Ideal for checking that your calls to action really attract attention.

Scroll depth

Scroll depth is displayed by tiers (25, 50, 75 and 100%), with the share of visitors who reached each level. This reveals the content everyone sees and what falls below the fold.

Top clicked elements

A side panel ranks the most clicked elements (by CSS selector and label), to pinpoint exactly what captures interest.

Filters

All views share a filter bar: date range (7, 30, 90 or 365 days, or a custom range), device (mobile, tablet, desktop) and store in a multistore context.

Settings

• Global toggle plus separate toggles for the funnel and the heatmap.
• Sampling (1 to 100%) applied to the heatmap only, to cap the volume on high-traffic sites. The funnel is always tracked at 100%.
• Retention in days, with opportunistic automatic purge and manual purge buttons.
• Do Not Track support (enabled by default).
• Tracking of employees logged into the back office (disabled by default).
• Purge on uninstall to remove the collected data when the module is removed.

Privacy (GDPR)

The module collects no personal data: no stored IP address, no email. The visitor ID is anonymous and random (technical cookie dffh_vid). Do Not Track is respected by default and the retention period is fully configurable. The tracking endpoint is protected by a server-validated token.

Troubleshooting

Uninstalling

Uninstalling removes the tab and the hooks. Collected data is kept by default; tick the Purge on uninstall option in the settings beforehand if you want to delete it permanently.