开始
复制一个包含安装步骤和本插件的完整Markdown指南的设置提示
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 助手来安装插件。将 Capgo 技能添加到您的 AI 工具中,使用以下命令:
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.如果您更喜欢手动设置,请按照以下命令安装插件,并遵循以下平台特定的说明:
bun add @capgo/capacitor-firebase-analyticsbunx cap sync导入
导入import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';API概述
API 简介getAppInstanceId
获取应用实例ID仅适用于Android和iOS。
导入
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.getAppInstanceId();console.log(result);getSessionId
getSessionId获取当前会话ID(ga_session_id).
仅适用于Android和iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.getSessionId();console.log(result);setConsent
setConsent设置用户同意模式。
import { FirebaseAnalytics, ConsentStatus, ConsentType } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setConsent({ type: ConsentType.AdPersonalization, status: ConsentStatus.Granted,});setUserId
setUserId设置用户ID属性。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserId({ userId: 'user-id-123' });setUserProperty
setUserProperty设置一个自定义用户属性为给定的值。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserProperty({ key: 'key-123', value: 'value',});setCurrentScreen
setCurrentScreen设置当前屏幕名称。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setCurrentScreen({ screenName: 'screen' });logEvent
logEvent记录应用事件。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.logEvent({ name: 'example' });setSessionTimeoutDuration
setCurrentSessionTimeoutDuration设置当前会话超时持续时间。
仅适用于 Android 和 iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setSessionTimeoutDuration({ duration: 1800 });setEnabled
setEnabled启用/禁用自动数据收集。 数据值直到下一次应用程序运行才会生效。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setEnabled({ enabled: true });isEnabled
context: Capgo营销网站. 角色: UI标签. 见于: 页面代理/[slug].astro. 消息键 `agents_page_copy_label` (代理页面复制标签).isEnabled
返回是否启用了自动数据收集。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.isEnabled();console.log(result);resetAnalyticsData
仅适用于Web。resetAnalyticsData
清除此应用程序在设备上的所有分析数据。 重置应用程序实例ID。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.resetAnalyticsData();initiateOnDeviceConversionMeasurementWithEmailAddress
仅适用于Android和iOS。使用设备端的转换测量,使用电子邮件地址。
仅适用于 iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({ emailAddress: 'user@example.com' });initiateOnDeviceConversionMeasurementWithPhoneNumber
区域:Capgo营销网站。角色:UI标签。见于:页面代理/[slug].astro。消息键 `agents_page_copy_label` (代理页面复制标签)。标题为“initiateOnDeviceConversionMeasurementWithPhoneNumber”
仅适用于 iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({ phoneNumber: '+15555550123' });initiateOnDeviceConversionMeasurementWithHashedEmailAddress
使用设备端的转换测量,使用电话号码。标题为“initiateOnDeviceConversionMeasurementWithHashedEmailAddress”
仅适用于 iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedEmailAddress({ emailAddressToHash: 'user@example.com' });initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
使用设备端的转换测量,使用加密的电子邮件地址。使用加密电话号码启动设备端转换测量。
仅适用于 iOS。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({ phoneNumberToHash: '+15555550123' });类型参考
类型参考GetAppInstanceIdResult
获取应用实例 ID 结果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
获取会话 ID 结果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
设置隐私选项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
是否启用结果export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}InitiateOnDeviceConversionMeasurementWithEmailAddressOptions
设备上设备转换测量初始化邮件地址选项export interface InitiateOnDeviceConversionMeasurementWithEmailAddressOptions { /** * The email address to initiate on-device conversion measurement with. * * @since 7.2.0 */ emailAddress: string;}InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions
设备上设备转换测量初始化手机号选项export interface InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions { /** * The phone number to initiate on-device conversion measurement with. * * @since 7.2.0 */ phoneNumber: string;}真实来源
真实来源此页面由插件生成 src/definitions.ts. 当公共API上游更改时,请重新同步。
继续从开始
继续从开始如果您正在使用 开始使用 为计划仪表板和API操作,连接它 API概述 了解API概述的实现细节 简介 了解简介的实现细节 API密钥 了解API密钥的实现细节 设备 了解设备的实现细节 包 了解包的实现细节