Saltar al contenido principal
@capgo/capacitor-firebase-analytics Analíticas Código abierto

Firebase Analytics plugin Capacitor

Plugin 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 code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
getAppInstanceId Obtiene el ID de la instancia de la app.
getSessionId Obtiene el ID de la sesión actual (ga_session_id).
setConsent Establece el modo de consentimiento del usuario.
setUserId Establece la propiedad del ID de usuario.
setUserProperty Asigna un valor a una propiedad de usuario personalizada.
setCurrentScreen Establece el nombre de la pantalla actual.
logEvent Registra un evento de la app.
setSessionTimeoutDuration Establece la duración de inactividad que finaliza la sesión actual.
setEnabled Activa o desactiva la recolección automática de datos. El cambio surtirá efecto en la próxima ejecución de la app.
isEnabled Indica si la recopilación automática de datos está activada.
resetAnalyticsData Elimina todos los datos de analytics de esta app en el dispositivo. Reinicia el app instance id.
logTransaction Registra una transacción de StoreKit 2.
initiateOnDeviceConversionMeasurementWithEmailAddress Inicia la medición de conversiones en el dispositivo con un email.
initiateOnDeviceConversionMeasurementWithPhoneNumber Inicia la medición de conversiones on-device con un número de teléfono.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Inicia la medición de conversiones on-device con un email hasheado.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Inicia la medición de conversiones on-device con un número de teléfono hasheado.

Ejemplos

getAppInstanceId()

Obtiene el ID de la instancia de la app.

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

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

getSessionId()

Obtiene el ID de la 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 del ID de usuario.

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

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

setUserProperty()

Asigna un valor a una propiedad de usuario personalizada.

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

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

setCurrentScreen()

Establece el nombre de la pantalla actual.

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

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

La tabla anterior enumera los 16 métodos principales. Los helpers de Listener, de versión y el contrato completo de cada método están documentados en la repositorio GitHub.

Referencia completa

Continuar desde Using @capgo/capacitor-firebase-analytics

Si estás usando Usando @capgo/capacitor-firebase-analytics para planificar el trabajo con plugins nativos, conéctalo con Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo en Alternativas a plugins de Ionic Enterprise, y Native Builds de Capgo para el flujo de trabajo del producto en Capgo Native Builds.

FAQ

FAQ del plugin Firebase Analytics

¿Cómo instalo el plugin Firebase Analytics en una app Capacitor?

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

¿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 corra dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

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

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del 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 es público en GitHub en https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics y el paquete se puede instalar gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Firebase Analytics sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Firebase Analytics sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo