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

So nutzt du Firebase Analytics in Capacitor

@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 zurück, ob die automatische Datenerfassung aktiviert ist oder nicht.
resetAnalyticsData Löscht alle Analytics-Daten für diese App vom Gerät. Setzt die App-Instanz-ID zurück.
logTransaction Protokolliert eine StoreKit 2-Transaktion.
initiateOnDeviceConversionMeasurementWithEmailAddress Startet die Conversion-Messung auf dem Gerät mit einer E-Mail-Adresse.
initiateOnDeviceConversionMeasurementWithPhoneNumber Startet die Conversion-Messung auf dem Gerät mit einer Telefonnummer.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Startet die Conversion-Messung auf dem Gerät mit einer gehashten E-Mail-Adresse.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Startet die Conversion-Messung auf dem Gerät 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 optimieren für den Produkt-Workflow in Capgo Native Builds.

FAQ

FAQ zum Firebase Analytics Plugin

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 anschließend "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deinem App-code aus "@capgo/capacitor-firebase-analytics".

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

Ja. Firebase Analytics ist ein Capacitor-Paket 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 unterstützt @capgo/capacitor-firebase-analytics?

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 Quell-code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics verfügbar und das Paket kann kostenlos von npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code aktualisieren, das Firebase Analytics verwendet, ohne eine App-Store-Prüfung?

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 veröffentlichen, ohne auf die App-Prüfung 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