Aller directement au contenu principal
Retour aux plugins
@capgo/capacitor-facebook-analytics
Tutoriel
par github.com/Cap-go

Analytique Facebook

Analytique Meta/Facebook App Events avec des événements standards, enregistrement des achats, paramètres de devise et contrôles de suivi des annonceurs

Guide

Tutoriel sur l'analytique Facebook

Utilisation de @capgo/capacitor-facebook-analytics

Analytiques d'événements d'applications Facebook pour les applications Capacitor sur iOS et Android.

Installer

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

Ce plugin expose

  • initAppEvents - Activer manuellement les événements d'applications Facebook.
  • logEvent - Enregistrer les événements d'applications standard ou personnalisés avec des paramètres, une valeur et une devise.
  • logPurchase - Enregistrer les événements d'achat avec une somme et une devise.
  • enableAdvertiserTracking - Activer le suivi publicitaire natif où cela est pris en charge.
  • disableAdvertiserTracking - Désactiver le suivi publicitaire natif où cela est pris en charge.
  • getAdvertiserTrackingStatus - Lire le statut actuel du suivi publicitaire.
  • getPluginVersion - Lire la version native du plugin.

Exemple d'utilisation

logEvent

Enregistrer un événement standard avec des paramètres Facebook.

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

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

logEvent avec valeur et devise

Envoyer des événements standards porteurs de valeur avec le fb_currency paramètre.

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

Enregistrer un événement d'achat.

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

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

Référence complète