How it works.
Setup guides, API references, integration recipes. Start with the quickstart, branch out into the technical reference when you are ready.
Inhaltsverzeichnis
1. Getting Started
1.1 Creating Your Account
- Besuchen Sie die GeoTrack-Anmeldeseite unter /signup
- Wählen Sie Ihr Abonnement (Basic, Starter oder Professional)
- Geben Sie Ihre E-Mail-Adresse ein und legen Sie ein sicheres Passwort fest
- Klicken Sie auf “Konto erstellen”
- Sie werden automatisch angemeldet und zu Ihrem Dashboard weitergeleitet
Hinweis: Alle Pläne beinhalten eine 7-tägige kostenlose Testphase. Ihre Karte wird erst nach Ablauf der Testphase belastet.
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
Zweck: Einfacher QR-Code, der auf eine einzelne URL weiterleitet.
Schritte:
- Gehen Sie im Navigationsmenü zu “QR-Codes”
- Klicken Sie auf “Neuen QR-Code erstellen”
- Wählen Sie “Standard” als Typ
- Geben Sie einen Namen für Ihren QR-Code ein (z. B. “Produktbroschüre”)
- Geben Sie die Ziel-URL ein
- Klicken Sie auf “QR-Code erstellen”
Anwendungsfälle:
- Produktinformationsseiten
- Veranstaltungsanmeldung
- Kontaktinformationen
- Social-Media-Profile
3.2 Geofenced QR Code
Zweck: Nutzer je nach physischem Standort auf unterschiedliche URLs weiterleiten.
Schritte:
- Navigieren Sie zu “QR-Codes” → “Neuen QR-Code erstellen”
- Wählen Sie “Geofence” als Typ
- Geben Sie einen Namen für Ihren QR-Code ein
- Geben Sie die Standard-URL ein (wird verwendet, wenn der Nutzer außerhalb aller Geofences ist)
- Klicken Sie auf “QR-Code erstellen”
- Gehen Sie zum Menü “Geofences” und klicken Sie auf “Geofence erstellen”
- Wählen Sie Ihren QR-Code aus, legen Sie Standort und Radius fest
- Geben Sie die Weiterleitungs-URL für diesen Standort ein
Anwendungsfälle:
- Filialgeschäfte an mehreren Standorten
- Regionale Inhaltsauslieferung
- Standortspezifische Angebote
- Navigation auf Veranstaltungsgeländen
3.3 Multi-Location QR Code
Zweck: Nutzer automatisch zum nächstgelegenen Standort aus einer vordefinierten Liste weiterleiten.
So funktioniert es:
- Nutzer scannt den QR-Code
- System erkennt die GPS-Koordinaten des Nutzers
- Berechnet die Entfernung zu allen Standorten
- Leitet zum nächstgelegenen weiter
Anwendungsfälle:
- Franchise-Unternehmen
- Restaurantketten
- Dienstleister mit mehreren Standorten
- Filialfinder
3.4 Adding Time-Based Rules
Sie können jedem QR-Code zeitbasiertes Routing hinzufügen, um Nutzer je nach Scan-Zeitpunkt weiterzuleiten.
Konfigurieren:
- Wochentage: Wählen Sie, an welchen Tagen diese Regel gilt
- Zeitspanne: Start- und Endzeit festlegen (24-Stunden-Format)
- Datumsbereich: Optionaler spezifischer Datumsbereich
- Priorität: Höhere Zahlen haben Vorrang
- Ziel-URL: Wohin während dieser Zeit weitergeleitet wird
Beispiele:
- Restaurant-Menüs (Frühstück, Mittag, Abend)
- Geschäftszeiten vs. Informationen außerhalb der Geschäftszeiten
- Saisonale Inhalte
- Veranstaltungsspezifische Weiterleitungen
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
Radiuswahl:
- Städtische Gebiete: 50–100 Meter (hohe GPS-Genauigkeit)
- Vororte: 100–300 Meter (mäßige Genauigkeit)
- Ländliche Gebiete: 300–1000 Meter (geringere GPS-Genauigkeit)
Überlappende Geofences:
- Bei überlappenden Geofences verwendet das System den nächstgelegenen Mittelpunkt
- Nutzen Sie Prioritätseinstellungen, um das Verhalten zu steuern
- Testen Sie gründlich in Bereichen, in denen sich Geofences überlappen
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
- Gehen Sie in der Navigation zu “Team” (Admin-Rechte erforderlich)
- Klicken Sie auf “Teammitglied einladen”
- Geben Sie die E-Mail-Adresse ein
- Wählen Sie die Rolle (Admin, Manager oder Feldnutzer)
- Klicken Sie auf “Einladung senden”
- Der Eingeladene erhält eine E-Mail mit Bestätigungslink
Hinweis: Sie können nur so viele Mitglieder einladen, wie Ihr Plan erlaubt (Basic: 1, Starter: 2, Professional: 10)
7. Subscription & Billing
7.1 Viewing Subscription Status
Statusanzeigen:
- Aktiv: Abonnement ist aktuell und aktiv
- Testphase: Innerhalb der 7-tägigen Testphase
- Überfällig: Zahlung fehlgeschlagen, wird erneut versucht
- Gekündigt: Gekündigt, aber bis zum Periodenende weiterhin aktiv
- Abgelaufen: Abonnement beendet
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
Übergeben Sie Informationen zum Scan an Ihre Ziel-URL:
Verfügbare Parameter:
{scan_id}– Eindeutige Scan-Kennung{qr_code_id}– QR-Code-Kennung{timestamp}– Unix-Zeitstempel{lat}– Breitengrad{lng}– Längengrad
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