开始

复制一个设置提示，包含安装步骤和该插件的完整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辅助设置来安装插件。将以下命令添加到您的AI工具中：Capgo技能。

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.

如果您更喜欢手动设置，请运行以下命令安装插件并按照以下平台特定的说明进行操作：

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

导入

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

原生设置

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

iOS

添加您的Meta值 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>

Android

复制到剪贴板 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>

启用广告商跟踪

__CAPGO_KEEP_0__

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 For native capability in Using @capgo/capacitor-facebook-analytics, Capgo native能力目录 For product workflow in Capgo native能力目录, Capacitor native能力列表（由Capgo提供） For implementation detail in Capacitor native能力列表（由Capgo提供）, Adding or Updating native能力 For implementation detail in Adding or Updating native能力, and Ionic Enterprise native能力替代方案 For product workflow in Ionic Enterprise native能力替代方案.