Facebook Analytics Capacitor 插件

使用 @capgo/capacitor-facebook-analytics

为 iOS 和 Android 上的 Capacitor 应用提供 Meta/Facebook App Events 数据分析。

安装

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
• 文档

从“使用 @capgo/capacitor-facebook-analytics”继续

如果你正在使用 使用 @capgo/capacitor-facebook-analytics 要规划原生插件工作，请将其与 @capgo/capacitor-facebook-analytics 有关 @capgo/capacitor-facebook-analytics 中的实现细节， 快速入门 有关“入门指南”中的实现细节， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节，以及 添加或更新插件 有关添加或更新插件的实现细节。