Pasar al contenido principal

Firebase Analytics plugin de Capacitor

plugin de Capacitor para Firebase Analytics

Instalar

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

Guía

Cómo usar Firebase Analytics en Capacitor

Usando @capgo/capacitor-firebase-analytics

Plugin de Capacitor para Firebase Analytics.

Instalar

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

bunx cap sync Copia el plugin nativo de code en tus proyectos nativos. Correlo de nuevo después de cada actualización del plugin.

Importar

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

API a la vista

Método Descripción
getAppInstanceId Obtiene el id de instancia de la aplicación.
getSessionId Obtiene el id de sesión actual (ga_session_id).
setConsent Establece el modo de consentimiento del usuario.
setUserId Establece la propiedad de id de usuario.
setUserProperty Establece una propiedad de usuario personalizada a un valor dado.
setCurrentScreen Establece el nombre de la pantalla actual.
logEvent Registra un evento de la aplicación.
setSessionTimeoutDuration Establece la duración de inactividad que termina la sesión actual.
setEnabled Activa/desactiva la recopilación automática de datos. El valor no se aplica hasta la próxima ejecución de la aplicación.
isEnabled Devuelve si la recopilación automática de datos está habilitada o no.
resetAnalyticsData Clears all analytics data for this app from the device. Resets the app instance id.
logTransaction Registra una transacción de StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Inicia la medición de conversión en el dispositivo con una dirección de correo electrónico.
initiateOnDeviceConversionMeasurementWithPhoneNumber Inicia la medición de conversión en dispositivo con un número de teléfono.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Inicia la medición de conversión en el dispositivo con una dirección de correo electrónico hashada.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Inicia la medición de conversión en el dispositivo con un número de teléfono hashado.

Ejemplos

getAppInstanceId()

Obtiene el identificador de instancia de la aplicación.

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

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

getSessionId()

Obtiene el identificador de sesión actual (ga_session_id).

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

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

setConsent()

Establece el modo de consentimiento del usuario.

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

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

setUserId()

Establece la propiedad de ID de usuario.

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

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

setUserProperty()

Establece una propiedad de usuario personalizada a un valor dado.

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

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

setCurrentScreen()

Establece el nombre actual de la pantalla.

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

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

La tabla anterior muestra los 16 métodos básicos. Los ayudantes de escucha y versión, y el contrato completo de cada método, se documentan en el GitHub repositorio.

Referencia completa

Sigue adelante desde Usando @capgo/capacitor-firebase-analytics

Si estás utilizando Usando @capgo/capacitor-firebase-analytics para planificar el trabajo de plugin nativo, conecte con Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives, y Capgo Compilaciones Nativas para el flujo de trabajo del producto en Capgo Compilaciones Nativas.

FAQ

Referencia completa del plugin de Firebase Analytics

¿Cómo instalo el plugin de Firebase Analytics en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-firebase-analytics" (o "npm install @capgo/capacitor-firebase-analytics"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el code nativo. Importa desde "@capgo/capacitor-firebase-analytics" en la code de tu aplicación.

¿Funciona @capgo/capacitor-firebase-analytics con React, Vue y Angular?

Sí. Firebase Analytics es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-firebase-analytics?

Los plugins Capgo siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-firebase-analytics gratuito y de código abierto?

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Firebase Analytics sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Envía cambios de Firebase Analytics sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo