Google Analytics mit Cloud Functions erweitern

Google Analytics stellt Ereignisberichte bereit, mit denen Sie nachvollziehen können, wie Nutzer mit Ihrer App interagieren. Mit Cloud Functions (1. Generation) können Sie auf Conversion-Ereignisse zugreifen, die Sie auf Apple- und Android-Geräten protokolliert haben, und basierend auf diesen Ereignissen Funktionen 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 die Funktionen der 1. Generation und der 2. Generation nebeneinander in derselben Quelldatei vorhanden sein können, können Sie diese Funktionalität 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, das die Funktion auslösen soll, mit der Methode functions.analytics.event() angeben und 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 testen, ob es sich um ein Conversion-Ereignis mit hohem Umsatz 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. Versuchen Sie, das Codebeispiel coupon-on-purchase auszuführen.