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 Imposta una proprietà utente personalizzata a un valore specifico.
setCurrentScreen Imposta il nome della schermata corrente.
logEvent Registra un evento dell'app.
setSessionTimeoutDuration Imposta la durata di inattività che termina la sessione corrente.
setEnabled Abilita/disabilita la raccolta automatica dei dati. Il valore non viene applicato fino al prossimo avvio dell'app.
isEnabled Restituisce se la raccolta automatica dei dati è abilitata o meno.
resetAnalyticsData Cancella tutti i dati analytics di questa app dal dispositivo. Reimposta l'ID dell'istanza dell'app.
logTransaction Registra una transazione StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Avvia la misurazione delle conversioni on-device con un 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 con hash.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Avvia la misurazione delle conversioni on-device tramite numero di telefono con hash.

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()

Imposta una proprietà utente personalizzata a un valore specifico.

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. I listener, gli 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.

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

Sì. Firebase Analytics è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, incluso 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 è gratuito e open source?

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

Posso aggiornare code che usa Firebase Analytics senza una 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.

Rilascia le modifiche a Firebase Analytics senza aspettare 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