Dokumentasi API

Analitik

API Analitik

Lacak dan analisis kinerja kode QR dengan data pemindaian terperinci, informasi geografis, rincian perangkat, dan analisis tren.

Tren Pemindaian

Lacak pemindaian dari waktu ke waktu dengan rincian harian, mingguan, atau bulanan

Data Geografis

Lihat di mana kode QR Anda dipindai berdasarkan negara dan kota

Info Perangkat

Pahami jenis perangkat, sistem operasi, dan browser

Data Pengarah

Lacak dari mana pemindaian berasal untuk atribusi kampanye

Endpoint

Metode	Endpoint	Deskripsi
GET	/organizations/:orgId/qr-codes/analytics	analitik seluruh organisasi
GET	/organizations/:orgId/qr-codes/:id/analytics	analitik kode QR tunggal
GET	/organizations/:orgId/qr-codes/:id/analytics/export	Ekspor analitik sebagai CSV
GET	/organizations/:orgId/qr-codes/:id/scans	Dapatkan catatan pemindaian individu

Dapatkan Analitik Kode QR

Ambil analitik komprehensif untuk kode QR tertentu.

GET

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

Parameter Kuery

Parameter	Tipe	Deskripsi
startDate	string	Tanggal mulai (format ISO 8601)
endDate	string	Tanggal akhir (format ISO 8601)
interval	string	Interval pengelompokan: hari, minggu, bulan

Contoh Permintaan

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"

Respons

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

Analitik Geografis

Respons analitik mencakup rincian geografis pemindaian berdasarkan negara dan kota. Data ini berasal dari geolokasi IP dari permintaan pemindaian.

Data Geografis yang Tersedia

• Negara: kode negara ISO dan jumlah pemindaian
• Kota: Nama kota dengan konteks negara
• Persentase: Distribusi relatif pemindaian
• Koordinat: Lat/lng perkiraan (jika tersedia)

Catatan Privasi: Kami tidak menyimpan lokasi pengguna yang tepat. Data geografis berasal dari alamat IP dan memberikan akurasi tingkat kota yang perkiraan.

Ekspor Analitik

Ekspor data analitik sebagai CSV untuk analisis lebih lanjut di spreadsheet atau alat BI.

GET

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

Ekspor ke 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

Kolom CSV

Kolom	Deskripsi
timestamp	Stempel waktu pemindaian (ISO 8601)
country	Kode negara
city	Nama kota
device_type	mobile, desktop, tablet
os	Sistem operasi
browser	Nama browser
is_unique	Pemindaian pertama kali (true/false)

Analitik Seluruh Organisasi

Dapatkan analitik agregat di semua kode QR di organisasi Anda.

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"

Langkah Selanjutnya

Pelajari tentang fitur terkait: