指南
Facebook 分析的教程
使用 @capgo/capacitor-facebook-analytics
Meta/Facebook App Events 分析工具,适用于 iOS 和 Android 的 Capacitor 应用
安装
bun add @capgo/capacitor-facebook-analytics
bunx cap sync
此插件暴露的内容
initAppEvents- 手动激活 Facebook App EventslogEvent- 以标准或自定义方式记录 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',
});