Getting Started
Eine Setup-Anleitung mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
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.
Installieren
Abschnitt mit dem Titel ‘Installieren’Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten zu Ihrem KI-Tool hinzu, indem Sie folgenden Befehl ausführen:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsKopieren Sie dann folgende Anfrage:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-firebase-analytics` plugin in my project.Wenn Sie eine manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten angegebenen Plattform-spezifischen Anweisungen befolgen:
bun add @capgo/capacitor-firebase-analyticsbunx cap syncImportieren
Abschnitt mit der Überschrift "Importieren"import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';API Übersicht
Abschnitt mit der Überschrift "API Übersicht"getAppInstanceId
Abschnitt mit der Überschrift "getAppInstanceId"Ruft die Anwendungsinstanz-ID ab.
Nur für Android und iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.getAppInstanceId();console.log(result);getSessionId
Section titled “getSessionId”Ruft die aktuelle Sitzung ID ab (ga_session_id).
Nur für Android und iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.getSessionId();console.log(result);setConsent
Benutzereinstellungen setzenSetzt die Benutzer-Einwilligungs-Einstellung.
import { FirebaseAnalytics, ConsentStatus, ConsentType } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setConsent({ type: ConsentType.AdPersonalization, status: ConsentStatus.Granted,});setUserId
Benennung "setUserId"Setzt die Benutzer-ID-Eigenschaft.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserId({ userId: 'user-id-123' });setUserProperty
Benutzer-Eigenschaft setzenSets a custom user property to a given value.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setUserProperty({ key: 'key-123', value: 'value',});setCurrentScreen
Abschnitt mit dem Titel “setCurrentScreen”Setzt den Namen der aktuellen Bildschirm.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setCurrentScreen({ screenName: 'screen' });Protokolliert eine App-Ereignis.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.logEvent({ name: 'example' });setSessionTimeoutDuration
Abschnitt mit dem Titel “setSessionTimeoutDuration”Setzt die Dauer der Inaktivität, die das aktuelle Sitzung beendet.
Nur für Android und iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setSessionTimeoutDuration({ duration: 1800 });setEnabled
Abschnitt mit dem Titel ‘setEnabled’Automatisches Daten sammeln aktivieren oder deaktivieren. Die Einstellung wird erst bei der nächsten App-Ausführung angewendet.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.setEnabled({ enabled: true });isEnabled
Abschnitt mit dem Titel ‘isEnabled’Überprüft, ob automatisches Daten sammeln aktiviert ist.
Verfügbar nur für Web.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
const result = await FirebaseAnalytics.isEnabled();console.log(result);resetAnalyticsData
Abschnitt mit dem Titel ‘resetAnalyticsData’Alle Analysedaten für diese App vom Gerät löschen. Die App-Instanz-ID wird zurückgesetzt.
Verfügbar nur für Android und iOS.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.resetAnalyticsData();initiateOnDeviceConversionMeasurementWithEmailAddress
Abschnitt mit dem Titel ‘initiateOnDeviceConversionMeasurementWithEmailAddress’Initiiert die Umwandlungsmessung auf dem Gerät mit einer E-Mail-Adresse.
Nur für iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithEmailAddress({ emailAddress: 'user@example.com' });initiateOnDeviceConversionMeasurementWithPhoneNumber
Abschnitt mit dem Titel “initiateOnDeviceConversionMeasurementWithPhoneNumber”Initiiert die Umwandlungsmessung auf dem Gerät mit einer Telefonnummer.
Nur für iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithPhoneNumber({ phoneNumber: '+15555550123' });initiateOnDeviceConversionMeasurementWithHashedEmailAddress
Abschnitt mit dem Titel “initiateOnDeviceConversionMeasurementWithHashedEmailAddress”Initiiert die Umwandlungsmessung auf dem Gerät mit einer gehashten E-Mail-Adresse.
Nur für iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedEmailAddress({ emailAddressToHash: 'user@example.com' });initiateOnDeviceConversionMeasurementWithHashedPhoneNumber
Abschnitt mit dem Titel “initiateOnDeviceConversionMeasurementWithHashedPhoneNumber”Initiiert die Gerätekonversionsmessung mit einem gehashten Telefonnummer.
Nur für iOS verfügbar.
import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';
await FirebaseAnalytics.initiateOnDeviceConversionMeasurementWithHashedPhoneNumber({ phoneNumberToHash: '+15555550123' });Typenreferenz
Abschnitt "Typenreferenz"GetAppInstanceIdResult
Abschnitt "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
Abschnitt "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
Abschnitt "SetConsentOptions"export interface SetConsentOptions { /** * The consent type. * * @since 6.0.0 */ type: ConsentType; /** * The consent status. * * @since 6.0.0 */ status: ConsentStatus;}SetUserIdOptions
Abschnitt "SetUserIdOptions"export interface SetUserIdOptions { /** * @since 0.1.0 */ userId: string | null;}SetUserPropertyOptions
Abschnitt mit dem Titel „SetUserPropertyOptions“export interface SetUserPropertyOptions { /** * @since 0.1.0 */ key: string; /** * @since 0.1.0 */ value: string | null;}SetCurrentScreenOptions
Abschnitt mit dem Titel „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
Abschnitt mit dem Titel „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
Abschnitt mit dem Titel „SetSessionTimeoutDurationOptions“export interface SetSessionTimeoutDurationOptions { /** * Duration in seconds. * * @default 1800 * @since 0.1.0 */ duration: number;}SetEnabledOptions
Abschnitt mit dem Titel „SetEnabledOptions“export interface SetEnabledOptions { /** * @since 0.1.0 */ enabled: boolean;}IsEnabledResult
Abschnitt mit dem Titel „IsEnabledResult“export interface IsEnabledResult { /** * @since 0.1.0 */ enabled: boolean;}InitiateOnDeviceConversionMeasurementWithEmailAddressOptions
Abschnitt mit der Überschrift „InitiateOnDeviceConversionMeasurementWithEmailAddressOptions“export interface InitiateOnDeviceConversionMeasurementWithEmailAddressOptions { /** * The email address to initiate on-device conversion measurement with. * * @since 7.2.0 */ emailAddress: string;}InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions
Abschnitt mit der Überschrift „InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions“export interface InitiateOnDeviceConversionMeasurementWithPhoneNumberOptions { /** * The phone number to initiate on-device conversion measurement with. * * @since 7.2.0 */ phoneNumber: string;}Quelle der Wahrheit
Abschnitt mit der Überschrift „Quelle der Wahrheit“Diese Seite wurde von dem Plugin generiert. src/definitions.tsNeu synchronisieren, wenn die öffentliche API sich im Quellcode ändert.
Fortsetzen bei Getting Started
Abschnitt mit der Überschrift „Fortsetzen bei Getting Started“Wenn Sie Firebase Analytics verwenden Zur Einführung um das Dashboard und die API-Operationen zu planen und es mit API-Übersicht zur Implementierungsdetail in der API-Übersicht Einführung zur Implementierungsdetail in der Einführung API-Schlüssel zur Implementierungsdetail in den API-Schlüssel Geräte für die Implementierungsdetails in Devices, und Bundles für die Implementierungsdetails in Bundles.