Statistik

Titik akhir Statistik memberikan analisis mendetail tentang aplikasi dan organisasi Anda. Anda dapat melacak Pengguna Aktif Bulanan (MAU), penggunaan penyimpanan, dan konsumsi bandwidth dalam periode waktu yang berbeda. Data ini penting untuk memantau pertumbuhan aplikasi, penggunaan sumber daya, dan kapasitas perencanaan.

Memahami Metrik

MAU (Pengguna Aktif Bulanan): Jumlah perangkat unik yang mengakses aplikasi Anda dalam 30 hari terakhir
Penyimpanan: Ukuran total semua paket dan sumber daya yang disimpan dalam byte
Bandwidth: Total transfer data untuk unduhan bundel dalam byte

Praktik Terbaik

Pemantauan Reguler: Periksa statistik secara berkala untuk melacak pertumbuhan dan pola penggunaan
Perencanaan Sumber Daya: Gunakan metrik penyimpanan dan bandwidth untuk perencanaan kapasitas
Keterlibatan Pengguna: Lacak MAU untuk memahami tren keterlibatan pengguna
Manajemen Biaya: Pantau penggunaan sumber daya untuk mengoptimalkan biaya

Titik akhir

DAPATKAN /statistik/aplikasi/:app_id/

Dapatkan statistik untuk aplikasi tertentu. Titik akhir ini berguna untuk memantau kinerja aplikasi individual.

Parameter Kueri

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Contoh Permintaan

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"

Contoh Respon

[
  {
    "date": "2024-01-01",
    "mau": 1500,
    "storage": 536870912,  // 512MB in bytes
    "bandwidth": 1073741824 // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 1550,
    "storage": 537919488,  // 513MB in bytes
    "bandwidth": 1074790400 // 1.01GB in bytes
  }
]

DAPATKAN /statistics/org/:org_id/

Dapatkan statistik untuk organisasi tertentu. Berguna untuk memantau penggunaan tingkat organisasi.

Parameter Kueri

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
  breakdown: boolean  // default false, optional if true it return the breakdown by app
  noAccumulate: boolean // default false, optional if true it will not accumulate data and just return day by day result
}

Contoh Permintaan

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/org/046a36ac-e03c-4590-9257-bd6c9dba9ee8/?from=2024-01-01&to=2024-02-01"

Contoh Respon

[
  {
    "date": "2024-01-01",
    "mau": 10000,
    "storage": 536870912,   // 512MB in bytes
    "bandwidth": 1073741824  // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 10200,
    "storage": 537919488,   // 513MB in bytes
    "bandwidth": 1074790400  // 1.01GB in bytes
  }
]

DAPATKAN /statistik/pengguna/

Dapatkan statistik gabungan di seluruh organisasi yang dapat Anda akses. Sempurna untuk pemantauan penggunaan secara keseluruhan.

Parameter Kueri

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Contoh Permintaan

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"

Contoh Respon

[
  {
    "date": "2024-01-01",
    "mau": 25000,
    "storage": 1073741824,  // 1GB in bytes
    "bandwidth": 2147483648  // 2GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 25500,
    "storage": 1074790400,  // 1.01GB in bytes
    "bandwidth": 2148532224  // 2.01GB in bytes
  }
]

DAPATKAN /statistics/app/:app_id/bundle_usage

Dapatkan statistik penggunaan paket untuk aplikasi tertentu, yang menunjukkan distribusi paket (versi) di antara pengguna selama periode tertentu.

Parameter Kueri

interface BundleUsageQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Contoh Permintaan

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/bundle_usage?from=2024-01-01&to=2024-02-01"

Contoh Respon

{
  "labels": ["2024-01-01", "2024-01-02", "2024-01-03"],
  "datasets": [
    {
      "label": "1.0.0",
      "data": [60.5, 58.2, 55.3]
    },
    {
      "label": "1.0.1",
      "data": [39.5, 41.8, 44.7]
    }
  ]
}

Penanganan Kesalahan

Skenario kesalahan umum dan tanggapannya:

// Invalid body
{
  "status": "Invalid body",
  "error": "Invalid date format or missing parameters"
}

// Permission denied
{
  "status": "You can't access this app",
  "error": "Insufficient permissions to access statistics"
}

// Permission denied for organization
{
  "status": "You can't access this organization",
  "error": "Insufficient permissions to access organization statistics"
}

// No organizations found for user statistics
{
  "status": "No organizations found",
  "error": "No organizations found"
}

// Internal server error
{
  "status": "Cannot get app statistics",
  "error": "Internal server error message"
}

Kasus Penggunaan Umum

Pelacakan Pertumbuhan: Pantau pertumbuhan MAU dari waktu ke waktu
Pengoptimalan Sumber Daya: Melacak penyimpanan dan penggunaan bandwidth untuk mengoptimalkan biaya
Perencanaan Kapasitas: Gunakan tren untuk merencanakan kebutuhan sumber daya di masa depan
Laporan Penggunaan: Menghasilkan laporan penggunaan berkala untuk pemangku kepentingan
Analisis Distribusi Paket (versi): Memahami bagaimana pengguna didistribusikan ke berbagai paket aplikasi (versi) dengan statistik penggunaan paket

Tip untuk Analisis

Bandingkan Periode: Lihat tren dari bulan ke bulan atau tahun ke tahun
Rasio Lacak: Memantau bandwidth per pengguna atau penyimpanan per aplikasi
Atur Peringatan: Membuat peringatan untuk lonjakan penggunaan yang tidak biasa
Pencadangan Reguler: Ekspor statistik secara berkala untuk analisis historis
Adopsi Paket (versi): Gunakan penggunaan paket untuk melacak tingkat adopsi paket (versi) baru