Facebook 分析

使用 @capgo/capacitor-facebook-analytics

Meta/Facebook App Events analytics for Capacitor apps on iOS 和 Android。

安装

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

此插件暴露的内容

• initAppEvents - 手动激活 Facebook App Events。
• logEvent - 以参数、值和货币记录标准或自定义 App Events。
• logPurchase - 以金额和货币记录购买事件。
• enableAdvertiserTracking - 在支持的设备上启用原生广告商跟踪。
• disableAdvertiserTracking - 在支持的设备上禁用原生广告商跟踪。
• getAdvertiserTrackingStatus - 读取当前广告商跟踪状态。
• getPluginVersion - 读取原生插件版本。

示例使用

logEvent

记录一个标准事件，带有 Facebook 参数。

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

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

logEvent 带有价值和货币的事件

使用参数发送带有价值的标准事件。 fb_currency 参数。

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

记录购买事件。

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

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

全局参考

• GitHub
• 文档