Google Analytics mit Cloud Functions erweitern

Google Analytics bietet Ereignisberichte, mit denen Sie verstehen wie Nutzer mit Ihrer App interagieren. Mit Cloud Functions (1. Generation) können Sie auf Conversion-Ereignisse zugreifen, die Sie von Apple- und Android-Geräten protokolliert haben, und Funktionen basierend auf diesen Ereignissen auslösen.

Cloud Functions unterstützt derzeit nur Apple-Plattform- und Android-Ereignisse, die als Conversion-Ereignisse gekennzeichnet sind . Web-Conversion-Ereignisse sind derzeit nicht verfügbar.Cloud Functions Auf dem Tab Ereignisse im Bereich Analytics der Firebase Console können Sie festlegen, welche Ereignisse Conversion Ereignisse sind.

Hinweis: Cloud Functions for Firebase (2. Generation) unterstützt die in diesem Leitfaden beschriebenen Ereignisse und Trigger nicht. Da Funktionen der 1. und 2. Generation in derselben Quelldatei nebeneinander existieren können, können Sie diese Funktion weiterhin zusammen mit Funktionen der 2. Generation entwickeln und bereitstellen.

Eine Google Analytics Funktion auslösen

Cloud Functions unterstützt Google Analytics AnalyticsEvent. Dieses Ereignis wird immer dann ausgelöst, wenn durch eine Nutzeraktivität ein Conversion-Ereignis generiert wird. Sie können beispielsweise eine Funktion schreiben, die ausgelöst wird, wenn das Ereignis in_app_purchase generiert wird, was darauf hindeutet, dass ein In-App-Kauf stattgefunden hat. Sie müssen das Analytics Ereignis angeben, das Ihre Funktion auslösen soll, indem Sie die functions.analytics.event() Methode verwenden. Außerdem müssen Sie das Ereignis im onLog() Ereignis-Handler verarbeiten:

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

Auf Ereignisattribute zugreifen

Bei jedem Analytics Ereignis haben Sie Zugriff auf alle relevanten Parameter und Nutzereigenschaften. Dazu gehören Informationen zum Nutzer, zum Gerät, zur App und geografische Informationen zum Ereignis. Eine vollständige Liste der Parameter und Nutzereigenschaften finden Sie in der functions.analytics Referenz.

Für eine durch einen Kauf ausgelöste Funktion, wie in diesem Beispiel, veranschaulicht, möchten Sie möglicherweise auf Nutzerattribute wie die Sprache des Nutzers und den Wert des Ereignisses (valueInUSD) zugreifen. Mit diesem zweiten Attribut kann die Beispielfunktion testen, ob es sich um ein Conversion-Ereignis mit hohem Wert handelt, um wertvollen Kunden einen Gutschein mit höherem Wert zu senden.

/**
 * 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

Nächste Schritte

Weitere Informationen zum Verarbeiten von Analytics Ereignissen in Cloud Functions, finden Sie in der Google Analytics Dokumentation und in der functions.analytics Referenz. Sie können auch das Codebeispiel coupon-on-purchase ausführen.