Saltare 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 utilizzare 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 il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in sintesi

Metodo Descrizione
getAppInstanceId Recupera l'ID dell'istanza dell'applicazione.
getSessionId Recupera l'ID della sessione corrente (ga_session_id).
setConsent Imposta il modo di consenso dell'utente.
setUserId Imposta la proprietà ID dell'utente.
setUserProperty Imposta una proprietà utente personalizzata a un valore specifico.
setCurrentScreen Imposta il nome della schermata corrente.
logEvent Registra un evento dell'applicazione.
setSessionTimeoutDuration Imposta la durata di inattività che termina la sessione corrente.
setEnabled Abilita/disabilita la raccolta automatica dei dati. Il valore non si applica fino alla prossima esecuzione dell'app.
isEnabled Restituisce se la raccolta automatica dei dati è abilitata o meno.
resetAnalyticsData Cancella tutti i dati di analisi per questa app dal dispositivo. Riavvia l'ID dell'istanza dell'app.
logTransaction Registra una transazione StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Avvia la misurazione della conversione sul dispositivo con un indirizzo email.
initiateOnDeviceConversionMeasurementWithPhoneNumber Misura la conversione con un numero di telefono.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Avvia la misurazione della conversione sul dispositivo con un indirizzo email hashato.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Misura la conversione con un numero di telefono hashato sul dispositivo.

Esempi

getAppInstanceId()

Controlla 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 il livello di consenso del 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 le 16 metodologie di base. Gli ascoltatori e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nel repository GitHub.

Riferimento completo

Continua dall'uso di @capgo/capacitor-firebase-analytics

Continua da Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-firebase-analytics Usando @capgo/capacitor-firebase-analytics per pianificare il lavoro dei plugin nativi, connettilo con Capgo Directory dei Plugin per il workflow del prodotto nella Capgo Directory dei Plugin Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiunta o Aggiornamento dei Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento dei Plugin, Sostituti dei Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Ionic Enterprise Plugin Alternatives, e Capgo Costruzioni Native per il flusso di lavoro del prodotto in Capgo Costruzioni Native.

FAQ

Domande frequenti sul plugin Firebase Analytics

Come posso installare il plugin Firebase Analytics in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-analytics" (o "npm install @capgo/capacitor-firebase-analytics"), quindi esegui "bunx cap sync" per far riconoscere ai progetti iOS e Android il nativo code. Importalo da "@capgo/capacitor-firebase-analytics" nella tua app code.

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

Si. L'analisi Firebase è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione Capacitor di @capgo/capacitor-firebase-analytics?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore 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?

Si. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono graditi.

Posso aggiornare code che utilizza Firebase Analytics senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione del store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti live di Capgo.

Invia modifiche di Firebase Analytics senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo le modifiche live inviano i cambiamenti JavaScript, HTML e CSS ai tuoi utenti in pochi minuti.

Avvia con Capgo