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

Google Analytics-Funktion auslösen

Cloud Functions unterstützt Google Analytics AnalyticsEvent. Dieses Ereignis wird immer dann 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. Das bedeutet, dass ein In-App-Kauf erfolgt ist. Sie müssen das Analytics-Ereignis angeben, mit dem Ihre Funktion ausgelöst werden soll. Verwenden Sie dazu die Methode functions.analytics.event() und verarbeiten Sie das Ereignis im Ereignis-Handler onLog():

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 im Beispiel dargestellt, 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 prüfen, 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.