Étendre Google Analytics avec Cloud Functions

Google Analytics fournit des rapports sur les événements qui vous aident à comprendre comment les utilisateurs interagissent avec votre application. Avec Cloud Functions (1re génération), vous pouvez accéder aux événements de conversion que vous avez enregistrés à partir d'appareils Apple et Android, et déclencher des fonctions basées sur ces événements.

Seuls les événements de plate-forme Apple et Android marqués comme événements de conversion sont actuellement compatibles avec Cloud Functions. Les événements de conversion Web ne sont actuellement pas disponibles. Vous pouvez spécifier les événements qui sont des événements de conversion dans l'onglet Événements du volet Analytics de la console Firebase.

Remarque :Cloud Functions for Firebase (2e génération) n'est pas compatible avec les événements et déclencheurs décrits dans ce guide. Étant donné que les fonctions de 1re et de 2e génération peuvent coexister dans le même fichier source, vous pouvez toujours développer et déployer cette fonctionnalité avec les fonctions de 2e génération.

Déclencher une fonction Google Analytics

Cloud Functions est compatible avec le Google Analytics AnalyticsEvent. Cet événement se déclenche chaque fois qu'une activité utilisateur génère un événement de conversion. Par exemple, vous pouvez écrire une fonction qui se déclenche lorsque l'événement in_app_purchase est généré, ce qui indique qu'un achat intégré a eu lieu. Vous devez spécifier l'événement Analytics que vous souhaitez déclencher pour votre fonction à l'aide de la méthode functions.analytics.event(), puis gérer l'événement dans le gestionnaire d'événements onLog():

exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  // ...
});

Accéder aux attributs d'événement

Avec chaque événement Analytics, vous avez accès à tous les paramètres et propriétés utilisateur pertinents. Il s'agit d'informations sur l'utilisateur, l'appareil, l'application et les informations géographiques de l'événement. Pour obtenir la liste complète des paramètres et des propriétés utilisateur, consultez la documentation de référence sur functions.analytics.

Pour une fonction déclenchée par un achat, comme illustré dans cet exemple, vous pouvez accéder aux attributs utilisateur tels que la langue de l'utilisateur et la valeur de l'événement (valueInUSD). Ce deuxième attribut permet à l'exemple de fonction de tester s'il s'agit d'un événement de conversion à forte valeur afin d'envoyer un bon de réduction plus intéressant aux clients intéressants.

/**
 * After a user has completed a purchase, send them a coupon via FCM valid on their next purchase.
 */
exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  const user = event.user;
  const uid = user.userId; // The user ID set via the setUserId API.
  const purchaseValue = event.valueInUSD; // Amount of the purchase in USD.
  const userLanguage = user.deviceInfo.userDefaultLanguage; // The user language in language-country format.

  // For purchases above 500 USD, we send a coupon of higher value.
  if (purchaseValue > 500) {
    return sendHighValueCouponViaFCM(uid, userLanguage);
  }
  return sendCouponViaFCM(uid, userLanguage);
});
index.js

Étapes suivantes

Pour en savoir plus sur la gestion des événements Analytics dans Cloud Functions, consultez la documentation Google Analytics et la référence functions.analytics, puis essayez d'exécuter l'exemple de code coupon-on-purchase.