로그 이벤트

iOS+ 안드로이드 웹 플러터

이 가이드는 앱에서 이벤트를 기록하는 방법을 보여줍니다.

이벤트 는 사용자 작업, 시스템 이벤트 또는 오류와 같이 앱에서 발생하는 상황에 대한 통찰력을 제공합니다.

Analytics는 일부 이벤트 를 자동으로 기록합니다. 수신하기 위해 코드를 추가할 필요가 없습니다. 앱에서 추가 데이터를 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 분석 이벤트 유형 을 기록할 수 있습니다. 앱이 기록하는 총 이벤트 양에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분하며 대소문자만 다른 이름의 두 이벤트를 기록하면 두 개의 개별 이벤트가 생성됩니다.

시작하기 전에

Analytics 시작하기 에 설명된 대로 프로젝트를 설정하고 Analytics에 액세스할 수 있는지 확인하십시오.

로그 이벤트

FirebaseAnalytics 인스턴스를 생성한 후 이를 사용하여 logEvent() 메서드로 이벤트를 기록할 수 있습니다.

시작하는 데 도움이 되도록 애널리틱스 SDK는 소매 및 전자상거래, 여행, 게임 앱을 포함하여 다양한 유형의 앱 간에 공통적인 여러 추천 이벤트를 정의합니다. 이러한 이벤트 및 사용 시기에 대한 자세한 내용은 권장 이벤트 를 참조하십시오.

다음 위치에서 권장 이벤트 유형에 대한 구현 세부 정보를 찾을 수 있습니다.

• 권장 이벤트: com.google.firebase.analytics.FirebaseAnalytics.Event 클래스 참조를 확인하세요.
• 사전 매개변수: com.google.firebase.analytics.FirebaseAnalytics.Param 참조를 확인하세요.

다음 예는 SELECT_CONTENT 이벤트를 기록하는 방법을 보여줍니다.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

규정된 매개변수 외에도 모든 이벤트에 다음 매개변수를 추가할 수 있습니다.

• 맞춤 매개변수: 맞춤 매개변수는 애널리틱스 보고서 에서 측정기준 또는 측정항목 으로 사용할 수 있습니다. 숫자가 아닌 이벤트 매개변수 데이터에 맞춤 측정기준을 사용하고 숫자로 더 잘 표현되는 모든 매개변수 데이터에 맞춤 측정항목을 사용할 수 있습니다. SDK를 사용하여 맞춤 매개변수를 기록한 후에는 해당 맞춤 매개변수가 애널리틱스 보고서에 표시되도록 측정기준 또는 측정항목을 등록하세요. Analytics > 이벤트 > 맞춤 정의 관리 > 맞춤 측정기준 만들기 를 통해 이를 수행합니다.

  맞춤 매개변수는 모든 보고서에 적용될 수 있는 잠재고객 정의에 사용할 수 있습니다. 앱이 BigQuery 프로젝트에 연결된 경우 맞춤 매개변수는 BigQuery로 내보낸 데이터에도 포함됩니다. Google 애널리틱스 4 BigQuery Export 에서 샘플 검색어 등을 찾아보세요.

• VALUE 매개변수: VALUE 는 이벤트와 관련된 주요 측정항목을 누적하는 데 유용한 범용 매개변수입니다. 예를 들면 수익, 거리, 시간 및 포인트가 있습니다.

응용 프로그램에 권장 이벤트 유형이 적용되지 않는 특정 요구 사항이 있는 경우 다음 예제와 같이 고유한 사용자 지정 이벤트를 기록할 수 있습니다.

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

기본 이벤트 매개변수 설정

setDefaultEventParameters 를 사용하여 이벤트 전체에서 매개변수를 기록할 수 있습니다. 기본 매개변수는 기록되는 모든 향후 이벤트와 연결됩니다.

맞춤 매개변수와 마찬가지로 기본 이벤트 매개변수를 등록하여 애널리틱스 보고서에 표시되도록 합니다.

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

매개 변수가 logEvent() 메서드에 지정된 경우 기본값 대신 해당 값이 사용됩니다.

기본 매개변수를 지우려면 매개변수를 null 로 설정하여 setDefaultEventParameters 메소드를 호출하십시오.

Android Studio 디버그 로그에서 이벤트 보기

이벤트가 제대로 기록되고 있는지 확인하는 데 도움이 되도록 자세한 정보 로깅을 활성화하여 SDK의 이벤트 로깅을 모니터링할 수 있습니다. 여기에는 자동 및 수동으로 기록된 이벤트가 모두 포함됩니다.

일련의 adb 명령을 사용하여 상세 로깅을 활성화할 수 있습니다.

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

이 명령어는 Android Studio logcat에 이벤트를 표시하여 이벤트가 전송되고 있는지 즉시 확인할 수 있도록 도와줍니다.

대시보드에서 이벤트 보기

Firebase 콘솔 대시보드에서 이벤트에 대한 집계된 통계를 볼 수 있습니다. 이 대시보드는 하루 종일 주기적으로 업데이트됩니다. 즉각적인 테스트를 위해 이전 섹션에서 설명한 대로 logcat 출력을 사용합니다.

Firebase 콘솔의 이벤트 대시보드에서 이 데이터에 액세스할 수 있습니다. 이 대시보드는 앱에서 기록된 각각의 고유한 이벤트 유형에 대해 자동으로 생성된 이벤트 보고서를 보여줍니다.