Zum Hauptinhalt springen

Firebase Analytics Capacitor Plugin

Capacitor Plugin für Firebase Analytics

Installieren

bun add @capgo/capacitor-firebase-analytics bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-firebase-analytics
  • pnpm add @capgo/capacitor-firebase-analytics
  • yarn add @capgo/capacitor-firebase-analytics

Anleitung

Firebase Analytics in Capacitor nutzen

@capgo/capacitor-firebase-analytics verwenden

Capacitor Plugin für Firebase Analytics.

Installieren

bun add @capgo/capacitor-firebase-analytics
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

API auf einen Blick

Methode Beschreibung
getAppInstanceId Ruft die App-Instanz-ID ab.
getSessionId Ruft die aktuelle Session-ID ab (ga_session_id).
setConsent Legt den Consent-Modus des Nutzers fest.
setUserId Legt die User-ID-Property fest.
setUserProperty Setzt eine benutzerdefinierte User-Property auf einen Wert.
setCurrentScreen Legt den aktuellen Screen-Namen fest.
logEvent Loggt ein App-Event.
setSessionTimeoutDuration Legt die Inaktivitätsdauer fest, nach der die Session endet.
setEnabled Aktiviert oder deaktiviert die automatische Datenerfassung. Der Wert wird erst beim nächsten App-Start wirksam.
isEnabled Gibt an, ob die automatische Datenerfassung aktiviert ist.
resetAnalyticsData Löscht alle Analytics-Daten dieser App vom Gerät und setzt die App-Instanz-ID zurück.
logTransaction Protokolliert eine StoreKit 2 Transaktion.
initiateOnDeviceConversionMeasurementWithEmailAddress Startet die On-Device-Conversion-Messung mit einer E-Mail-Adresse.
initiateOnDeviceConversionMeasurementWithPhoneNumber Startet die On-Device-Conversion-Messung mit einer Telefonnummer.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Startet die On-Device-Conversion-Messung mit einer gehashten E-Mail-Adresse.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Startet die On-Device-Conversion-Messung mit einer gehashten Telefonnummer.

Beispiele

getAppInstanceId()

Ruft die App-Instanz-ID ab.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getAppInstanceId();
console.log(result);

getSessionId()

Ruft die aktuelle Session-ID ab (ga_session_id).

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getSessionId();
console.log(result);

setConsent()

Legt den Consent-Modus des Nutzers fest.

import { FirebaseAnalytics, ConsentStatus, ConsentType } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setConsent({
  type: ConsentType.AdPersonalization,
  status: ConsentStatus.Granted,
});

setUserId()

Legt die User-ID-Property fest.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserId({ userId: 'user-id-123' });

setUserProperty()

Setzt eine benutzerdefinierte User-Property auf einen Wert.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserProperty({
  key: 'key-123',
  value: 'value',
});

setCurrentScreen()

Legt den aktuellen Screen-Namen fest.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setCurrentScreen({ screenName: 'screen' });

Die obige Tabelle listet die 16 Kernmethoden auf. Listener- und Versions-Helfer sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiterlesen ab „@capgo/capacitor-firebase-analytics verwenden“

Wenn du es nutzt @capgo/capacitor-firebase-analytics verwenden Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails unter „Plugins hinzufügen oder aktualisieren“, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen und Capgo Native Builds für den Produkt-Workflow in Capgo Native Builds.

FAQ

Firebase Analytics Plugin FAQ

Wie installiere ich das Firebase Analytics Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-firebase-analytics" (oder "npm install @capgo/capacitor-firebase-analytics") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-firebase-analytics".

Funktioniert @capgo/capacitor-firebase-analytics mit React, Vue und Angular?

Ja. Firebase Analytics ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft – einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-firebase-analytics unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-firebase-analytics kostenlos und Open Source?

Ja. Der code Quellcode ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics einsehbar, und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Firebase Analytics aktualisieren, ohne ein App Store Review abzuwarten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Firebase Analytics Änderungen ausrollen, ohne auf den App Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo