Analytics
Scan Analytics
The Analytics module provides real-time visibility into how consumers and supply-chain partners are engaging with your published Digital Product Passports — tracking scan volume, trends over time, top-performing passports, and geographic reach.
Purpose
Every time a published passport is accessed via its QR code or GS1 Digital Link, a scan event is recorded. Analytics aggregates these events into charts and summary cards so you can measure engagement, identify high-performing products, and spot drops in scan activity that may indicate distribution or labeling issues.
When to Use
You want to verify that your printed QR labels are being scanned in the field.
You are presenting engagement metrics to retailers, auditors, or sustainability stakeholders.
You want to identify which products get the most passport views and replicate what works.
You need to investigate a sudden drop in scans that could indicate a broken QR code or expired label.
You want to understand the geographic distribution of scans to plan future market activity.
Prerequisites
At least one passport must be in PUBLISHED status — draft passports do not generate scan events.
That published passport must have been scanned at least once via its QR code or GS1 Digital Link.
Scan data collection requires no additional setup; it is automatic for all published passports.
Understanding the Analytics Dashboard
The Analytics page at /dashboard/analytics is organized into three areas:
Summary cards
At the top of the page, four metric cards give an at-a-glance count of total scans, unique scans, and the top passport for the selected date range.
Trend charts
A Recharts line chart plots scan volume over the selected date range, with one data point per day. A bar chart shows total scans broken down by passport.
Geographic distribution
A table or map panel shows which countries or regions scans originated from, based on the geolocation of the requesting IP address.
Metrics Reference
| Metric | Definition |
|---|---|
| Total scans | Every scan event recorded for published passports in the selected date range, including repeat scans by the same user. |
| Unique scans | Scan events from distinct sessions or devices. Two scans from the same device within the same session count as one unique scan. |
| Scan rate over time | Daily scan count plotted on the line chart. Shows whether engagement is growing, stable, or declining. |
| Top passports by scan count | Passports ranked by total scans in the selected period, displayed as a bar chart. Identifies your highest-engagement products. |
| Geographic distribution | Breakdown of scans by country or region, based on IP geolocation. Useful for understanding where your products circulate. |
Using Date Filters
The date range selector at the top right of the Analytics page controls which scan events are included in all charts and counters on the page. Available presets:
Last 7 daysRolling window of the most recent 7 days. Best for monitoring recent campaigns or label launches.
Last 30 daysRolling 30-day window. Suitable for monthly reporting cycles.
Last 90 daysRolling 90-day window. Good for quarterly trend analysis.
All timeEvery scan event since the passport was first published. Useful for a full lifetime view.
You can also filter by a specific passport using the passport selector dropdown. Choosing a single passport scopes all metrics to that passport only.
Interpreting Trends
Rising scan rate
Increased market activity, a successful product launch, or a retailer placing your labeled products on shelves. No action needed unless the rate exceeds expectations and you want to confirm the passport content is correct.
Stable scan rate
Steady engagement. Normal for products in ongoing distribution. Check periodically that the passport data remains accurate.
Sudden drop to zero
Could indicate a QR code printing issue, a passport being unpublished, or a product being removed from shelves. Verify the passport is still PUBLISHED and that its QR code resolves correctly using Scan & Lookup.
Spike on a single day
Often caused by a media mention, a trade show scan demo, or a bulk retailer intake process. Cross-reference with your own marketing calendar.
What the Data Does Not Show
Scans of DRAFT passports — only published passports generate scan events.
Internal admin views — loading a passport in the PassportBox dashboard does not count as a scan.
Scan intent — Analytics cannot distinguish a consumer scan from a retailer inventory check.
Individual user identity — scan data is aggregated and anonymized; no personal identifiers are stored.
Compliance score history — compliance scores are tracked separately on the Dashboard overview, not here.
Validation Rules and Edge Cases
No data yet
If no published passport has been scanned in the selected date range, all charts render empty states with zero counts. This is expected for newly published passports.
All passports unpublished
If you have passports but none are published, the Analytics page shows empty state across all metrics. Publish at least one passport to start collecting scan data.
Geographic data unavailable
Scans from clients that block geolocation or use VPNs may appear under an "Unknown" region entry. This is normal and does not affect total or unique scan counts.
Date range shows partial data
If a passport was published partway through the selected date range, earlier dates in the chart will show zero for that passport. This is correct; scans only begin when the passport is published.
What Success Looks Like
Total scans counter is greater than zero for the selected date range.
The trend line chart shows scan events distributed across time, not a single-day spike.
At least one passport appears in the top passports bar chart.
Geographic distribution shows at least one country with scan activity.
Troubleshooting
Analytics page shows all zeros despite having published passports
Confirm the selected date range covers the period when scans actually occurred. Switch to "All time" to see if any data exists at all. If still zero, no scans have been recorded yet — share the passport QR code and perform a test scan.
Scans I know happened are not appearing
Only scans via the public QR code or GS1 Digital Link are recorded. Directly opening the passport URL while logged in to PassportBox does not generate a scan event. Test by scanning the QR code on a phone in a private/incognito browser session.
Passport filter dropdown is empty
No passports are currently in PUBLISHED status. Draft passports do not appear in the filter. Publish at least one passport from the Passports page to populate the filter.
Geographic distribution shows only "Unknown"
This can occur if all scans originated from clients using VPNs, Tor, or privacy browsers that mask IP geolocation. Total and unique scan counts remain accurate regardless.
Charts are not loading
Try a hard refresh (Ctrl+Shift+R or Cmd+Shift+R). If the issue persists, check your browser console for network errors. The charts require JavaScript and rely on the PassportBox API being reachable.