Déclencheurs Google Analytics

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.

Déclencher une Google Analytics fonction

Cloud Functions est compatible avec Google Analytics AnalyticsEvent. Cet événement est déclenché 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 via l'application a été effectué. Vous devez spécifier l'événement Analytics que vous souhaitez déclencher à l'aide de la functions.analytics.event() méthode et gérer l'événement dans le onLog() gestionnaire d'événements :

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

Accéder aux attributs d'événement

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

Pour une fonction déclenchée par un achat, comme illustré dans cet exemple, vous pouvez 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 exemple de tester s'il s'agit d'un événement de conversion à forte valeur ajoutée, afin d'envoyer un coupon de plus grande valeur aux clients importants.

/**
 * 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 documentation de référence sur functions.analytics, puis essayez d'exécuter l'exemple de code coupon-on-purchase.