مشغّلات "إحصاءات Google"

يوفّر Google Analytics تقارير الأحداث التي تساعدك في فهم كيفية تفاعل المستخدِمين مع تطبيقك. باستخدام Cloud Functions (الجيل الأول)، يمكنك الوصول إلى أحداث الإحالات الناجحة التي سجّلتها من أجهزة Apple وAndroid وبدء وظائف استنادًا إلى تلك الأحداث.

بدء دالة Google Analytics

تتيح Cloud Functions استخدام Google Analytics AnalyticsEvent. يتمّ بدء هذا الحدث كلّما أدّى نشاط المستخدِم إلى إنشاء حدث إحالة ناجحة. على سبيل المثال، يمكنك كتابة دالة يتم بدء تشغيلها عند إنشاء الحدث in_app_purchase، ما يشير إلى حدوث عملية شراء داخل التطبيق. يجب تحديد حدث Analytics الذي تريد بدء الدالة باستخدامه باستخدام الأسلوب functions.analytics.event() ، ومعالجة الحدث ضمن معالج الحدث onLog():

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

الوصول إلى سمات الأحداث

مع كلّ حدث من أحداث Analytics، يمكنك الوصول إلى جميع المَعلمات وخصائص المستخدِمين ذات الصلة. وتشمل هذه المعلومات معلومات عن المستخدِم والجهاز والتطبيق والمعلومات الجغرافية للحدث. للحصول على القائمة الكاملة للمَعلمات وخصائص المستخدِمين، اطّلِع على مرجع functions.analytics.

بالنسبة إلى الدالة التي يتم تنشيطها من خلال عملية شراء كما هو موضّح في هذا العيّنة، قد تحتاج إلى الوصول إلى سمات المستخدِم، مثل لغة المستخدِم و قيمة الحدث (valueInUSD). تسمح هذه السمة الثانية للعيّنة الدالة باختبار ما إذا كان هذا هو حدث إحالة ناجحة ذي قيمة عالية، وذلك لإرسال قسيمة ذات قيمة أعلى إلى العملاء المهمّين.

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

الخطوات التالية

لمزيد من المعلومات عن معالجة أحداث Analytics في Cloud Functions، اطّلِع على مستندات Google Analytics ومرجع functions.analytics، وحرِّر رمز النموذج التالي: coupon-on-purchase.