statistic

설치 단계와 이 플러그인에 대한 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하십시오.

앱 및 조직에 대한 세부적인 분석 정보를 제공하는 Statistics 엔드포인트입니다. 앱 성장, 리소스 사용 및 용량 계획을 위해 월 활성 사용자(MAU), 저장소 사용량 및 대역폭 소비를 다양한 시간 기간에 따라 추적할 수 있습니다.

메트릭 이해

월 활성 사용자(MAU): 최근 30일 동안 앱에 접근한 유니크한 장치의 수
저장소전체 크기 (byte)
대역폭전체 다운로드 크기 (byte)

최선의 방법

정기적인 모니터링통계를 주기적으로 확인하여 성장 및 사용 패턴을 추적하기
자원 계획저장소 및 대역폭 메트릭을 사용하여 용량 계획
사용자 참여MAU를 사용하여 사용자 참여 동향을 이해하기
비용 관리: 리소스 사용량을 모니터링하여 비용을 최적화하세요.

엔드포인트

GET /statistics/app/:app_id/

특정 앱의 성능을 모니터링하기 위한 이 엔드포인트는 앱별 성능을 확인하는 데 유용합니다.

쿼리 매개변수

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

예제 요청

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

__CAPGO_KEEP_1__

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

__CAPGO_KEEP_3__

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

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
}

__CAPGO_KEEP_7__

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"

예시 응답

[
  {
    "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/

사용자에게 전체적인 사용량을 모니터링하기 위해 모든 조직에 대한 집계 통계를 가져옵니다.

쿼리 매개변수

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

예시 요청

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

Example 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

특정 앱의 버전 배포 통계를 얻기 위해 버전 배포 통계를 얻습니다.

Query Parameters

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

예시 요청

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"

예시 응답

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

오류 처리

일반 오류 상황과 그에 대한 응답:

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

일반적인 사용 사례

성장 추적: 시간에 따른 MAU 성장 모니터링
리소스 최적화: 저장소 및 대역폭 사용량을 최적화하는 데 사용되는 트래킹
용량 계획: 미래 리소스 요구를 계획하기 위한 트렌드 사용
사용량 보고서: 이해관계자에게 주기적인 사용량 보고서 생성
버전별 분포 분석: 버전별 앱 버전 분포에 대한 사용자 통계를 이해하기 위한 버전 분포 분석

분석 팁

비교 기간월간 또는 연간 추세를 살펴보세요
비율 추적사용자당 대역폭 또는 앱당 저장 공간을 모니터링하세요
경고 설정이상적인 사용량 급증에 대한 경고를 설정하세요
정기 백업역사 분석을 위해 통계를 정기적으로 내보내세요
버전 배포버전 배포를 통해 새로운 버전의 채택률을 추적하세요

통계에서 계속 진행하세요

Capgo를 사용 중이라면 Statistics 저장 및 파일 처리를 계획하고 싶다면 @capgo/capacitor-data-storage-sqlite Capgo에서 @capgo/capacitor-data-storage-sqlite Capgo에서 @capgo/capacitor-data-storage-sqlite Capgo에서 @capgo/capacitor-file Capgo에서 @capgo/capacitor-file Capgo에서 @capgo/capacitor-file Capgo에서 @capgo/capacitor-file Capgo에서 @capgo/capacitor-file @capgo/capacitor-업로더 capgo/capacitor-업로더 구현 세부 사항에 대한 자세한 내용은 여기서 확인할 수 있습니다.