Google Analytics-Trigger

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 Conversion-Ereignisse zugreifen, die Sie von Apple- und Android-Geräten protokolliert haben, und basierend auf diesen Ereignissen Funktionen auslösen.

Nur Ereignisse der Apple-Plattform und Android-Geräte, die als Conversion-Ereignisse gekennzeichnet sind werden derzeit von Cloud Functions unterstützt; Web-Conversion-Ereignisse sind nicht derzeit verfügbar sind. 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. Weil 1. Generation und 2. Generation und Funktionen nebeneinander in derselben Quelldatei bestehen können, können Sie Diese Funktionen können Sie zusammen mit Funktionen der 2. Generation entwickeln und bereitstellen.

Google Analytics-Funktion auslösen

Cloud Functions unterstützt die Google Analytics AnalyticsEvent Dieses Ereignis wird ausgelöst, wenn Nutzeraktivitäten ein Conversion-Ereignis generieren. Sie könnten z. B. eine Funktion schreiben, wird ausgelöst, wenn das in_app_purchase-Ereignis generiert wird. Dies bedeutet, dass ein ein In-App-Kauf erfolgt ist. Sie müssen das Analytics-Ereignis angeben, das möchten Sie Ihre Funktion mithilfe der Methode functions.analytics.event() und verarbeiten das Ereignis innerhalb der onLog() Ereignis-Handler:

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 über die Nutzenden, Gerät, die App und die geografischen Daten 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.