Salta al contenuto principale

Facebook Analytics Plugin Capacitor

Analytics di Meta/Facebook App Events con eventi standard, log degli acquisti, parametri di valuta e controlli sul tracciamento per gli inserzionisti

Installa

bun add @capgo/capacitor-facebook-analytics bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-facebook-analytics
  • pnpm add @capgo/capacitor-facebook-analytics
  • yarn add @capgo/capacitor-facebook-analytics

Guida

Come usare Facebook Analytics in Capacitor

Utilizzo di @capgo/capacitor-facebook-analytics

Analytics degli App Events di Meta/Facebook per le app Capacitor su iOS e Android.

Installa

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

Cosa espone questo plugin

  • initAppEvents - Attiva manualmente i Facebook App Events.
  • logEvent - Logga App Events standard o custom con parametri, valore e valuta.
  • logPurchase - Logga eventi di acquisto con importo e valuta.
  • enableAdvertiserTracking - Abilita il tracciamento nativo degli inserzionisti, dove supportato.
  • disableAdvertiserTracking - Disabilita il tracciamento nativo degli inserzionisti, dove supportato.
  • getAdvertiserTrackingStatus - Leggi lo stato attuale del tracciamento degli inserzionisti.
  • getPluginVersion - Leggi la versione del plugin nativo.

Esempio d'uso

logEvent

Logga un evento standard con parametri Facebook.

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

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

logEvent con valore e valuta

Invia eventi standard con valore tramite il fb_currency parametro.

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

Registra un evento di acquisto.

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

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

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-facebook-analytics

Se stai usando Utilizzo di @capgo/capacitor-facebook-analytics per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-facebook-analytics per i dettagli implementativi in @capgo/capacitor-facebook-analytics, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ del plugin Facebook Analytics

Come installo il plugin Facebook Analytics in un'app Capacitor?

Esegui "bun add @capgo/capacitor-facebook-analytics" (oppure "npm install @capgo/capacitor-facebook-analytics"), poi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-facebook-analytics" nel tuo code dell'app.

@capgo/capacitor-facebook-analytics funziona con React, Vue e Angular?

Sì. Facebook Analytics è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, incluso Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-facebook-analytics?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-facebook-analytics è gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-facebook-analytics/ e il pacchetto è gratuito e installabile da npm. Segnalazioni di bug e pull request sono benvenute.

Posso aggiornare code che usa Facebook Analytics senza passare dalla revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica le modifiche a Facebook Analytics senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo