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