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

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

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

ملاحظة: لا توفّر الإصدارات القديمة من Cloud Functions for Firebase (الجيل الثاني) دعمًا للأحداث وعوامل التفعيل الموضّحة في هذا الدليل. بما أنّه يمكن أن تتعايش دوال الجيل الأول والجيل الثاني بجانب بعضها في ملف المصدر نفسه، سيظل بإمكانك تطوير هذه الوظيفة ونشرها مع دوال الجيل الثاني.

بدء دالة 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.