본문으로 건너뛰기

분석 (Analytics)

Firebase Analytics를 통해 앱 내 사용자 행동 이벤트를 기록하는 모듈입니다.

개요​

appify.analytics는 Firebase Analytics에 커스텀 이벤트를 전송하는 기능을 제공합니다. 이벤트 이름과 함께 임의의 파라미터 객체를 첨부할 수 있어 세밀한 사용자 행동 분석이 가능합니다. Firebase 프로젝트 연동이 완료된 환경에서만 동작합니다.

API​

logEvent(eventName: string, params?: Record<string, unknown>): Promise<void>​

Firebase Analytics에 이벤트를 기록합니다.

매개변수

이름타입필수설명
eventNamestring예기록할 이벤트 이름
paramsRecord<string, unknown>아니오이벤트와 함께 전송할 파라미터 객체

반환값: Promise<void>

예제

import { appify } from '@nolraunsoft/appify-sdk';

// 단순 이벤트
await appify.analytics.logEvent('button_clicked');

// 파라미터가 포함된 이벤트
await appify.analytics.logEvent('item_purchased', {
  item_id: 'prod_123',
  item_name: 'Premium Plan',
  price: 9.99,
});

플랫폼별 참고사항​

  • Firebase Analytics SDK가 앱에 포함되어 있어야 합니다.
  • 이벤트 이름은 영문 소문자, 숫자, 언더스코어(_)만 사용하며 최대 40자로 제한됩니다.
  • Firebase 예약 이벤트 이름(app_open, session_start 등)은 사용할 수 없습니다.

관련 문서​