Salta al contenuto principale

Firebase Analytics Plugin Capacitor

plugin Capacitor per Firebase Analytics

Installa

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

Guida

Come usare Firebase Analytics in Capacitor

Utilizzo di @capgo/capacitor-firebase-analytics

Plugin Capacitor per Firebase Analytics.

Installa

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

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
getAppInstanceId Recupera l'ID dell'istanza dell'app.
getSessionId Recupera l'ID della sessione corrente (ga_session_id).
setConsent Imposta la modalità di consenso dell'utente.
setUserId Imposta la proprietà dell'ID utente.
setUserProperty Sets a custom user property to a given value.
setCurrentScreen Imposta il nome della schermata corrente.
logEvent Registra un evento dell'app.
setSessionTimeoutDuration Imposta la durata di inattività per terminare la sessione corrente.
setEnabled Abilita o disabilita la raccolta automatica dei dati. Il valore sarà applicato al prossimo avvio dell'app.
isEnabled Restituisce se la raccolta automatica dei dati è abilitata o meno.
resetAnalyticsData Cancella tutti i dati analitici di questa app dal dispositivo. Resetta l'app instance id.
logTransaction Registra una transazione StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Avvia la misurazione delle conversioni on-device tramite indirizzo email.
initiateOnDeviceConversionMeasurementWithPhoneNumber Avvia la misurazione delle conversioni on-device tramite numero di telefono.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Avvia la misurazione delle conversioni on-device tramite indirizzo email hashato.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Avvia la misurazione delle conversioni on-device tramite numero di telefono hashato.

Esempi

getAppInstanceId()

Recupera l'ID dell'istanza dell'app.

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

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

getSessionId()

Recupera l'ID della sessione corrente (ga_session_id).

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

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

setConsent()

Imposta la modalità di consenso dell'utente.

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

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

setUserId()

Imposta la proprietà dell'ID utente.

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

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

setUserProperty()

Sets a custom user property to a given value.

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

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

setCurrentScreen()

Imposta il nome della schermata corrente.

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

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

La tabella sopra elenca i 16 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-firebase-analytics

Se stai usando Utilizzo di @capgo/capacitor-firebase-analytics per pianificare il lavoro sui plugin nativi, collegalo a Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli sull'implementazione in Adding or Updating Plugins, Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Ionic Enterprise Plugin Alternatives, e Capgo Native Build per il workflow di prodotto in Capgo Native Builds.

FAQ

FAQ sul plugin Firebase Analytics

Come installo il plugin Firebase Analytics in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-analytics" (o "npm install @capgo/capacitor-firebase-analytics"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-firebase-analytics" nel tuo code dell'app.

@capgo/capacitor-firebase-analytics funziona con React, Vue e Angular?

Sì. Firebase Analytics è un pacchetto Capacitor, quindi funziona con qualsiasi framework web in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-firebase-analytics?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-firebase-analytics è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Firebase Analytics senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche a Firebase Analytics senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo