Documentation

Technical Guides

Inhaltsverzeichnis

1. Getting Started

1.1 Creating Your Account
  1. Visit the GeoTrack signup page at /signup
  2. Choose your subscription plan (Basic, Starter, or Professional)
  3. Enter your email address and create a secure password
  4. Click „Create Account“
  5. 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.

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

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
Your dashboard displays: Key Metrics: • Total QR Codes: Number of QR codes you’ve created • Total Scans: All-time scan count across all QR codes • Active Geofences: Number of geofences currently active • This Month’s Scans: Scans recorded in the current calendar month

3. Creating QR Codes

3.1 Standard QR Code

Purpose: Simple QR code that redirects to a single URL.

Steps:

  1. Go to „QR Codes“ in the navigation menu
  2. Click „Create New QR Code“
  3. Select „Standard“ as the type
  4. Enter a name for your QR code (e.g., „Product Brochure“)
  5. Enter the destination URL
  6. Click „Create QR Code“

Use Cases:

  • Product information pages
  • Event registration
  • Contact information
  • Social media profiles

Purpose: Redirect users to different URLs based on their physical location.

Steps:

  1. Navigate to „QR Codes“ → „Create New QR Code“
  2. Select „Geofence“ as the type
  3. Enter a name for your QR code
  4. Enter the default URL (used when user is outside all geofences)
  5. Click „Create QR Code“
  6. Go to „Geofences“ menu and click „Create Geofence“
  7. Select your QR code, set location and radius
  8. Enter the redirect URL for this location

Use Cases:

  • Multi-location retail stores
  • Regional content delivery
  • Location-specific offers
  • Event venue navigation

Purpose: Automatically redirect users to the nearest location from a predefined list.

How It Works:

  1. User scans the QR code
  2. System detects user’s GPS coordinates
  3. Calculates distance to all locations
  4. Redirects to the nearest one

Use Cases:

  • Franchise businesses
  • Chain restaurants
  • Service providers with multiple offices
  • Store locators

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

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
  1. Go to „Geofences“ in the navigation
  2. Click „Create Geofence“
  3. Select the QR code you want to geofence
  4. Enter location information (address or coordinates)
  5. Set the radius in meters (default: 100m)
  6. Enter the redirect URL for this geofence
  7. Click „Create Geofence“

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

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

Steps:

  1. Go to Analytics page
  2. Set your desired filters
  3. Click „Export Data“
  4. Choose format (CSV)
  5. 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

  1. Go to „Team“ in navigation (must be Admin)
  2. Click „Invite Team Member“
  3. Enter their email address
  4. Select their role (Admin, Manager, or Field User)
  5. Click „Send Invitation“
  6. 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
  1. Go to „Pricing“ page or Dashboard
  2. Click „Upgrade“ on desired plan
  3. Review new plan features and limits
  4. Confirm upgrade
  5. Prorated charge applied immediately
  6. New limits active immediately

8. Advanced Features

8.1 Combining Geofences and Time Rules

Example Use Case: Restaurant Chain

  1. Create a multi-location QR code
  2. Add geofences for each restaurant location
  3. 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

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

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

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

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

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