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

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

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

ملاحظة: 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.