Analytics

See who scans your dynamic QR codes, from where and on what device, with bot traffic filtered out.

Every scan of a dynamic code passes through EZQR before the visitor reaches your destination. EZQR records that scan, so you can see which codes and placements perform, where people scan from and when. Static codes aren't tracked, because they don't pass through EZQR.

Where to find analytics

  • Analytics in the sidebar shows all your codes together. Filter to All QR Codes or a single code, and choose Last 7 days, Last 30 days or Last 3 months.
  • A code's page shows Total Scans and an Analytics section for that code, with Top Devices. Click View all to open the full dashboard.

What's tracked

For each scan, EZQR records:

DataDetails
TimeWhen the scan happened
Device typeMobile, Tablet or Desktop
Browser and OSFor example Chrome, Safari, iOS, Android
LocationCountry and city, based on the scanner's IP address
ReferrerThe referring page, when one is sent
UTM parametersutm_source, utm_medium, utm_campaign, utm_content and utm_term on the scanned link
VisitorAn anonymous ID stored in a cookie, used to count unique visitors

Dashboard breakdowns

  • Overview: Human Scans and Unique Visitors over time.
  • Device Breakdown: scans by device type.
  • Top Locations: scans by country, and by city on Pro and Max.
  • UTM Sources, UTM Mediums, Campaigns and Referrers.
  • Top Performing QR Codes: your best codes in the selected period.
  • Time of day: scans by weekday and hour in your timezone, with the busiest slot highlighted.

Human vs bot scans

Not every request to a short link is a person with a phone. Link previews in chat apps, email security scanners and crawlers also open links. EZQR classifies each request and excludes bots from Human Scans and Unique Visitors.

When bots were filtered in the selected period, the overview shows how many, grouped by reason:

ReasonExamples
Link previewsWhatsApp, Slack, Telegram, Discord, LinkedIn previews
Email security scannersSafe-link and URL-defense scanners
Search and AI crawlersSearch engine and AI crawler bots
Scripts and headless browserscurl, headless Chrome, HTTP libraries
Uptime monitorsUptime and synthetic monitoring services
Browser prefetchRequests marked as prefetch or prerender
No browser informationRequests without a user agent
Missing browser languageRequests without a browser language

Bots still reach your destination. They're just not counted as human scans, and they don't trigger retargeting pixels or qr.scanned webhooks.

Plan differences

FreeLiteProMax
Total scan countYesYesYesYes
Detailed analyticsNoYesYesYes
HistoryCount onlyLast 30 daysFullFull
Location detailNoneCountryCountry and cityCountry and city
Scan alertsNoNoNoYes
Weekly email reportNoNoNoYes

On Lite, longer periods are limited to the last 30 days.

Scan alerts

On Max, a code's page has a Scan alerts card. Click Add alert, set a scan count under Email me at, choose who to notify under Send to and click Save alert. EZQR emails that person when the code reaches the count. You can pause or remove an alert at any time.

Weekly reports

On Max, you get a weekly email with total scans for the past 7 days and the top-performing codes.

Getting data out

  • API: on Max, GET /api/v1/qr-codes/{id}/analytics returns stats for a code. See the API reference.
  • Webhooks: on Pro and Max, the qr.scanned event sends each human scan to your systems as it happens. See Webhooks.