Statistik

Endpoint Statistik menyediakan analisis rinci tentang aplikasi dan organisasi Anda. Anda dapat mengikuti Pengguna Aktif Bulanan (MAU), penggunaan penyimpanan, dan konsumsi bandwidth di berbagai periode waktu. Data ini sangat penting untuk memantau pertumbuhan aplikasi, penggunaan sumber daya, dan merencanakan kapasitas.

Paham Mengenai Metrik

• MAU (Pengguna Aktif Bulanan): Jumlah perangkat unik yang mengakses aplikasi Anda dalam 30 hari terakhir
• Penyimpanan: Ukuran total semua bundle dan sumber daya yang disimpan dalam byte
• Bandwith: Total transfer data untuk download bundle dalam byte

Praktik Terbaik

1. Pemantauan Teratur: Periksa statistik secara berkala untuk mengikuti pertumbuhan dan pola penggunaan
2. Perencanaan Sumber Daya: Gunakan metrik penyimpanan dan bandwidth untuk perencanaan kapasitas
3. Partisipasi Pengguna: Ikuti MAU untuk memahami tren partisipasi pengguna
4. Pengelolaan Biaya: Pantau penggunaan sumber daya untuk mengoptimalkan biaya

Poin Akhir

GET /statistik/app/:app_id/

Dapatkan statistik untuk aplikasi tertentu. Endpoint ini berguna untuk memantau kinerja aplikasi individu.

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

GET /statistik/org/:org_id/

Peroleh statistik untuk organisasi tertentu. Bermanfaat untuk memantau penggunaan organisasi-level.

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

Judul Bagian berjudul “Contoh Respons”

Peroleh statistik agregat di semua organisasi yang Anda miliki akses ke. Cocok 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
  }
]

Judul Bagian “Contoh Respons”

Peroleh statistik penggunaan bundle untuk aplikasi tertentu, menampilkan distribusi bundle (versi) di antara pengguna selama periode tertentu.

Parameter Pencarian

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 Respons

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

Pengaturan Kesalahan

Skenario kesalahan umum dan responsnya:

// 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"
}

Penggunaan Umum

1. Pengukuran Pertumbuhan: Pantau pertumbuhan MAU secara berkelanjutan
2. Optimasi Sumber Daya: Pantau penggunaan penyimpanan dan bandwidth untuk mengoptimalkan biaya
3. Perencanaan Kapasitas: Gunakan tren untuk merencanakan kebutuhan sumber daya di masa depan
4. Laporan Penggunaan: Buat laporan penggunaan berkala untuk para stakeholder
5. Analisis Distribusi Paket (versi): Pahami bagaimana pengguna terdistribusi di berbagai paket aplikasi (versi) dengan statistik penggunaan paket

Tips untuk Analisis

1. Bandingkan Periode: Lihat tren bulan ke bulan atau tahun ke tahun
2. Ikuti Perbandingan: Pantau bandwidth per pengguna atau penyimpanan per aplikasi
3. Atur Peringatan: Buat peringatan untuk lonjakan tidak biasa dalam penggunaan
4. Backups Teratur: Ekspor statistik secara teratur untuk analisis sejarah
5. Penggunaan Paket (versi) : Gunakan penggunaan paket untuk mengikuti tingkat adopsi paket (versi) baru

Teruskan dari Statistik

Jika Anda menggunakan Statistik untuk merencanakan penyimpanan dan pengelolaan file, hubungkannya dengan @capgo/capacitor-penyimpanan-data-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan asli di Menggunakan @capgo/capacitor-data-storage-sqlite, /capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file, Menggunakan @capgo/capacitor-file untuk kemampuan asli di Menggunakan @capgo/capacitor-file, dan @capgo/capacitor-uploader untuk detail implementasi di @capgo/capacitor-uploader.