D01 · DOCUMENTATIONSCANFENCE / DOCUMENTATIONQUICKSTART · API · RECIPES
Comment ça marche.
Guides de configuration, références API, recettes d’intégration. Commencez par le démarrage rapide, puis explorez la référence technique quand vous êtes prêt.
Table des matières
1. Premiers pas
1.1 Créer votre compte
- Rendez-vous sur la page d’inscription GeoTrack à /signup
- Choisissez votre forfait d’abonnement (Basic, Starter ou Professional)
- Saisissez votre adresse e-mail et créez un mot de passe sécurisé
- Cliquez sur “Créer un compte”
- Vous serez automatiquement connecté et redirigé vers votre tableau de bord
Remarque : tous les forfaits incluent un essai gratuit de 7 jours. Votre carte ne sera débitée qu’à la fin de l’essai.
1.2 Première connexion
Lors de votre première connexion, vous verrez :
- Votre tableau de bord avec des statistiques rapides (actuellement à zéro)
- Le menu de navigation à gauche avec les fonctionnalités disponibles
- Un message de bienvenue vous invitant à créer votre premier QR code
1.3 Comprendre les limites de votre forfait
Forfait Basic (4,99 $/mois)
- 20 QR codes
- 5 000 scans par mois
- 1 membre d’équipe
- 7 jours de conservation des données
- Assistance par e-mail (réponse sous 48 h)
Forfait Starter (14,99 $/mois)
- 100 QR codes
- 25 000 scans par mois
- 2 membres d’équipe
- 30 jours de conservation des données
- Assistance prioritaire par e-mail (24 h)
Forfait Professional (44,99 $/mois)
- 500 QR codes
- 250 000 scans par mois
- 10 membres d’équipe
- 90 jours de conservation des données
- Assistance prioritaire + accès API
2. Aperçu du tableau de bord
2.1 Composants du tableau de bord
Votre tableau de bord affiche :
Indicateurs clés :
• Total des QR codes : nombre de QR codes que vous avez créés
• Total des scans : nombre total de scans, tous QR codes confondus
• Géofences actives : nombre de géofences actuellement actives
• Scans du mois : scans enregistrés durant le mois calendaire en cours
3. Créer des QR codes
3.1 QR code standard
Objectif : un QR code simple qui redirige vers une seule URL.
Étapes :
- Allez dans “QR Codes” dans le menu de navigation
- Cliquez sur “Créer un nouveau QR code”
- Sélectionnez “Standard” comme type
- Saisissez un nom pour votre QR code (par ex. “Brochure produit”)
- Saisissez l’URL de destination
- Cliquez sur “Créer le QR code”
Cas d’usage :
- Pages d’informations produit
- Inscription à un événement
- Coordonnées de contact
- Profils de réseaux sociaux
3.2 QR code avec géofence
Objectif : rediriger les utilisateurs vers différentes URL selon leur position physique.
Étapes :
- Allez dans “QR Codes” → “Créer un nouveau QR code”
- Sélectionnez “Géofence” comme type
- Saisissez un nom pour votre QR code
- Saisissez l’URL par défaut (utilisée lorsque l’utilisateur est en dehors de toutes les géofences)
- Cliquez sur “Créer le QR code”
- Allez dans le menu “Géofences” et cliquez sur “Créer une géofence”
- Sélectionnez votre QR code, définissez le lieu et le rayon
- Saisissez l’URL de redirection pour ce lieu
Cas d’usage :
- Enseignes de détail multi-sites
- Diffusion de contenu régional
- Offres spécifiques à un lieu
- Navigation sur un lieu d’événement
3.3 QR code multi-sites
Objectif : rediriger automatiquement les utilisateurs vers le lieu le plus proche parmi une liste prédéfinie.
Fonctionnement :
- L’utilisateur scanne le QR code
- Le système détecte les coordonnées GPS de l’utilisateur
- Calcule la distance jusqu’à tous les lieux
- Redirige vers le plus proche
Cas d’usage :
- Réseaux de franchise
- Chaînes de restaurants
- Prestataires de services avec plusieurs bureaux
- Localisateurs de points de vente
3.4 Ajouter des règles horaires
Vous pouvez ajouter un routage horaire à n’importe quel QR code pour rediriger les utilisateurs selon le moment où ils scannent.
Configuration :
- Jours de la semaine : sélectionnez les jours où cette règle s’applique
- Plage horaire : définissez les heures de début et de fin (format 24 heures)
- Plage de dates : plage de dates spécifique facultative
- Priorité : les nombres les plus élevés l’emportent
- URL de destination : vers où rediriger durant cette période
Exemples :
- Menus de restaurant (petit-déjeuner, déjeuner, dîner)
- Informations en heures d’ouverture vs hors horaires
- Contenu saisonnier
- Redirections spécifiques à un événement
3.5 Définir des limites de scans
Créez de la rareté et un sentiment d’urgence avec des limites de scans.
Cas d’usage :
- Offres à durée limitée (“Les 100 premiers clients bénéficient de 20 % de réduction”)
- Codes d’accès exclusifs
- Gestion de la capacité d’un événement
- Campagnes promotionnelles
4. Gérer les géofences
4.1 Créer une géofence
- Allez dans “Géofences” dans la navigation
- Cliquez sur “Créer une géofence”
- Sélectionnez le QR code à géofencer
- Saisissez les informations de lieu (adresse ou coordonnées)
- Définissez le rayon en mètres (par défaut : 100 m)
- Saisissez l’URL de redirection pour cette géofence
- Cliquez sur “Créer une géofence”
4.2 Bonnes pratiques pour les géofences
Choix du rayon :
- Zones urbaines : 50-100 mètres (précision GPS élevée)
- Zones périurbaines : 100-300 mètres (précision modérée)
- Zones rurales : 300-1000 mètres (précision GPS plus faible)
Géofences qui se chevauchent :
- Lorsque des géofences se chevauchent, le système utilise le point central le plus proche
- Utilisez les réglages de priorité pour contrôler le comportement
- Testez soigneusement dans les zones où les géofences se chevauchent
5. Analytique et rapports
5.1 Tableau de bord analytique
Indicateurs généraux :
- Total des scans (depuis le début)
- Scans uniques
- Scans ce mois-ci
- Pourcentage de croissance des scans
Graphiques et diagrammes :
- Chronologie des scans (jour/semaine/mois)
- Répartition géographique
- Répartition par appareil (mobile vs ordinateur)
- Statistiques par navigateur
5.2 Carte des scans
La carte interactive affiche :
- Un marqueur pour chaque lieu de scan
- Des marqueurs groupés lorsque plusieurs scans sont proches
- Cliquez sur les marqueurs pour voir les détails du scan
- Zoomez et déplacez-vous pour explorer les régions
5.3 Exporter les données
Étapes :
- Allez sur la page Analytique
- Définissez les filtres souhaités
- Cliquez sur “Exporter les données”
- Choisissez le format (CSV)
- Téléchargez le fichier
Les données exportées incluent :
- Horodatage, nom du QR code, lieu
- Type d’appareil, navigateur, système d’exploitation
- Chaîne user agent
6. Gestion d’équipe
6.1 Rôles de l’équipe
Admin
• Accès complet à toutes les fonctionnalités
• Inviter/retirer des membres de l’équipe
• Gérer la facturation
• Consulter toutes les analyses
• Accéder aux paramètres
Manager
• Créer/gérer des QR codes
• Créer/gérer des géofences
• Consulter toutes les analyses
• Ne peut pas gérer l’équipe
• Ne peut pas accéder à la facturation
Field User
• Créer des QR codes
• Consulter uniquement ses propres QR codes
• Accès limité aux analyses
• Ne peut pas gérer les géofences
• Ne peut pas accéder à la facturation
6.2 Inviter des membres de l’équipe
- Allez dans “Équipe” dans la navigation (vous devez être Admin)
- Cliquez sur “Inviter un membre”
- Saisissez son adresse e-mail
- Sélectionnez son rôle (Admin, Manager ou Field User)
- Cliquez sur “Envoyer l’invitation”
- L’invité reçoit un e-mail avec un lien d’acceptation
Remarque : vous ne pouvez inviter qu’autant de membres que votre forfait le permet (Basic : 1, Starter : 2, Professional : 10)
7. Abonnement et facturation
7.1 Consulter le statut de l’abonnement
Indicateurs de statut :
- Actif : l’abonnement est à jour et actif
- Essai : dans la période d’essai de 7 jours
- En retard : le paiement a échoué, nouvelle tentative en cours
- Annulé : annulé mais toujours actif jusqu’à la fin de la période
- Expiré : l’abonnement a pris fin
7.2 Passer à un forfait supérieur
- Allez sur la page “Tarifs” ou le tableau de bord
- Cliquez sur “Mettre à niveau” sur le forfait souhaité
- Passez en revue les fonctionnalités et limites du nouveau forfait
- Confirmez la mise à niveau
- Un montant au prorata est appliqué immédiatement
- Les nouvelles limites sont actives immédiatement
8. Fonctionnalités avancées
8.1 Combiner géofences et règles horaires
Exemple de cas d’usage : chaîne de restaurants
- Créez un QR code multi-sites
- Ajoutez des géofences pour chaque restaurant
- Ajoutez des règles horaires pour les menus (petit-déjeuner, déjeuner, dîner)
Système de priorité :
- Correspondance géofence + règle horaire = priorité maximale
- Correspondance géofence uniquement = priorité moyenne
- Correspondance règle horaire uniquement = priorité faible
- Aucune correspondance = URL par défaut
8.2 Paramètres d’URL dynamiques
Transmettez des informations sur le scan à votre URL de destination :
Paramètres disponibles :
{scan_id}– Identifiant unique du scan{qr_code_id}– Identifiant du QR code{timestamp}– Horodatage Unix{lat}– Latitude{lng}– Longitude
https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}9. Dépannage
9.1 Le QR code ne se scanne pas
Causes possibles :
- Qualité d’image du QR code trop faible
- Mauvaises conditions d’éclairage
- Problèmes de mise au point de l’appareil photo
- QR code trop petit ou trop grand
Solutions :
- Téléchargez un QR code en plus haute résolution (300×300 ou 500×500)
- Assurez un bon contraste (foncé sur fond clair)
- Conservez une taille minimale de 2 cm x 2 cm pour l’impression
9.2 Mauvaise localisation détectée
Causes :
- GPS désactivé sur l’appareil
- Lieu en intérieur (signaux GPS faibles)
- Faible précision GPS de l’appareil
- L’utilisateur a refusé l’autorisation de localisation
Solutions :
- Demandez aux utilisateurs d’activer les services de localisation
- Augmentez le rayon de la géofence pour un usage en intérieur
- Prévoyez une URL de repli en cas d’échec de localisation
9.3 La géofence ne fonctionne pas
Liste de vérification :
- La géofence est-elle active ? (Vérifiez le statut dans le tableau de bord)
- Le type de QR code est-il défini sur “Géofence” ?
- Le rayon est-il adapté à la zone ?
- Avez-vous testé sur un appareil avec la localisation activée ?
- Les coordonnées sont-elles correctes ? (Vérifiez sur la carte)
10. Bonnes pratiques
10.1 Conception du QR code
✓ À faire :
- Utilisez un fort contraste (noir sur blanc est idéal)
- Laissez un espace blanc autour du code (zone de silence)
- Testez avant toute impression en masse
- Ajoutez un texte d’appel à l’action clair
✗ À éviter :
- Utiliser des couleurs qui réduisent le contraste
- Faire un QR code trop petit (min 2 cm x 2 cm)
- Le placer sur des surfaces courbes
- Utiliser des images en basse résolution
10.2 Stratégie de géofencing
Planification :
- Cartographiez d’abord tous les lieux
- Déterminez le rayon approprié pour chacun
- Tenez compte de la précision GPS dans chaque zone
- Testez les scénarios de chevauchement
Optimisation :
- Commencez par des rayons plus larges, puis affinez après les tests
- Utilisez les analyses pour vérifier la précision des géofences
- Ajustez en fonction des données de scan réelles
10.3 Sécurité et confidentialité
Protéger votre compte :
- Utilisez un mot de passe fort et unique
- Activez l’authentification à deux facteurs (bientôt disponible)
- Ne partagez pas vos identifiants de connexion
- Contrôlez régulièrement les accès des membres de l’équipe
Confidentialité des utilisateurs :
- Ne collectez que les données de localisation nécessaires
- Respectez le RGPD et les réglementations sur la vie privée
- Sécurisez les URL de destination avec HTTPS