Getting Started
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.
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.
설치
설치 제목Capacitor 플러그인 설치를 위해 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’인 섹션앱 인스턴스 아이디를 가져온다.
안드로이드와 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getAppInstanceId();getSessionId
getSessionId현재 세션 ID를 가져옵니다. (ga_session_id).
Android 및 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
setUserProperty사용자 속성을 지정된 값으로 설정합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserProperty({} as SetUserPropertyOptions);setCurrentScreen
__CAPGO_KEEP_1__ setCurrentScreen__CAPGO_KEEP_2__
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setCurrentScreen({} as SetCurrentScreenOptions);logEvent
__CAPGO_KEEP_1__ logEvent__CAPGO_KEEP_2__
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.logEvent({} as LogEventOptions);setSessionTimeoutDuration
__CAPGO_KEEP_1__ 세션 종료 시간 설정__CAPGO_KEEP_2__
__CAPGO_KEEP_2__ 안드로이드 및 iOS에서만 사용 가능
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setSessionTimeoutDuration({} as SetSessionTimeoutDurationOptions);setEnabled
__CAPGO_KEEP_1__ 사용 가능 여부 설정자동 데이터 수집을 활성/비활성화합니다. 앱이 다시 실행될 때까지 적용되지 않습니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setEnabled({} as SetEnabledOptions);isEnabled
isEnabled자동 데이터 수집이 활성화되어 있는지 여부를 반환합니다.
Web에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.isEnabled();resetAnalyticsData
resetAnalyticsData이 앱의 모든 분석 데이터를 기기에서 삭제하고 앱 인스턴스 ID를 초기화합니다.
Android 및 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.resetAnalyticsData();initiateOnDeviceConversionMeasurementWithEmailAddress
initiateOnDeviceConversionMeasurementWithEmailAddress이메일 주소와 함께 기기 내 변환 측정 시작합니다.
iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({} as InitiateOnDeviceConversionMeasurementWithEmailAddressOptions);initiateOnDeviceConversionMeasurementWithPhoneNumber
initiateOnDeviceConversionMeasurementWithPhoneNumber전화번호를 사용하여 장치 내 변환 측정 시작합니다.
iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions);initiateOnDeviceConversionMeasurementWithHashedEmailAddress
initiateOnDeviceConversionMeasurementWithHashedEmailAddress해시된 이메일 주소를 사용하여 장치 내 변환 측정 시작합니다.
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);타입 참조
타입 참조 섹션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
SetUserIdOptions 섹션export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string | null;}SetUserPropertyOptions
SetUserPropertyOptionsexport interface SetUserPropertyOptions { /** * @since 0.1.0 */ key: string; /** * @since 0.1.0 */ value: string | null;}SetCurrentScreenOptions
SetCurrentScreenOptionsexport 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
LogEventOptionsexport interface LogEventOptions { /** * The event name. * * @since 0.1.0 */ name: string; /** * The optional event params. * * @since 0.1.0 */ params?: { [key: string]: any };}SetSessionTimeoutDurationOptions
SetSessionTimeoutDurationOptionsexport interface SetSessionTimeoutDurationOptions { /** * Duration in seconds. * * @default 1800 * @since 0.1.0 */ duration: number;}SetEnabledOptions
SetEnabledOptionsexport interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
IsEnabledResultexport interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}InitiateOnDeviceConversionMeasurementWithEmailAddressOptions
InitiateOnDeviceConversionMeasurementWithEmailAddressOptions 섹션 제목export interface InitiateOnDeviceConversionMeasurementWithEmailAddressOptions { /** * The email address to initiate on-device conversion measurement with. * * @since 7.2.0 */ emailAddress: string;}InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions
InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions 섹션 제목export interface InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions { /** * The phone number to initiate on-device conversion measurement with. * * @since 7.2.0 */ phoneNumber: string;}실제 데이터 원천
실제 데이터 원천 섹션 제목이 페이지는 플러그인의 src/definitions.tsAPI이 업스트림에서 변경될 때마다 pubic을 다시 동기화하세요.
Getting Started에서 계속
Getting Started에서 계속 섹션 제목Capgo를 사용 중이라면 Getting Started API 대시보드와 운영 계획을 세우기 위해 연결하세요. API 개요 API 개요의 구현 세부 정보에 대해 소개 소개의 구현 세부 정보에 대해 API 키 API 키의 구현 세부 정보에 대해 기기 기기의 구현 세부 정보에 대해 패키지 패키지의 구현 세부 정보에 대해