Iniziare

Copiare un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo 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.

Installare

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

Importa

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

Setup nativo

Configura l'ID dell'app Meta e il token client nella app nativa. Il plugin non crea questi valori per te.

iOS

Aggiungi i tuoi valori Meta a 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

Aggiungi i valori 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" />

Aggiungi i risorse di stringa 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>

Abilita il tracciamento degli annunci pubblicitari

Chiamare questo dopo il flusso di consenso consente il tracciamento.

await FacebookAnalytics.enableAdvertiserTracking();

Sui dispositivi iOS 17 e superiori, FBSDK v17+ legge la trasparenza del tracciamento dell'app direttamente. Utilizza il flusso di ATT del tuo'app prima di registrare gli eventi dipendenti dal tracciamento.

Log A Evento Standard

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

Log un evento di valore con valuta

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

Log un acquisto

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

Leggi lo stato di tracciamento

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

Fonte di verità

Questa pagina è generata dal plugin’s src/definitions.ts. Riavvia la sincronizzazione quando il pubblico API cambia upstream.

Continua da Inizia con l'installazione

Se stai utilizzando Inizia con l'installazione per pianificare il lavoro del plugin nativo, connettilo con Utilizza @capgo/capacitor-facebook-analytics per la capacità nativa in Utilizza @capgo/capacitor-facebook-analytics, Capgo Directory dei plugin per il flusso di lavoro del prodotto in Capgo Directory dei plugin, Plugin Capacitor sviluppati da Capgo per i dettagli di implementazione in Plugin Capacitor sviluppati da Capgo, Aggiunta o Aggiornamento di Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento di Plugin, e Alternative per Plugin Enterprise di Ionic per il workflow del prodotto in Alternative per Plugin Enterprise di Ionic.