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

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

لا تتوفّر حاليًا في "Cloud Functions" سوى أحداث منصة Apple وAndroid التي تم وضع علامة عليها كأحداث إحالات ناجحة، ولا تتوفّر حاليًا أحداث الإحالات الناجحة على المواقع الإلكترونية. يمكنك تحديد الأحداث التي تُعدّ أحداث إحالات ناجحة في صفحة إحصاءات Google > الأحداث في وحدة تحكّم 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.