Documentation
Technical Guides
Inhaltsverzeichnis
1. Getting Started
1.1 Creating Your Account
- Visit the GeoTrack signup page at /signup
- Choose your subscription plan (Basic, Starter, or Professional)
- Enter your email address and create a secure password
- Click „Create Account“
- You’ll be automatically logged in and redirected to your dashboard
Note: All plans include a 7-day free trial. Your card won’t be charged until the trial ends.
1.2 First Login
When you first log in, you’ll see:
- Your dashboard with quick stats (currently at zero)
- Navigation menu on the left with available features
- A welcome message prompting you to create your first QR code
1.3 Understanding Your Plan Limits
Basic Plan ($4.99/month)
- 20 QR codes
- 5,000 scans per month
- 1 team member
- 7 days data retention
- Email support (48h response)
Starter Plan ($14.99/month)
- 100 QR codes
- 25,000 scans per month
- 2 team members
- 30 days data retention
- Priority email support (24h)
Professional Plan ($44.99/month)
- 500 QR codes
- 250,000 scans per month
- 10 team members
- 90 days data retention
- Priority support + API access
2. Dashboard Overview
2.1 Dashboard Components
3. Creating QR Codes
3.1 Standard QR Code
Purpose: Simple QR code that redirects to a single URL.
Steps:
- Go to „QR Codes“ in the navigation menu
- Click „Create New QR Code“
- Select „Standard“ as the type
- Enter a name for your QR code (e.g., „Product Brochure“)
- Enter the destination URL
- Click „Create QR Code“
Use Cases:
- Product information pages
- Event registration
- Contact information
- Social media profiles
3.2 Geofenced QR Code
Purpose: Redirect users to different URLs based on their physical location.
Steps:
- Navigate to „QR Codes“ → „Create New QR Code“
- Select „Geofence“ as the type
- Enter a name for your QR code
- Enter the default URL (used when user is outside all geofences)
- Click „Create QR Code“
- Go to „Geofences“ menu and click „Create Geofence“
- Select your QR code, set location and radius
- Enter the redirect URL for this location
Use Cases:
- Multi-location retail stores
- Regional content delivery
- Location-specific offers
- Event venue navigation
3.3 Multi-Location QR Code
Purpose: Automatically redirect users to the nearest location from a predefined list.
How It Works:
- User scans the QR code
- System detects user’s GPS coordinates
- Calculates distance to all locations
- Redirects to the nearest one
Use Cases:
- Franchise businesses
- Chain restaurants
- Service providers with multiple offices
- Store locators
3.4 Adding Time-Based Rules
You can add time-based routing to any QR code to redirect users based on when they scan.
Configure:
- Days of Week: Select which days this rule applies
- Time Range: Set start and end times (24-hour format)
- Date Range: Optional specific date range
- Priority: Higher numbers take precedence
- Destination URL: Where to redirect during this time
Examples:
- Restaurant menus (breakfast, lunch, dinner)
- Business hours vs. after-hours information
- Seasonal content
- Event-specific redirects
3.5 Setting Scan Limits
Create scarcity and urgency with scan limits.
Use Cases:
- Limited-time offers („First 100 customers get 20% off“)
- Exclusive access codes
- Event capacity management
- Promotional campaigns
4. Managing Geofences
4.1 Creating a Geofence
- Go to „Geofences“ in the navigation
- Click „Create Geofence“
- Select the QR code you want to geofence
- Enter location information (address or coordinates)
- Set the radius in meters (default: 100m)
- Enter the redirect URL for this geofence
- Click „Create Geofence“
4.2 Geofence Best Practices
Radius Selection:
- Urban areas: 50-100 meters (high GPS accuracy)
- Suburban areas: 100-300 meters (moderate accuracy)
- Rural areas: 300-1000 meters (lower GPS accuracy)
Overlapping Geofences:
- When geofences overlap, the system uses the closest center point
- Use priority settings to control behavior
- Test thoroughly in areas where geofences overlap
5. Analytics & Reporting
5.1 Analytics Dashboard
Overview Metrics:
- Total scans (all time)
- Unique scans
- Scans this month
- Scan growth percentage
Charts and Graphs:
- Scan timeline (daily/weekly/monthly)
- Geographic distribution
- Device breakdown (mobile vs. desktop)
- Browser statistics
5.2 Scan Map
The interactive map shows:
- Pin markers for each scan location
- Cluster markers when multiple scans are nearby
- Click pins to see scan details
- Zoom and pan to explore regions
5.3 Exporting Data
Steps:
- Go to Analytics page
- Set your desired filters
- Click „Export Data“
- Choose format (CSV)
- Download file
Exported Data Includes:
- Timestamp, QR code name, Location
- Device type, Browser, Operating system
- User agent string
6. Team Management
6.1 Team Roles
Admin
• Full access to all features
• Invite/remove team members
• Manage billing
• View all analytics
• Access settings
Manager
• Create/manage QR codes
• Create/manage geofences
• View all analytics
• Cannot manage team
• Cannot access billing
Field User
• Create QR codes
• View own QR codes only
• Limited analytics access
• Cannot manage geofences
• Cannot access billing
6.2 Inviting Team Members
- Go to „Team“ in navigation (must be Admin)
- Click „Invite Team Member“
- Enter their email address
- Select their role (Admin, Manager, or Field User)
- Click „Send Invitation“
- Invitee receives email with acceptance link
Note: You can only invite as many members as your plan allows (Basic: 1, Starter: 2, Professional: 10)
7. Subscription & Billing
7.1 Viewing Subscription Status
Status Indicators:
- Active: Subscription is current and active
- Trial: Within 7-day trial period
- Past Due: Payment failed, retrying
- Canceled: Canceled but still active until period end
- Expired: Subscription ended
7.2 Upgrading Your Plan
- Go to „Pricing“ page or Dashboard
- Click „Upgrade“ on desired plan
- Review new plan features and limits
- Confirm upgrade
- Prorated charge applied immediately
- New limits active immediately
8. Advanced Features
8.1 Combining Geofences and Time Rules
Example Use Case: Restaurant Chain
- Create a multi-location QR code
- Add geofences for each restaurant location
- Add time-based rules for menus (breakfast, lunch, dinner)
Priority System:
- Geofence + Time Rule match = highest priority
- Geofence match only = medium priority
- Time rule match only = low priority
- No match = default URL
8.2 Dynamic URL Parameters
Pass information about the scan to your destination URL:
Available Parameters:
{scan_id}– Unique scan identifier{qr_code_id}– QR code identifier{timestamp}– Unix timestamp{lat}– Latitude{lng}– Longitude
https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}9. Troubleshooting
9.1 QR Code Not Scanning
Possible Causes:
- QR code image quality too low
- Poor lighting conditions
- Camera focus issues
- QR code too small or too large
Solutions:
- Download higher resolution QR code (300×300 or 500×500)
- Ensure good contrast (dark on light background)
- Maintain minimum size of 2cm x 2cm for printing
9.2 Wrong Location Detected
Causes:
- GPS disabled on device
- Indoor location (GPS signals weak)
- Device GPS accuracy low
- User denied location permission
Solutions:
- Ask users to enable location services
- Increase geofence radius for indoor use
- Provide fallback URL for location failures
9.3 Geofence Not Working
Checklist:
- Is geofence active? (Check status in dashboard)
- Is QR code type set to „Geofence“?
- Is radius appropriate for the area?
- Did you test on device with location enabled?
- Are coordinates correct? (Verify on map)
10. Best Practices
10.1 QR Code Design
✓ Do:
- Use high contrast (black on white is ideal)
- Leave white space around code (quiet zone)
- Test before mass printing
- Include clear call-to-action text
✗ Don’t:
- Use colors that reduce contrast
- Make QR code too small (min 2cm x 2cm)
- Place on curved surfaces
- Use low-resolution images
10.2 Geofence Strategy
Planning:
- Map out all locations first
- Determine appropriate radius for each
- Consider GPS accuracy in each area
- Test overlapping scenarios
Optimization:
- Start with larger radii, narrow down after testing
- Use analytics to verify geofence accuracy
- Adjust based on real-world scan data
10.3 Security & Privacy
Protecting Your Account:
- Use strong, unique password
- Enable two-factor authentication (coming soon)
- Don’t share login credentials
- Review team member access regularly
User Privacy:
- Only collect necessary location data
- Comply with GDPR/privacy regulations
- Secure destination URLs with HTTPS