Documentation API

Analytique

API Analytics

Suivez et analysez la performance des QR codes avec des données de scan détaillées, des informations géographiques, des répartitions par appareil et des analyses de tendance.

Tendances de scan

Suivez les scans au fil du temps avec des répartitions quotidiennes, hebdomadaires ou mensuelles

Données géographiques

Voyez où vos QR codes sont scannés par pays et par ville

Informations sur l'appareil

Comprenez les types d'appareils, les systèmes d'exploitation et les navigateurs

Données de référence

Suivez d'où proviennent les scans pour l'attribution des campagnes

Points de terminaison

Méthode	Point de terminaison	Description
GET	/organizations/:orgId/qr-codes/analytics	Analytique à l'échelle de l'organisation
GET	/organizations/:orgId/qr-codes/:id/analytics	Analytique d'un seul QR code
GET	/organizations/:orgId/qr-codes/:id/analytics/export	Exporter les analyses au format CSV
GET	/organizations/:orgId/qr-codes/:id/scans	Obtenir des enregistrements de scan individuels

Obtenir l'analytique du QR Code

Récupérer des analyses complètes pour un QR code spécifique.

GET

/organizations/:orgId/qr-codes/:id/analytics

Paramètres de requête

Paramètre	Type	Description
startDate	string	Date de début (format ISO 8601)
endDate	string	Date de fin (format ISO 8601)
interval	string	Intervalle de regroupement : jour, semaine, mois

Exemple de requête

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics?startDate=2024-01-01&endDate=2024-01-31&interval=day" \
  -H "X-API-Key: YOUR_API_KEY"

Réponse

{
  "qrCodeId": "qr_xyz789",
  "period": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-31T23:59:59Z"
  },
  "summary": {
    "totalScans": 1542,
    "uniqueScans": 1203,
    "avgDailyScans": 49.7
  },
  "timeline": [
    { "date": "2024-01-01", "scans": 45, "uniqueScans": 38 },
    { "date": "2024-01-02", "scans": 52, "uniqueScans": 41 },
    ...
  ],
  "geography": {
    "countries": [
      { "country": "US", "scans": 823, "percentage": 53.4 },
      { "country": "GB", "scans": 234, "percentage": 15.2 },
      { "country": "DE", "scans": 156, "percentage": 10.1 }
    ],
    "cities": [
      { "city": "New York", "country": "US", "scans": 234 },
      { "city": "London", "country": "GB", "scans": 189 },
      { "city": "Los Angeles", "country": "US", "scans": 145 }
    ]
  },
  "devices": {
    "types": [
      { "type": "mobile", "scans": 1234, "percentage": 80.0 },
      { "type": "desktop", "scans": 231, "percentage": 15.0 },
      { "type": "tablet", "scans": 77, "percentage": 5.0 }
    ],
    "os": [
      { "os": "iOS", "scans": 687, "percentage": 44.6 },
      { "os": "Android", "scans": 547, "percentage": 35.5 },
      { "os": "Windows", "scans": 189, "percentage": 12.3 }
    ],
    "browsers": [
      { "browser": "Safari", "scans": 654, "percentage": 42.4 },
      { "browser": "Chrome", "scans": 521, "percentage": 33.8 },
      { "browser": "Firefox", "scans": 156, "percentage": 10.1 }
    ]
  }
}

Analytique géographique

La réponse analytique inclut une répartition géographique détaillée des scans par pays et par ville. Ces données proviennent de la géolocalisation IP des demandes de scan.

Données géographiques disponibles

• Pays : code pays ISO et nombre de scans
• Ville : nom de la ville avec contexte de pays
• Pourcentage : distribution relative des scans
• Coordonnées : latitude/longitude approximatives (lorsqu'elles sont disponibles)

Note de confidentialité : Nous ne stockons pas les emplacements exacts des utilisateurs. Les données géographiques proviennent des adresses IP et fournissent une précision approximative au niveau de la ville.

Exporter les analyses

Exporter les données analytiques au format CSV pour une analyse plus approfondie dans des tableurs ou des outils BI.

GET

/organizations/:orgId/qr-codes/:id/analytics/export

Exporter au format CSV

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/qr_xyz789/analytics/export?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o analytics.csv

Colonnes CSV

Colonne	Description
timestamp	Horodatage du scan (ISO 8601)
country	Code pays
city	Nom de la ville
device_type	mobile, bureau, tablette
os	Système d'exploitation
browser	Nom du navigateur
is_unique	Scan de première fois (vrai/faux)

Analytique à l'échelle de l'organisation

Obtenez des analyses agrégées sur tous les QR codes de votre organisation.

GET

/organizations/:orgId/qr-codes/analytics

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/analytics?startDate=2024-01-01&endDate=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY"

Prochaines étapes

Découvrez des fonctionnalités connexes :