始めから始める

このプラグインのインストール手順と完全なマークダウンガイドを含む設定プロンプトをコピーする

        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

コンテキスト: Capgo マーケティングウェブサイト。役割: UI ラベル。表示: ページエージェント/[slug].astro。メッセージキー `agents_page_copy_label` (エージェントページコピーラベル)。

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

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

ネイティブ設定

ネイティブアプリで、MetaアプリIDとクライアントトークンを設定してください。プラグインはこれらの値を自動生成しません。

iOS

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

iOS用の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" />

Facebook アナリティクスプラグインの設定 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);

真実の源

再同期を実行してください。公開用 __CAPGO_KEEP_0__ がアップストリームで変更されたときに。 src/definitions.ts.APIがアップストリームで変更されたときは、再度同期を実行してください。

プラグインの生成元ページ

Capgoを使用している場合、Facebook Analyticsプラグインを使用するには、Capacitor Live Updateを有効にする必要があります。 はじめに を使用している場合 Using @capgo/capacitor-facebook-analytics native プラグインの作業を計画するには、@capgo/capacitor-facebook-analyticsを接続します。 Capgo プラグインディレクトリ native プラグインの作業フローを計画するには、@Capgo プラグインディレクトリを使用します。 Capacitor プラグインは Capgo によって提供されます。 Capacitor プラグインの実装詳細については、Capgo によって提供されます。プラグインの追加または更新プラグインの実装詳細については、Adding or Updating Pluginsを参照してください。 Ionic Enterprise プラグイン代替 Ionic Enterprise プラグイン代替の製品ワークフロー