はじめに
エージェント用のコピー用ラベル
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 syncインポート
「インポート」のセクションimport { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';APIの概要
「APIの概要」のセクションgetAppInstanceId
「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
setSessionTimeoutDuration現在のセッションを終了する不活性時間を設定します。
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
自動データ収集の有効化状態を返します。
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
「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
「initiateOnDeviceConversionMeasurementWithHashedPhoneNumber」セクションデバイス上の変換測定を開始します。ハッシュ化された電話番号を使用します。
iOSのみで利用可能です。
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({ phoneNumberToHash: '+15555550123' });型参照
「型参照」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
「ユーザープロパティーオプションの設定」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
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パブリックAPIがアップストリームで変更されたときに再度同期してください。
続けてGetting Started
続けてGetting Startedあなたが スタートガイド 計画用ダッシュボードとAPIの実行を計画し、APIと接続する APIの概要 APIの概要の実装詳細について 導入 導入の実装詳細について APIキー APIキーに関する実装詳細について デバイス for the implementation detail in Devices, and デバイスの実装詳細について バンドル