Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Étendez Google Analytics avec Cloud Functions

Google Analytics fournit des rapports d'é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 iOS et Android et déclencher des fonctions en fonction de ces événements.

Déclencher une fonction Google Analytics

Cloud Functions prend en charge l'événement 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 in_app_purchase 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 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 de valeur élevée, afin d'envoyer un coupon de valeur plus élevée à des clients précieux.

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