Statistik

Endpoint Statistics menyediakan analitik mendalam tentang aplikasi dan organisasi Anda. Anda dapat melacak Monthly Active Users (MAU), penggunaan storage, dan konsumsi bandwidth dalam berbagai periode waktu. Data ini sangat penting untuk memantau pertumbuhan aplikasi, penggunaan resource, dan perencanaan kapasitas.

Understanding the Metrics

• MAU (Monthly Active Users): Jumlah perangkat unik yang mengakses aplikasi Anda dalam 30 hari terakhir
• Penyimpanan: Total ukuran semua bundle dan resource yang tersimpan dalam satuan byte
• Bandwidth: Total transfer data untuk download bundle dalam satuan byte

Praktik Terbaik

1. Monitoring Rutin: Cek statistik secara berkala untuk melacak pertumbuhan dan pola penggunaan
2. Perencanaan Resource: Gunakan metrik storage dan bandwidth untuk perencanaan kapasitas
3. Keterlibatan Pengguna: Pantau MAU untuk memahami tren engagement pengguna
4. Manajemen Biaya: Pantau penggunaan resource untuk optimasi biaya

Endpoint

GET /statistics/app/:app_id/

Dapatkan statistik untuk aplikasi tertentu. Endpoint ini berguna untuk memantau performa aplikasi secara individual.

Parameter Query

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 Request

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

Contoh Response

[
  {
    "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 /statistics/org/:org_id/

Dapatkan statistik untuk organisasi tertentu. Berguna untuk memantau penggunaan di level organisasi.

Parameter Query

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 Request

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 Response

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

GET /statistics/user/

Dapatkan statistik agregat dari semua organisasi yang Anda akses. Cocok untuk memantau penggunaan secara keseluruhan.

Parameter Query

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 Request

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

Contoh Response

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

GET /statistics/app/:app_id/bundle_usage

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

Parameter Query

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 Request

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 Response

{
  "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 error

Semua error menggunakan format error standar yang dijelaskan di Ikhtisar API.

Skenario error umum dan responsnya:

// The API key cannot read this app (HTTP 401)
{
  "error": "no_access_to_app",
  "message": "No access to app",
  "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}

// The API key cannot read this organization (HTTP 401)
{
  "error": "no_access_to_organization",
  "message": "No access to organization",
  "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}

// Organization statistics require an active plan (HTTP 402)
{
  "error": "subscription_required",
  "message": "Organization subscription required or plan invalid",
  "moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8", "isPayingAndGoodPlan": false }
}

// User statistics when the user belongs to no organization (HTTP 401)
{
  "error": "no_organizations_found",
  "message": "No organizations found",
  "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}

Kasus Penggunaan Umum

1. Pelacakan Pertumbuhan: Pantau pertumbuhan MAU dari waktu ke waktu
2. Optimasi Sumber Daya: Pantau penggunaan storage dan bandwidth untuk optimasi biaya
3. Perencanaan Kapasitas: Gunakan tren untuk merencanakan kebutuhan sumber daya mendatang
4. Laporan Penggunaan: Buat laporan penggunaan berkala untuk stakeholder
5. Analisis Distribusi Bundle (versi): Pahami distribusi pengguna di berbagai bundle app (versi) dengan statistik penggunaan bundle

Tips Analisis

1. Bandingkan Periode: Lihat tren month-over-month atau year-over-year
2. Pantau Rasio: Monitor bandwidth per user atau storage per app
3. Atur Alert: Buat alert untuk lonjakan penggunaan yang tidak wajar
4. Backup Rutin: Ekspor statistik secara berkala untuk analisis historis
5. Adopsi Bundle (versi): Gunakan penggunaan bundle untuk melacak tingkat adopsi bundle (versi) baru

Lanjutkan dari Statistik

Jika Anda menggunakan Statistik untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kapabilitas native di Menggunakan @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file, Menggunakan @capgo/capacitor-file untuk kemampuan native di Menggunakan @capgo/capacitor-file, dan @capgo/capacitor-uploader untuk detail implementasi di @capgo/capacitor-uploader.