Aller au contenu principal
@capgo/capacitor-firebase-analytics Statistiques Open source

Firebase Analytics Plugin Capacitor

plugin Capacitor pour Firebase Analytics

Installer

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

Guide

Comment utiliser Firebase Analytics dans Capacitor

Utiliser @capgo/capacitor-firebase-analytics

Plugin Capacitor pour Firebase Analytics.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
getAppInstanceId Récupère l'ID d'instance de l'app.
getSessionId Récupère l'ID de la session actuelle (ga_session_id).
setConsent Définit le mode de consentement de l'utilisateur.
setUserId Définit la propriété user ID.
setUserProperty Sets a custom user property to a given value.
setCurrentScreen Définit le nom de l'écran actuel.
logEvent Enregistre un événement de l'application.
setSessionTimeoutDuration Définit la durée d'inactivité qui met fin à la session actuelle.
setEnabled Active ou désactive la collecte automatique de données. La valeur ne prend effet qu'au prochain lancement de l'app.
isEnabled Indique si la collecte automatique de données est activée ou non.
resetAnalyticsData Efface toutes les données analytics de cette app de l'appareil. Réinitialise l'ID d'instance de l'app.
logTransaction Enregistre une transaction StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Lance la mesure de conversion sur l'appareil avec une adresse e-mail.
initiateOnDeviceConversionMeasurementWithPhoneNumber Lance la mesure de conversion sur l'appareil avec un numéro de téléphone.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Lance la mesure de conversion sur l'appareil avec une adresse e-mail hachée.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Lance la mesure de conversion sur l'appareil avec un numéro de téléphone haché.

Exemples

getAppInstanceId()

Récupère l'ID d'instance de l'app.

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

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

getSessionId()

Récupère l'ID de la session actuelle (ga_session_id).

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

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

setConsent()

Définit le mode de consentement de l'utilisateur.

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

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

setUserId()

Définit la propriété user ID.

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

Définit le nom de l'écran actuel.

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

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

Le tableau ci-dessus liste les 16 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Référence complète

Continuer après l'utilisation de @capgo/capacitor-firebase-analytics

Si vous utilisez Utiliser @capgo/capacitor-firebase-analytics pour planifier le travail sur les plugins natifs, connectez-l’à Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, et Capgo Native Build pour le workflow produit dans Capgo Native Builds.

FAQ

FAQ du plugin Firebase Analytics

Comment installer le plugin Firebase Analytics dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-firebase-analytics" (ou "npm install @capgo/capacitor-firebase-analytics"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-firebase-analytics" dans votre code.

Est-ce que @capgo/capacitor-firebase-analytics fonctionne avec React, Vue et Angular ?

Oui. Firebase Analytics est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-firebase-analytics ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-firebase-analytics est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Firebase Analytics sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Firebase Analytics sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo