시작하기
설치 명령어와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-firebase-analytics`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/firebase-analytics/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins그런 다음 다음 명령어를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-firebase-analytics` plugin in my project.만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-firebase-analyticsbunx cap syncImport
Import 섹션import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';API 개요
섹션: API 개요getAppInstanceId
섹션: getAppInstanceId앱 인스턴스 ID를 가져옵니다.
Only available for Android and iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getAppInstanceId();getSessionId
getSessionId현재 세션 ID를 가져옵니다 (ga_session_id).
Only available for Android and iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getSessionId();setConsent
setConsent사용자의 동의 모드를 설정합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setConsent({} as SetConsentOptions);setUserId
setUserId사용자 ID 속성을 설정합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserId({} as SetUserIdOptions);setUserProperty
Section titled “사용자 속성 설정”사용자 지정 속성을 지정된 값으로 설정합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserProperty({} as SetUserPropertyOptions);setCurrentScreen
Section titled “현재 화면 설정”현재 화면 이름을 설정합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setCurrentScreen({} as SetCurrentScreenOptions);logEvent
Section titled “앱 이벤트 로그”앱 이벤트를 로그합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.logEvent({} as LogEventOptions);setSessionTimeoutDuration
Section titled “세션 종료 시간 설정”현재 세션을 종료하는 무활동 시간을 설정합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setSessionTimeoutDuration({} as SetSessionTimeoutDurationOptions);setEnabled
setEnabled자동 데이터 수집을 활성/비활성화합니다. 앱이 다시 실행될 때까지 적용되지 않습니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setEnabled({} as SetEnabledOptions);isEnabled
isEnabled자동 데이터 수집이 활성화되어 있는지 여부를 반환합니다.
웹에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.isEnabled();resetAnalyticsData
resetAnalyticsData이 앱의 모든 분석 데이터를 기기에서 삭제하고 앱 인스턴스 ID를 초기화합니다.
안드로이드와 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.resetAnalyticsData();initiateOnDeviceConversionMeasurementWithEmailAddress
Section titled “이메일 주소로 장치 내 변환 측정 시작하기”이메일 주소로 장치 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({} as InitiateOnDeviceConversionMeasurementWithEmailAddressOptions);initiateOnDeviceConversionMeasurementWithPhoneNumber
Section titled “전화번호로 장치 내 변환 측정 시작하기”전화번호로 장치 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions);initiateOnDeviceConversionMeasurementWithHashedEmailAddress
Section titled “해시된 이메일 주소로 장치 내 변환 측정 시작하기”해시된 이메일 주소로 장치 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedEmailAddress({} as InitiateOnDeviceConversionMeasurementWithHashedEmailAddressOptions);initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
기능명 ‘initiateOnDeviceConversionMeasurementWithHashedPhoneNumber’해시된 전화번호와 함께 장치 내 변환 측정 시작
iOS만 지원
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithHashedPhoneNumberOptions);타입 참조
기능명 ‘Type Reference’GetAppInstanceIdResult
기능명 ‘GetAppInstanceIdResult’export interface GetAppInstanceIdResult { /** * The app instance id. * * Not defined if `FirebaseAnalytics.ConsentType.ANALYTICS_STORAGE` has been set to `FirebaseAnalytics.ConsentStatus.DENIED`. * * @since 1.4.0 */ appInstanceId?: string;}GetSessionIdResult
기능명 ‘GetSessionIdResult’export interface GetSessionIdResult { /** * The current session id. * * Matches Firebase Analytics `ga_session_id`. * * Not defined if `FirebaseAnalytics.ConsentType.ANALYTICS_STORAGE` has been set to `FirebaseAnalytics.ConsentStatus.DENIED`. * * @since 8.0.1 */ sessionId?: number;}SetConsentOptions
기능명 ‘SetConsentOptions’export interface SetConsentOptions { /** * The consent type. * * @since 6.0.0 */ type: ConsentType; /** * The consent status. * * @since 6.0.0 */ status: ConsentStatus;}SetUserIdOptions
사용자 ID 설정 옵션export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string | null;}SetUserPropertyOptions
사용자 속성 설정 옵션export interface SetUserPropertyOptions { /** * @since 0.1.0 */ key: string; /** * @since 0.1.0 */ value: string | null;}SetCurrentScreenOptions
현재 화면 설정 옵션export interface SetCurrentScreenOptions { /** * @since 0.1.0 */ screenName: string | null; /** * Only available for Android and iOS. * * @default null * @since 0.1.0 */ screenClassOverride?: string | null;}LogEventOptions
이벤트 로깅 옵션export interface LogEventOptions { /** * The event name. * * @since 0.1.0 */ name: string; /** * The optional event params. * * @since 0.1.0 */ params?: { [key: string]: any };}SetSessionTimeoutDurationOptions
세션 타임아웃 기간 설정 옵션export interface SetSessionTimeoutDurationOptions { /** * Duration in seconds. * * @default 1800 * @since 0.1.0 */ duration: number;}SetEnabledOptions
활성화 설정 옵션export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
IsEnabledResultexport interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}InitiateOnDeviceConversionMeasurementWithEmailAddressOptions
InitiateOnDeviceConversionMeasurementWithEmailAddressOptionsexport interface InitiateOnDeviceConversionMeasurementWithEmailAddressOptions { /** * The email address to initiate on-device conversion measurement with. * * @since 7.2.0 */ emailAddress: string;}InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions
InitiateOnDeviceConversionMeasurementWithPhoneNumberOptionsexport interface InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions { /** * The phone number to initiate on-device conversion measurement with. * * @since 7.2.0 */ phoneNumber: string;}실질적 진실
실질적 진실이 페이지는 플러그인의 src/definitions.ts. Re-run the sync when the public API changes upstream.
Getting Started에서 계속하기
Getting Started에서 계속하기이 기능을 사용 중이라면 시작하기 API를 계획하고 대시보드 및 API 작업을 계획하고 싶다면 API 개요 API 개요에서 구현 세부 정보를 확인하세요. 소개 소개에서 구현 세부 정보를 확인하세요. API 키 API 키에서 구현 세부 정보를 확인하세요. 장치 장치에서 구현 세부 정보를 확인하세요. 묶음 구현 세부 사항에 대한 Bundles.