Démarrage
Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète pour ce plugin.
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.
Installer
Section intitulée « Installer »bun add @capgo/capacitor-firebase-analyticsbunx cap syncImporter
Section intitulée « Importer »import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';API Vue d'ensemble
Section intitulée « API Vue d'ensemble »getAppInstanceId
Section intitulée « getAppInstanceId »Récupère l'ID de l'instance d'application.
Disponible uniquement pour Android et iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getAppInstanceId();getSessionId
Section intitulée “getSessionId”Récupère l'identifiant de session actuel (ga_session_id).
Disponible uniquement pour Android et iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.getSessionId();setConsent
Section intitulée “setConsent”Définit le mode de consentement de l'utilisateur.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setConsent({} as SetConsentOptions);setUserId
Section intitulée “setUserId”Définit la propriété ID utilisateur.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserId({} as SetUserIdOptions);setUserProperty
Section intitulée “setUserProperty”Définit une propriété utilisateur personnalisée à une valeur donnée.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserProperty({} as SetUserPropertyOptions);setCurrentScreen
Section intitulée “setCurrentScreen”Définit le nom de l'écran actuel.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setCurrentScreen({} as SetCurrentScreenOptions);logEvent
Section intitulée “logEvent”Enregistre un événement de l'application.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.logEvent({} as LogEventOptions);setSessionTimeoutDuration
Section intitulée “setSessionTimeoutDuration”Définit la durée d'inactivité qui termine la session actuelle.
Disponible uniquement pour Android et iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setSessionTimeoutDuration({} as SetSessionTimeoutDurationOptions);setEnabled
Section intitulée “setEnabled”Active/désactive la collecte automatique de données. La valeur n'est pas appliquée jusqu'à la prochaine exécution de l'application.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setEnabled({} as SetEnabledOptions);isEnabled
Section intitulée “isEnabled”Renvoie si la collecte automatique de données est activée.
Disponible uniquement pour Web.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.isEnabled();resetAnalyticsData
Section intitulée “resetAnalyticsData”Supprime toutes les données d'analytique pour cette application du dispositif. Réinitialise l'ID de l'instance de l'application.
Disponible uniquement pour Android et iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.resetAnalyticsData();initiateOnDeviceConversionMeasurementWithEmailAddress
Section intitulée “initiateOnDeviceConversionMeasurementWithEmailAddress”Initie la mesure de conversion sur appareil avec une adresse e-mail.
Seulement disponible pour iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({} as InitiateOnDeviceConversionMeasurementWithEmailAddressOptions);initiateOnDeviceConversionMeasurementWithPhoneNumber
Section intitulée “initier la mesure de conversion sur appareil avec le numéro de téléphone”Initie la mesure de conversion sur appareil avec un numéro de téléphone.
Seulement disponible pour iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions);initiateOnDeviceConversionMeasurementWithHashedEmailAddress
Section intitulée “initier la mesure de conversion sur appareil avec l’adresse e-mail hachée”Initie la mesure de conversion sur appareil avec une adresse e-mail hachée.
Seulement disponible pour iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedEmailAddress({} as InitiateOnDeviceConversionMeasurementWithHashedEmailAddressOptions);initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
Section intitulée “initier la mesure de conversion sur appareil avec le numéro de téléphone haché”Initie la mesure de conversion sur appareil avec un numéro de téléphone haché.
Seulement disponible pour iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({} as InitiateOnDeviceConversionMeasurementWithHashedPhoneNumberOptions);Référence de type
Section intitulée “Référence de type”GetAppInstanceIdResult
Section intitulée “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
Section intitulée “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
Section intitulée “SetConsentOptions”export interface SetConsentOptions { /** * The consent type. * * @since 6.0.0 */ type: ConsentType; /** * The consent status. * * @since 6.0.0 */ status: ConsentStatus;}SetUserIdOptions
Section intitulée “SetUserIdOptions”export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string | null;}SetUserPropertyOptions
Section intitulée « Options de SetUserProperty »export interface SetUserPropertyOptions { /** * @since 0.1.0 */ key: string; /** * @since 0.1.0 */ value: string | null;}SetCurrentScreenOptions
Section intitulée « Options de SetCurrentScreen »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
Section intitulée « Options de LogEvent »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
Section intitulée « Options de SetSessionTimeoutDuration »export interface SetSessionTimeoutDurationOptions { /** * Duration in seconds. * * @default 1800 * @since 0.1.0 */ duration: number;}SetEnabledOptions
Section intitulée « Options de SetEnabled »export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
Section intitulée « Résultat d'IsEnabled »export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}InitiateOnDeviceConversionMeasurementWithEmailAddressOptions
Section intitulée « Initier la conversion de mesure de l'appareil avec les options d'adresse e-mail »export interface InitiateOnDeviceConversionMeasurementWithEmailAddressOptions { /** * The email address to initiate on-device conversion measurement with. * * @since 7.2.0 */ emailAddress: string;}InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions
Section intitulée « Initier la conversion de mesure de l'appareil avec les options de numéro de téléphone »export interface InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions { /** * The phone number to initiate on-device conversion measurement with. * * @since 7.2.0 */ phoneNumber: string;}Source De Vérité
Section intitulée « Source De Vérité »Cette page est générée à partir du plugin's src/definitions.tsRe-générez la synchronisation lorsque le public API change en amont.
Continuez de l'étape de démarrage
Section intitulée « Continuez de l'étape de démarrage »Si vous utilisez Étape de démarrage planer le tableau de bord et les opérations API, connectez-le à API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, Appareils pour les détails d'implémentation dans Appareils, et Bundles pour les détails d'implémentation dans Bundles.