API Dokümantasyonu

Analitik

Analytics API

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

Tarama Trendleri

Günlük, haftalık veya aylık dağılımlarla zaman içinde taramaları takip edin

Coğrafi Veri

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

Referans Verileri

Kampanya atıfları için taramaların nereden geldiğini takip edin

Uç Noktalar

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

QR Kod Analitiği Al

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

GET

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

Sorgu Parametreleri

Parametre	Tür	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 Analitik

Analitik yanıtı, taramaların ülke ve şehir bazında ayrıntılı coğrafi dağılımını içerir. Bu veri, tarama isteklerinin IP coğrafi konumundan türetilmiştir.

Mevcut Coğrafi Veri

• Ülke: ISO ülke kodu ve tarama sayısı
• Şehir: Ülke bağlamında şehir adı
• Yüzde: Taramaların göreli 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 türetilir ve yaklaşık şehir düzeyinde doğruluk sağlar.

Analitik Dışa Aktar

Analitik verileri daha fazla analiz için CSV olarak dışa aktarın.

GET

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

CSV'ye Dışa 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ş analitik verileri 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: