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.

Google Analytics-Funktion auslösen

Cloud Functions unterstützt den Google Analytics AnalyticsEvent. Dieses Ereignis wird ausgelöst, wenn Nutzeraktivitäten ein Conversion-Ereignis generieren. Sie könnten beispielsweise eine Funktion schreiben, die ausgelöst wird, wenn das Ereignis in_app_purchase generiert wird, und anzeigt, 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 über den Nutzer, das Gerät und die App sowie geografische Daten für das Ereignis. Eine vollständige Liste der Parameter und Nutzereigenschaften finden Sie in der Referenz zu functions.analytics.

Bei einer durch einen Kauf ausgelösten Funktion, wie in diesem Beispiel dargestellt, möchten Sie möglicherweise auf Nutzerattribute wie die Sprache des Nutzers und den Ereigniswert (valueInUSD) zugreifen. Mit diesem zweiten Attribut kann die Beispielfunktion testen, ob es sich um ein Conversion-Ereignis mit hohem Wert handelt, um einen Gutschein mit höherem Wert an wertvolle Kunden 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);
});

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.