Analytics & Insights
Mapiry provides basic analytics to help you understand how people interact with your maps. This guide covers what analytics are actually available.
What Analytics Are Available
Mapiry tracks three main metrics:
- Views - How many times your map was viewed
- Shares - How many times your map was shared (by platform)
- Likes - How many people liked your map
That's it. Most advanced analytics features are not implemented.
Accessing Analytics
From Your Dashboard
- Log into your account
- The main page is your analytics dashboard
- You'll see aggregated stats for all your maps
Map-Specific Analytics
Click on any map card to see detailed analytics for that individual map.
View Tracking
How Views Are Counted
Rate limiting: One view per IP address or user per 24 hours
- Prevents inflation from page refreshes
- Resets every 24 hours from the last view
Logged-in users: Tracked by user ID
Anonymous visitors: Tracked by hashed IP address (privacy-friendly)
What Counts as a View
- Loading the map page directly (mapiry.com/m/your-slug)
- Viewing an embedded map (in an iframe)
- Temporary access token views (for private maps)
What You Can See
Total views: Count of all views in the selected time period
View trends: Line chart showing views over time
- Daily granularity
- Can filter by date range (default: last 30 days)
Unique viewers: Count of distinct IP addresses/user IDs
- Calculated using SQL:
COUNT(DISTINCT COALESCE(userId, ipAddress)) - Gives you an idea of reach vs. repeat visitors
Share Tracking
How Shares Are Tracked
When someone clicks a share button on your map, it's recorded with the platform they used.
Platforms tracked:
- Copy Link
- Direct Link
Important: Only shares made through Mapiry's share buttons are tracked. If someone manually copies the URL and shares it elsewhere, it won't be counted.
What You Can See
Total shares: Count of all shares
Shares by platform: Breakdown showing:
- How many shares on each platform
- Bar chart visualization
- Helps you see which platforms your audience prefers
Share rate: Shares divided by views
- Example: 50 shares / 1,000 views = 5% share rate
Like Tracking
How Likes Work
Users can "like" (heart) your map:
Logged-in users: Tracked by user ID
- One like per user per map
- Can unlike and like again
Anonymous users: Tracked by IP address
- One like per IP per map
- Uses hashed IP for privacy
What You Can See
Total likes: Count of all likes for a map
Like count is displayed but there's no detailed breakdown or trends for likes.
Top Maps
Your analytics dashboard shows your top-performing maps ranked by:
- Views
- Shares
- View/share ratio
Each map shows:
- Title
- View count
- Share count
- Share rate percentage
Date Filtering
You can filter analytics by date range:
Default: Last 30 days
Custom range: Select start and end dates
- View trends for specific periods
- Compare different time frames
What Analytics Are NOT Available
To set accurate expectations, here's what Mapiry does not currently track:
Location-Level Analytics
- ❌ Which locations get clicked most
- ❌ Which locations are most viewed
- ❌ Engagement by category
- ❌ Location-specific metrics
User Behavior
- ❌ Session duration
- ❌ Interaction heatmaps
- ❌ Zoom level tracking
- ❌ Search queries
- ❌ Filter usage
- ❌ Click tracking (links, phone numbers, etc.)
Traffic Sources
- ❌ Referrer tracking (where views came from)
- ❌ Geographic distribution of viewers
- ❌ Social media vs. direct traffic
- ❌ Search engine traffic
Advanced Metrics
- ❌ Conversion tracking
- ❌ Goal funnels
- ❌ A/B testing
- ❌ Custom events
- ❌ User paths
- ❌ Attribution modeling
Embed-Specific Analytics
- ❌ Which sites embed your map
- ❌ Performance by embedding site
- ❌ Load time tracking
- ❌ Scroll depth
- ❌ Bounce rate
Comparison Features
- ❌ Compare multiple maps side-by-side
- ❌ Time period comparisons
- ❌ Industry benchmarks
- ❌ Cohort analysis
Pro vs. Free Analytics
Both Free and Pro users get the same analytics:
- Views with 24-hour rate limiting
- Shares by platform
- Likes
- View trends
- Top maps ranking
Pro does not unlock additional analytics features. The main Pro benefits are higher limits and white-label embeds, not analytics.
Privacy & Data Handling
IP Address Hashing
Anonymous visitor IPs are hashed using SHA-256:
- Original IP is never stored
- Hash is used for deduplication only
- Privacy-compliant tracking
User Agent Storage
User agents are stored for analytics but not currently displayed in the UI.
No External Analytics
Mapiry doesn't use Google Analytics, Facebook Pixel, or other third-party analytics tools. All tracking is internal and privacy-focused.
Using Analytics Effectively
What You Can Learn
1. Is your map getting attention?
- Total views tell you if people are finding your map
- Growth trends show if interest is increasing
2. Are people sharing?
- Share count indicates if your map is valuable enough to share
- Platform breakdown shows where your audience is
3. Which maps perform best?
- Top maps ranking helps you understand what works
- Apply lessons from successful maps to new ones
Limitations to Keep in Mind
Can't track:
- Why people visit
- What they're looking for
- Which locations interest them most
- Where they came from
- What they do after viewing
Workarounds:
- Use UTM parameters in shared links to track sources
- Ask for feedback directly (no comment system exists)
- Check referrer logs on your own website if you embed maps
- Use external analytics on your website where maps are embedded
Troubleshooting
Views seem low
- Views are rate-limited to 1 per IP/user per 24 hours
- Multiple page refreshes don't count as multiple views
- Private maps only count views from you and access token holders
Shares not being tracked
- Only shares through the Share button are counted
- Manual URL copying doesn't count
- Check that you're looking at the right date range
Analytics not updating
- Analytics update in real-time
- Refresh the page if data seems stale
- Check your date range filter
No analytics showing
- Make sure you're logged in
- Only the map owner can see analytics
- Analytics are only available for saved maps (not temp maps)
What's Next?
- Sharing Maps - Learn how sharing is tracked
- Pro Features - Understand Pro plan benefits
- Limits - View tracking limits and quotas
- Typical engagement rates
- Standard session duration
Helps set realistic goals and identify improvement opportunities.
Exporting Analytics Data
Built-in Export
- Go to any analytics view
- Click "Export" button
- Choose format:
- CSV - For Excel/Google Sheets
- PDF - For reports and presentations
- JSON - For integrations
- Select date range
- Download
Scheduled Reports (Pro)
Receive analytics automatically:
- Analytics > "Scheduled Reports"
- Click "Create Report"
- Configure:
- Frequency (daily, weekly, monthly)
- Maps to include
- Metrics to track
- Email recipients
- Save
Reports are sent via email at your chosen interval.
API Access (Pro)
Integrate analytics with your own systems:
// Fetch analytics via API
fetch('https://api.mapiry.com/v1/analytics/map/abc123', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(res => res.json())
.then(data => console.log(data));
See our API Documentation for details.
Privacy & GDPR
User Privacy
Mapiry respects user privacy:
- No personally identifiable information (PII) is collected
- IP addresses are anonymized after geolocation
- Cookies are optional (users can opt out)
- Full GDPR compliance
Data Retention
Analytics data is retained for:
- Free accounts: 90 days
- Pro accounts: 2 years
- Enterprise: Custom retention periods
Disabling Analytics
Don't want to track your map?
- Map Settings > "Privacy"
- Toggle off "Enable analytics"
- Save
Note: Basic metrics (total views) are still counted but no user behavior data is tracked.
GDPR-Compliant Analytics
For EU audiences:
- Enable "GDPR Mode" in Map Settings > "Privacy"
- Users will see a cookie consent banner
- Analytics only track users who consent
- Anonymized aggregates are still available
Advanced Features
Custom Dimensions (Pro)
Track additional data:
// Track custom dimension
mapiry.track('custom_dimension', {
user_type: 'premium_member',
referral_code: 'SUMMER2026'
});
View custom dimension reports in Analytics > "Custom Dimensions".
Event Tracking (Pro)
Track custom events:
// Track custom event
mapiry.event('video_played', {
location_id: 'loc_abc123',
video_id: 'intro_video'
});
Cohort Analysis (Pro)
Group users by behavior:
- First-time visitors vs. returning
- Mobile vs. desktop users
- By traffic source
- By location viewed first
Compare engagement across cohorts to understand different user types.
A/B Testing (Pro)
Test map variations:
- Create two versions of your map (different styling, content, etc.)
- Analytics > "A/B Tests" > "Create Test"
- Select maps to test
- Set traffic split (50/50, 70/30, etc.)
- Define success metrics
- Launch test
After sufficient data, see which version performs better.
Using Analytics to Improve
1. Optimize Underperforming Locations
If a location gets few clicks:
- Add better description
- Include an image
- Verify coordinates are accurate
- Consider if it's relevant to your map's theme
2. Promote Popular Locations
Your most-clicked locations:
- Feature them prominently
- Add more similar locations
- Create related maps
- Mention them in map description
3. Improve Category Organization
If users rarely filter by category:
- Categories might be unclear
- Consider renaming for clarity
- Reduce number of categories
- Add category descriptions
4. Optimize for Mobile
If most traffic is mobile but engagement is low:
- Test your map on various devices
- Simplify popup content
- Increase marker sizes
- Enable touch-friendly controls
5. Leverage Referrers
Sites embedding your map with high engagement:
- Reach out for partnership opportunities
- Create custom maps for them
- Offer to optimize embeds
- Ask for testimonials
6. Content Strategy
Create more maps similar to your top performers:
- Same topic/theme
- Same geographic area
- Same styling approach
- Same level of detail
Analytics Best Practices
1. Check Regularly
Review analytics weekly or biweekly to catch issues early and spot trends.
2. Set Goals
Before reviewing analytics, ask:
- What am I trying to achieve?
- What does success look like?
- What metrics matter most?
3. Look for Patterns
Don't fixate on individual numbers:
- Is engagement increasing or decreasing?
- Do certain days perform better?
- Which locations consistently perform well?
4. Take Action
Analytics are only useful if you act on insights:
- Update content based on data
- Test changes and measure impact
- Iterate continuously
5. Share Insights
If working with a team:
- Share weekly analytics summaries
- Highlight wins and areas for improvement
- Collaborate on optimization strategies
Troubleshooting
Analytics not updating
- Data refreshes every hour (not real-time)
- Check if analytics are enabled in Map Settings
- Clear browser cache and refresh
- Verify map has been viewed recently
View counts seem low
- Check if analytics started after you created the map
- Embed views may take longer to register
- Ensure your map is public
- Consider if your traffic expectations are realistic
Location clicks not tracked
- Verify you're using the latest embed code
- Check if ad blockers are interfering (in your tests)
- Ensure popup opens (clicks only count if popup displays)
Referrer shows as "Direct" when embedded
- The hosting site may be blocking referrer headers
- Some privacy-focused browsers hide referrers
- Use UTM parameters in share links for better tracking
Export not working
- Check your browser's download settings
- Try a different format (CSV instead of PDF)
- Verify you have data in the selected date range
- Contact support if issue persists
What's Next?
- Pro Features - Unlock advanced analytics
- Embedding Maps - Optimize embeds for better tracking
- Best Practices - Use analytics to create better maps
- API Documentation - Integrate analytics programmatically