Firebase Analytics Capacitor 플러그인

@capgo/capacitor-firebase-analytics 사용하기

Firebase Analytics용 Capacitor 플러그인

설치

bun add @capgo/capacitor-firebase-analytics
bunx cap sync

bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.

가져오기

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

API 한눈에 보기

메서드	설명
getAppInstanceId	앱 인스턴스 ID를 가져옵니다.
getSessionId	현재 세션 ID를 가져옵니다 (ga_session_id).
setConsent	사용자의 동의 모드를 설정합니다.
setUserId	사용자 ID 속성을 설정합니다.
setUserProperty	커스텀 사용자 속성을 지정된 값으로 설정합니다.
setCurrentScreen	현재 화면 이름을 설정합니다.
logEvent	앱 이벤트를 기록합니다.
setSessionTimeoutDuration	현재 세션을 종료하는 비활성 기간을 설정합니다.
setEnabled	자동 데이터 수집을 활성화하거나 비활성화합니다. 설정값은 앱을 다시 실행해야 적용됩니다.
isEnabled	자동 데이터 수집 활성화 여부를 반환합니다.
resetAnalyticsData	기기에서 이 앱의 모든 분석 데이터를 삭제합니다. 앱 인스턴스 ID가 초기화됩니다.
logTransaction	StoreKit 2 트랜잭션을 기록합니다.
initiateOnDeviceConversionMeasurementWithEmailAddress	이메일 주소를 사용하여 기기 내 전환 측정을 시작합니다.
initiateOnDeviceConversionMeasurementWithPhoneNumber	전화번호를 사용하여 기기 내 전환 측정을 시작합니다.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress	해시된 이메일 주소를 사용하여 기기 내 전환 측정을 시작합니다.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber	해시된 전화번호를 사용하여 기기 내 전환 측정을 시작합니다.

예시

getAppInstanceId()

앱 인스턴스 ID를 가져옵니다.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getAppInstanceId();
console.log(result);

getSessionId()

현재 세션 ID를 가져옵니다 (ga_session_id).

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getSessionId();
console.log(result);

setConsent()

사용자의 동의 모드를 설정합니다.

import { FirebaseAnalytics, ConsentStatus, ConsentType } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setConsent({
  type: ConsentType.AdPersonalization,
  status: ConsentStatus.Granted,
});

setUserId()

사용자 ID 속성을 설정합니다.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserId({ userId: 'user-id-123' });

setUserProperty()

커스텀 사용자 속성을 지정된 값으로 설정합니다.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserProperty({
  key: 'key-123',
  value: 'value',
});

setCurrentScreen()

현재 화면 이름을 설정합니다.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setCurrentScreen({ screenName: 'screen' });

위 표에는 16개의 핵심 메서드가 나와 있습니다. Listener와 버전 helper, 각 메서드의 전체 contract는 다음 문서에 설명되어 있습니다: GitHub 리포지토리.

전체 레퍼런스

• GitHub 리포지토리
• 문서
• API 레퍼런스

@capgo/capacitor-firebase-analytics 사용하기부터 계속하기

사용 중이라면 @capgo/capacitor-firebase-analytics 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우와, Capgo Native Build Capgo Native Builds의 제품 워크플로우를 위해.