مشغّلات "إحصاءات 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.