توسيع نطاق "إحصاءات Google" باستخدام وظائف السحابة الإلكترونية

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

لا يدعم Cloud Functions سوى أحداث نظام التشغيل Android الأساسي والأحداث الأساسية من Apple، وأحداث الإحالات الناجحة على المواقع الإلكترونية غير متاحة حاليًا. يمكنك تحديد الأحداث التي تمثّل أحداث إحالات ناجحة في علامة التبويب الأحداث ضمن لوحة الإحصاءات ضمن وحدة تحكُّم Firebase.

ملاحظة: لا يتوافق "الوظائف السحابية لبرنامج Firebase" (الجيل الثاني) مع الأحداث والعوامل المشغِّلة الموضَّحة في هذا الدليل. بما أنّه يمكن لدوال الجيل الأول والجيل الثاني العمل جنبًا إلى جنب في الملف المصدر نفسه، لا يزال بإمكانك تطوير هذه الوظيفة ونشرها مع دوال الجيل الثاني.

تشغيل وظيفة في "إحصاءات Google"

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

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

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

مع كل حدث في "إحصاءات Google"، يمكنك الوصول إلى جميع المَعلمات وخصائص المستخدمين ذات الصلة. وتشمل هذه المعلومات معلومات عن المستخدم والجهاز والتطبيق والمعلومات الجغرافية للحدث. للحصول على القائمة الكاملة للمَعلمات وخصائص المستخدمين، يُرجى الاطّلاع على مرجع 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

الخطوات اللاحقة

لمزيد من المعلومات عن التعامل مع أحداث "إحصاءات Google" في Cloud Functions، يمكنك الاطّلاع على مستندات "إحصاءات Google" والمرجع functions.analytics، وتجربة عرض نموذج الرمز قسيمة عند الشراء.