Getting Started

GitHub

Kopieren Sie eine Einrichtungsanweisung mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin.

        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.

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten Ihrem AI-Tool mithilfe der folgenden Befehl hinzu:

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

Verwenden Sie dann die folgende Anfrage:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

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

Importieren

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

Native Einrichtung

Konfigurieren Sie Ihre Meta-App-ID und Ihren Client-Token in der native App. Die Erweiterung erstellt diese Werte nicht für Sie.

iOS

Fügen Sie Ihre Meta-Werte zu 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

Fügen Sie Ihre Meta-Werte zu 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" />

Fügen Sie die String-Ressourcen in 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>

Advertiser-Tracking aktivieren

Rufen Sie dies nach Ihrem Zustimmungsfluss auf, der das Tracking ermöglicht.

await FacebookAnalytics.enableAdvertiserTracking();

Bei iOS 17 und höher liest FBSDK v17+ den App-Tracking-Transparenz direkt ein. Verwenden Sie vor der Protokollierung von Ereignissen, die vom Tracking abhängig sind, den ATT-Flow Ihres Apps.

Ein Standardereignis protokollieren

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

Ein Wertereignis mit Währung protokollieren

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

Eine Kaufabwicklung protokollieren

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

Lesen Sie den Tracking-Status

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

Quellwahrheit

Diese Seite wurde aus dem Plugin generiert. src/definitions.tsWiederholen Sie die Synchronisierung, wenn die öffentliche API sich im Hintergrund ändert.

Fortsetzen Sie mit dem Anfang

Wenn Sie das Plugin verwenden Zur Einführung um native Plugin-Arbeit zu planen, verbinden Sie es mit Mit @capgo/capacitor-facebook-Analytics zur native Fähigkeit in Mit @capgo/capacitor-facebook-Analytics, Capgo Plugin-Verzeichnis zur Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionics Enterprise-Plugin-Alternativen zur Produktworkflow in Ionics Enterprise-Plugin-Alternativen.