Google Analytics tetikleyicileri

Google Analytics, kullanıcıların uygulamanızla nasıl etkileşimde bulunduğunu anlamanıza yardımcı olan etkinlik raporları sağlar. Cloud Functions (1. nesil) ile Apple ve Android cihazlardan kaydettiğiniz dönüşüm etkinliklerine erişebilir ve bu etkinliklere göre işlevleri tetikleyebilirsiniz.

Cloud Functions şu anda yalnızca dönüşüm etkinliği olarak işaretlenmiş Apple platformu ve Android etkinliklerini desteklemektedir. Web dönüşüm etkinlikleri şu anda kullanılamamaktadır.

Hangi etkinliklerin dönüşüm etkinliği olduğunu Firebase konsolunun Analytics bölmesinde Etkinlikler sekmesinden belirtebilirsiniz.

Not: Cloud Functions for Firebase (2. nesil), bu kılavuzda açıklanan etkinlikler ve tetikleyiciler için destek sağlamaz. 1. nesil ve 2. nesil işlevler aynı kaynak dosyada yan yana bulunabileceğinden bu işlevi 2. nesil işlevlerle birlikte geliştirip dağıtmaya devam edebilirsiniz.

Google Analytics işlevini tetikleme

Cloud Functions, Google Analytics AnalyticsEvent destekler. Bu etkinlik, kullanıcı etkinliği bir dönüşüm etkinliği oluşturduğunda tetiklenir. Örneğin, in_app_purchase etkinliği oluşturulduğunda tetiklenerek uygulama içi satın alma işleminin gerçekleştiğini belirten bir işlev yazabilirsiniz. İşlevinizi tetiklemek istediğiniz Analytics etkinliğini functions.analytics.event() yöntemini kullanarak belirtmeniz ve etkinliği onLog() etkinlik işleyicide işlemeniz gerekir:

exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  // ...
});

Etkinlik özelliklerine erişim

Her Analytics etkinliğinde, ilgili tüm parametrelere ve kullanıcı özelliklerine erişebilirsiniz. Bunlar arasında kullanıcı, cihaz, uygulama ve etkinlikle ilgili coğrafi bilgiler yer alır. Parametrelerin ve kullanıcı özelliklerinin tam listesi için functions.analytics referansına bakın.

Bu örnekte gösterildiği gibi satın alma işlemiyle tetiklenen bir işlev için kullanıcının dili ve etkinliğin değeri (valueInUSD) gibi kullanıcı özelliklerine erişmek isteyebilirsiniz. Bu ikinci özellik, örnek işlevin değerli müşterilere daha yüksek değerli bir kupon göndermek için bunun yüksek değerli bir dönüşüm etkinliği olup olmadığını test etmesine olanak tanır.

/**
 * 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

Sonraki adımlar

Cloud Functions'da Analytics etkinliklerini işleme hakkında daha fazla bilgi edinmek için Google Analytics belgelerine ve functions.analytics referansına bakın ve coupon-on-purchase kod örneğini çalıştırmayı deneyin.