Getting Started

le GitHub

Copiez une invitation de commande de configuration avec les étapes d'installation et le guide markdown complet pour ce 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.

Installez

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

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

Importer

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

Configuration native

Configurez votre ID d'application Meta et votre jeton client dans l'application native. Le plugin ne crée pas ces valeurs pour vous.

iOS

Ajoutez vos valeurs 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

Ajoutez vos valeurs 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" />

Ajoutez les ressources de chaînes dans 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>

Activer le suivi de l'annonceur

Appelez cette méthode après que votre flux de consentement autorise le suivi.

await FacebookAnalytics.enableAdvertiserTracking();

Sur iOS 17 et versions ultérieures, FBSDK v17+ lit directement la transparence de l'application pour le suivi. Utilisez votre flux ATT d'application avant d'enregistrer les événements dépendants du suivi.

Enregistrer un événement standard

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

Enregistrer un événement de valeur avec devise

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

Enregistrer une vente

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

Lire l'état de suivi

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

Source De Vérité

Re-faire la synchronisation lorsque la public __CAPGO_KEEP_0__ change en amont. src/definitions.ts. Re-run the sync when the public API changes upstream.

Section intitulée « Continuez de la section « Getting Started » »

Section intitulée « Si vous utilisez » Prise en main pour planifier le travail de plugin natif, le connecter avec Utilisation de @capgo/capacitor-facebook-analytics pour la capacité native dans Utilisation de @capgo/capacitor-facebook-analytics, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou Mettre à jour les plugins pour le détail d'implémentation dans Ajouter ou Mettre à jour les plugins, et Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans Alternatives de plugins Ionic Enterprise.