Check out what’s new from Firebase at Google I/O 2022. Learn more

É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, 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 en fonction de ces événements.

Déclencher une fonction Google Analytics

Cloud Functions est compatible avec Google Analytics AnalyticsEvent . Cet événement est déclenché chaque fois que l'activité de l'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é, indiquant qu'un achat intégré a eu lieu. Vous devez spécifier l'événement Analytics pour lequel vous souhaitez déclencher votre fonction à l'aide de la méthode functions.analytics.event() et 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. Celles-ci incluent des informations sur l'utilisateur, l'appareil, l'application et des informations géographiques pour l'événement. Pour obtenir la liste complète des paramètres et des propriétés utilisateur, consultez la référence functions.analytics .

Pour une fonction déclenchée par un achat comme illustré dans cet exemple , vous souhaiterez peut-être accéder à des attributs utilisateur tels que la langue de l'utilisateur et la valeur de l'événement ( valueInUSD ). Ce deuxième attribut permet à la fonction d'échantillonnage de tester s'il s'agit d'un événement de conversion de grande valeur, afin d'envoyer un bon de réduction de valeur supérieure à des 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);
});

Prochaines étapes

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 , et essayez d'exécuter l'exemple de code coupon-on-purchase .