Analitik API

QR kodu performansını detaylı tarama verileri, coğrafi bilgiler, cihaz dağılımları ve trend analizi ile takip edin ve analiz edin.

Tarama Trendleri

Zaman içinde günlük, haftalık veya aylık dökümlerle taramaları takip edin

Coğrafi Veriler

QR kodlarınızın hangi ülke ve şehirde tarandığını görün

Cihaz Bilgisi

Cihaz türlerini, işletim sistemlerini ve tarayıcıları anlayın

Yönlendiren Verileri

Kampanya atıfı için taramaların nereden geldiğini takip et

Uç Noktaları

Yöntem	Uç Noktası	Açıklama
GET	/organizations/:orgId/qr-codes/analytics	Kuruluş genelinde analizler
GET	/organizations/:orgId/qr-codes/:id/analytics	Tek QR kodu analitiği
GET	/organizations/:orgId/qr-codes/:id/analytics/export	Analitikleri CSV olarak dışa aktar
GET	/organizations/:orgId/qr-codes/:id/scans	Bireysel tarama kayıtlarını al

QR Kod Analitiği Alın

Belirli bir QR kodu için kapsamlı analizleri alın.

GET

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

Sorgu Parametreleri

Parametre	Yazın	Açıklama
startDate	string	Başlangıç tarihi (ISO 8601 formatı)
endDate	string	Bitiş tarihi (ISO 8601 formatı)
interval	string	Gruplama aralığı: gün, hafta, ay

Örnek İstek

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"

Yanıt

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

Coğrafi Analitikler

Analitik yanıt, taramaların ülke ve şehir bazında detaylı coğrafi dağılımını içerir. Bu veriler, tarama isteklerinin IP coğrafi konumlandırmasından elde edilmiştir.

Mevcut Coğrafi Veriler

• Ülke: ISO ülke kodu ve tarama sayısı
• Şehir: Ülke bağlamında şehir adı
• Yüzde: Tarama dağılımının göreceli dağılımı
• Koordinatlar: Yaklaşık enlem/boylam (mevcut olduğunda)

Gizlilik Notu: Kesin kullanıcı konumlarını saklamıyoruz. Coğrafi veriler IP adreslerinden elde edilir ve yaklaşık şehir düzeyinde doğruluk sağlar.

Analitikleri Dışa Aktar

Veri analizi için CSV formatında dışa aktarın, böylece elektronik tablolar veya BI araçlarında daha fazla analiz yapabilirsiniz.

GET

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

CSV'ye Aktar

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 Sütunları

Sütun	Açıklama
timestamp	Tarama zaman damgası (ISO 8601)
country	Ülke kodu
city	Şehir adı
device_type	mobil, masaüstü, tablet
os	İşletim sistemi
browser	Tarayıcı adı
is_unique	İlk kez tarama (doğru/yanlış)

Kuruluş Genelinde Analitik

Kuruluşunuzdaki tüm QR kodları için birleştirilmiş analizler alın.

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"

Sonraki Adımlar

İlgili özellikler hakkında bilgi edinin: