시작하기
설치 명령어와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.
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를 가져옵니다.
안드로이드와 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getAppInstanceId();getSessionId
세션 ID를 가져오는 방법현재 세션 ID를 가져옵니다 (ga_session_id).
안드로이드와 iOS에서만 사용 가능합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getSessionId();setConsent
사용자 동의 모드를 설정하는 방법클립보드에 복사
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setConsent({} as SetConsentOptions);setUserId
클립보드에 복사Sets the user ID property.
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
기능 제목: "기기 내 변환 측정 시작하기 이메일 주소로"이메일 주소로 기기 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({} as InitiateOnDeviceConversionMeasurementWithEmailAddressOptions);initiateOnDeviceConversionMeasurementWithPhoneNumber
기능 제목: "기기 내 변환 측정 시작하기 전화번호로"전화번호로 기기 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions);initiateOnDeviceConversionMeasurementWithHashedEmailAddress
기능 제목: "기기 내 변환 측정 시작하기 이메일 주소 해시로"해시된 이메일 주소로 기기 내 변환 측정 시작합니다.
iOS만 지원합니다.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedEmailAddress({} as InitiateOnDeviceConversionMeasurementWithHashedEmailAddressOptions);initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
__CAPGO_KEEP_0____CAPGO_KEEP_1__
__CAPGO_KEEP_2__
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithHashedPhoneNumberOptions);__CAPGO_KEEP_4__
__CAPGO_KEEP_5__GetAppInstanceIdResult
__CAPGO_KEEP_6__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
__CAPGO_KEEP_8__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
__CAPGO_KEEP_10__export interface SetConsentOptions { /** * The consent type. * * @since 6.0.0 */ type: ConsentType; /** * The consent status. * * @since 6.0.0 */ status: ConsentStatus;}SetUserIdOptions
SetUserIdOptionsexport 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
“isEnabledResult” 섹션 제목export 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.ts공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.
Getting Started에서 계속
“Getting Started에서 계속” 섹션 제목만약에 당신이 Getting Started 계획 대시보드와 API 연산을 계획하고 싶다면 API 개요 에서 API 개요에 대한 구현 세부 정보를 확인하세요. Introduction 에서 Introduction에 대한 구현 세부 정보를 확인하세요. API 키 에서 API 키에 대한 구현 세부 정보를 확인하세요. Devices 에서 Devices에 대한 구현 세부 정보를 확인하세요. Bundles 구현 세부 사항에 대한 Bundles.