开始入门

复制一个包含安装步骤和本插件完整 Markdown 指南的配置提示.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-facebook-analytics`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/facebook-analytics/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

您可以使用我们的 AI 助手设置来安装插件。使用以下命令将 Capgo 技能添加到您的 AI 工具中：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-facebook-analytics` plugin in my project.

如果您prefer手动设置，请按照以下命令安装插件并遵循以下平台特定的说明：

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

Import

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

原生设置

在原生应用中配置您的Meta应用ID和客户端令牌。插件不会为您创建这些值。

iOS

复制到剪贴板 Info.plist:

<key>FacebookAppID</key>
<string>YOUR_FACEBOOK_APP_ID</string>
<key>FacebookClientToken</key>
<string>YOUR_FACEBOOK_CLIENT_TOKEN</string>
<key>FacebookDisplayName</key>
<string>YOUR_APP_NAME</string>

导入

添加您的Meta值 AndroidManifest.xml:

<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id" />
<meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token" />

添加字符串资源在 android/app/src/main/res/values/strings.xml:

<string name="facebook_app_id">YOUR_FACEBOOK_APP_ID</string>
<string name="facebook_client_token">YOUR_FACEBOOK_CLIENT_TOKEN</string>

启用广告商跟踪

在您的同意流程允许跟踪后调用此函数

await FacebookAnalytics.enableAdvertiserTracking();

在iOS 17及以上版本中，FBSDK v17+直接读取App Tracking Transparency。在登录跟踪依赖事件之前，请使用您的应用程序的ATT流程

记录标准事件

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

记录一个带有货币的值事件

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

记录一个购买

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

读取跟踪状态

const { status } = await FacebookAnalytics.getAdvertiserTrackingStatus();
console.log('Advertiser tracking enabled:', status);

真实来源

本页面是由插件生成的 src/definitions.ts. 当 API 上游更改时，请重新运行同步。

继续 Getting Started

如果您正在使用 Getting Started 来规划原生插件工作，连接它与使用 @capgo/capacitor-facebook-analytics 为原生功能在使用 @capgo/capacitor-facebook-analytics 中 Capgo 插件目录为产品工作流程在 Capgo 插件目录中 Capacitor 由 Capgo 的插件为实现细节在 Capacitor 由 Capgo 的插件中, 添加或更新插件为添加或更新插件的实现细节, 和 Ionic 企业插件替代品为 Ionic 企业插件替代品的产品工作流程.