API-Dokumentation

Analytik

Analytik API

Verfolgen und analysieren Sie die Leistung von QR-Codes mit detaillierten Scan-Daten, geografischen Informationen, Geräteaufteilungen und Trendanalysen.

Scan-Trends

Verfolgen Sie Scans über die Zeit mit täglichen, wöchentlichen oder monatlichen Aufteilungen

Geografische Daten

Sehen Sie, wo Ihre QR-Codes nach Land und Stadt gescannt werden

Geräteinformationen

Verstehen Sie Gerätetypen, Betriebssysteme und Browser

Referrer-Daten

Verfolgen Sie, woher die Scans für die Kampagnenzuordnung stammen

Endpunkte

Methode	Endpunkt	Beschreibung
GET	/organizations/:orgId/qr-codes/analytics	Organisationale Analytik
GET	/organizations/:orgId/qr-codes/:id/analytics	Einzelne QR-Code-Analytik
GET	/organizations/:orgId/qr-codes/:id/analytics/export	Analytik als CSV exportieren
GET	/organizations/:orgId/qr-codes/:id/scans	Individuelle Scan-Datensätze abrufen

QR-Code-Analytik abrufen

Umfassende Analytik für einen bestimmten QR-Code abrufen.

GET

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

Abfrageparameter

Parameter	Typ	Beschreibung
startDate	string	Startdatum (ISO 8601-Format)
endDate	string	Enddatum (ISO 8601-Format)
interval	string	Gruppierungsintervall: Tag, Woche, Monat

Beispielanfrage

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"

Antwort

{
  "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 }
    ]
  }
}

Geografische Analytik

Die Analytik-Antwort enthält eine detaillierte geografische Aufschlüsselung der Scans nach Land und Stadt. Diese Daten stammen aus der IP-Geolokalisierung der Scan-Anfragen.

Verfügbare geografische Daten

• Land: ISO-Ländercode und Scan-Anzahl
• Stadt: Stadtname mit Länder-Kontext
• Prozentsatz: Relative Verteilung der Scans
• Koordinaten: Ungefähre Breiten-/Längengrad (wenn verfügbar)

Datenschutz-Hinweis: Wir speichern keine genauen Benutzerstandorte. Geografische Daten stammen von IP-Adressen und bieten eine ungefähre Genauigkeit auf Stadtebene.

Analytik exportieren

Exportieren Sie Analytikdaten als CSV für weitere Analysen in Tabellenkalkulationen oder BI-Tools.

GET

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

In CSV exportieren

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

CSV-Spalten

Spalte	Beschreibung
timestamp	Scan-Zeitstempel (ISO 8601)
country	Ländercode
city	Stadtname
device_type	mobil, desktop, tablet
os	Betriebssystem
browser	Browsername
is_unique	Erster Scan (wahr/falsch)

Organisationale Analytik

Aggregierte Analytik über alle QR-Codes in Ihrer Organisation abrufen.

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"

Nächste Schritte

Erfahren Sie mehr über verwandte Funktionen: