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

Facebook Analytics plugin Capacitor

Analítica de Meta/Facebook App Events con eventos estándar, registro de compras, parámetros de moneda y controles de seguimiento de anunciantes

Instalar

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

Guía

Cómo usar Facebook Analytics en Capacitor

Uso de @capgo/capacitor-facebook-analytics

Analítica de eventos de Meta/Facebook para apps de Capacitor en iOS y Android.

Instalar

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

Lo que expone este plugin

  • initAppEvents - Activa los App Events de Facebook manualmente.
  • logEvent - Registra App Events estándar o personalizados con parámetros, valor y moneda.
  • logPurchase - Registra eventos de compra con importe y moneda.
  • enableAdvertiserTracking - Habilita el seguimiento nativo de anunciantes donde esté disponible.
  • disableAdvertiserTracking - Deshabilita el seguimiento nativo de anunciantes donde esté disponible.
  • getAdvertiserTrackingStatus - Lee el estado actual del seguimiento de anunciantes.
  • getPluginVersion - Lee la versión del plugin nativo.

Ejemplo de uso

logEvent

Registra un evento estándar con parámetros de Facebook.

import {
  FacebookAnalytics,
  FacebookEventName,
  FacebookEventParameterName,
} from '@capgo/capacitor-facebook-analytics';

await FacebookAnalytics.logEvent({
  event: FacebookEventName.CompletedRegistration,
  params: {
    [FacebookEventParameterName.RegistrationMethod]: 'email',
  },
});

logEvent con valor y moneda

Envía eventos estándar con valor usando fb_currency parámetro.

import {
  FacebookAnalytics,
  FacebookEventName,
  FacebookEventParameterName,
} from '@capgo/capacitor-facebook-analytics';

await FacebookAnalytics.logEvent({
  event: FacebookEventName.AddedToCart,
  valueToSum: 19.99,
  currency: 'USD',
  params: {
    [FacebookEventParameterName.ContentType]: 'product',
    [FacebookEventParameterName.ContentId]: 'sku-123',
  },
});

logPurchase

Registra un evento de compra.

import { FacebookAnalytics } from '@capgo/capacitor-facebook-analytics';

await FacebookAnalytics.logPurchase({
  amount: 9.99,
  currency: 'USD',
});

Referencia completa

Continúa desde Usando @capgo/capacitor-facebook-analytics

Si estás usando Uso de @capgo/capacitor-facebook-analytics para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-facebook-analytics para los detalles de implementación en @capgo/capacitor-facebook-analytics, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Facebook Analytics

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

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

¿Es compatible @capgo/capacitor-facebook-analytics con React, Vue y Angular?

Sí. Facebook 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-facebook-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-facebook-analytics gratuito y open source?

Sí. El código fuente de code es público en GitHub, en https://github.com/Cap-go/capacitor-facebook-analytics/ y el paquete se puede instalar gratis desde npm. Se agradecen los reportes de bugs y pull requests.

¿Puedo actualizar code que usa Facebook 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.

Publica cambios de Facebook 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