Facebook Analytics

Using @capgo/capacitor-facebook-analytics

Meta/Facebook App Events analytics for Capacitor apps on iOS and Android.

Install

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

What This Plugin Exposes

• initAppEvents - Activate Facebook App Events manually.
• logEvent - Log standard or custom App Events with parameters, value, and currency.
• logPurchase - Log purchase events with amount and currency.
• enableAdvertiserTracking - Enable native advertiser tracking where supported.
• disableAdvertiserTracking - Disable native advertiser tracking where supported.
• getAdvertiserTrackingStatus - Read the current advertiser tracking status.
• getPluginVersion - Read the native plugin version.

Example Usage

logEvent

Log a standard event with Facebook parameters.

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

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

logEvent with value and currency

Send value-bearing standard events with the fb_currency parameter.

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

Log a purchase event.

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

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

Full Reference

• GitHub
• Docs