Allez directement au contenu principal

Analytique Firebase plugin Capacitor

Capacitor plugin pour l'analytique Firebase

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 les Analytics Firebase dans Capacitor

En utilisant @capgo/capacitor-firebase-analytics

Capacitor plugin pour Firebase Analytics.

Installer

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

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

Importer

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

API en un coup d'œil

Méthode Description
getAppInstanceId Récupère l'ID de l'instance de l'application.
getSessionId Récupère l'ID de session actuelle (ga_session_id).
setConsent Définit le mode de consentement de l'utilisateur.
setUserId Définit la propriété ID utilisateur.
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 termine la session actuelle.
setEnabled Active/désactive la collecte automatique de données. La valeur n'est pas prise en compte avant la prochaine exécution de l'application.
isEnabled Renvoie si la collecte automatique de données est activée ou non.
resetAnalyticsData Efface toutes les données d'analyse pour cette application sur le dispositif. Réinitialise l'ID d'instance de l'application.
logTransaction Enregistre une transaction StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Initie la mesure de conversion sur appareil avec une adresse e-mail.
initiateOnDeviceConversionMeasurementWithPhoneNumber Mesure la conversion sur appareil avec un numéro de téléphone.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Initie la mesure de conversion sur appareil avec une adresse e-mail hachée.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Mesure la conversion sur appareil avec un numéro de téléphone haché.

Exemples

getAppInstanceId()

Récupère l'ID de l'instance de l'application.

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

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

getSessionId()

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

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

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

setConsent()

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

Fixe la propriété ID de l'utilisateur.

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

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

setUserProperty()

Fixe une propriété utilisateur personnalisée à une valeur donnée.

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

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

setCurrentScreen()

Fixe le nom de la page actuelle.

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

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

La table ci-dessus liste les 16 méthodes de base. Les aides aux écouteurs et aux versions, ainsi que la pleine convention de chaque méthode, sont documentés dans le répertoire GitHub.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-firebase-analytics

Si vous utilisez L'utilisation de @capgo/capacitor-firebase-analytics pour planifier le travail de plugin natif, connectez-l’à Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo, Ajout ou mise à jour de plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, Alternatives de plugins d'entreprise Ionic pour le flux de workflow du produit dans les alternatives Ionic Enterprise Plugin Capgo Bâtiments natifs pour le flux de workflow du produit dans Capgo Bâtiments natifs.

FAQ

FAQ du plugin d'analytique Firebase

Comment installer le plugin d'analytique Firebase dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-firebase-analytics » (ou « npm install @capgo/capacitor-firebase-analytics »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-firebase-analytics » dans votre application code.

Le plugin @capgo/capacitor-firebase-analytics fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin d'analytique Firebase est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge 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, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-firebase-analytics est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics et le paquet est gratuit pour l'installer à partir de npm. Les rapports de bogues et les demandes de modification 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 change les natives code, il faut donc une nouvelle build de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo en direct.

Envoyez les modifications d'Analytics Firebase sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrez avec Capgo