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.