Google Analytics mit Cloud Functions erweitern

Google Analytics bietet Ereignisberichte, mit denen Sie nachvollziehen können, wie Nutzer mit Ihrer App interagieren. Mit Cloud Functions (1. Generation) können Sie auf Konvertierungsereignisse 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. 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. Generation und der 2. Generation in derselben Quelldatei nebeneinander existieren können, können Sie diese Funktion weiterhin zusammen mit Funktionen der 2. Generation entwickeln und bereitstellen.

Google Analytics-Funktion auslösen

Cloud Functions unterstützt Google Analytics AnalyticsEvent. Dieses Ereignis wird ausgelöst, wenn durch Nutzeraktivitäten 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 hinweist, dass ein In-App-Kauf stattgefunden hat. Sie müssen das Analytics-Ereignis angeben, mit dem Sie die Funktion mit der Methode functions.analytics.event() auslösen möchten, und das Ereignis im Ereignis-Handler onLog() 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 zu geografischen Informationen für das Ereignis. Eine vollständige Liste der Parameter und Nutzereigenschaften finden Sie in der functions.analytics-Referenz.

Für eine kaufausgelöste Funktion wie in diesem Beispiel können Sie auf Nutzerattribute wie die Sprache des Nutzers und den Wert des Ereignisses (valueInUSD) zugreifen. Mit diesem zweiten Attribut kann die Beispielfunktion prüfen, ob es sich um ein Conversion-Ereignis mit hohem Umsatzpotenzial 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 Umgang mit Analytics-Ereignissen in Cloud Functions finden Sie in der Google Analytics-Dokumentation und in der functions.analytics-Referenz. Außerdem können Sie das Codebeispiel Gutschein beim Kauf ausführen.