メインコンテンツへスキップ
@capgo/capacitor-facebook-analytics アナリティクス オープンソース

Facebook Analytics Capacitor プラグイン

標準イベント、購入ログ、通貨パラメータ、広告主トラッキング制御に対応した Meta/Facebook App Events アナリティクス

インストール

bun add @capgo/capacitor-facebook-analytics bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-facebook-analytics
  • pnpm add @capgo/capacitor-facebook-analytics
  • yarn add @capgo/capacitor-facebook-analytics

ガイド

Capacitor で Facebook Analytics を使う方法

@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',
});

リファレンス全文

@capgo/capacitor-facebook-analytics の使用方法についてはこちら

使用している場合 @capgo/capacitor-facebook-analytics を使用する場合 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-facebook-analytics @capgo/capacitor-facebook-analytics の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。

よくある質問

Facebook Analytics プラグイン FAQ

Capacitor アプリに Facebook Analytics プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-facebook-analytics" (または "npm install @capgo/capacitor-facebook-analytics") を実行し、次に "bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させます。その後、アプリの code から "@capgo/capacitor-facebook-analytics" をインポートしてください。

@capgo/capacitor-facebook-analytics は React、Vue、Angular で動作しますか?

はい。Facebook Analytics は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用可能です。

@capgo/capacitor-facebook-analytics はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-facebook-analytics は無料のオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-facebook-analytics/ で公開されており、npm から無料でインストールできます。バグ報告やプルリクエストもお待ちしています。

App Store の審査を通さずに、Facebook Analytics を使用している code をアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに Facebook Analytics の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める