مَعلمات وشروط "الإعداد عن بُعد"

تتيح لك ميزة Firebase Remote Config التحكّم ديناميكيًا في سلوك تطبيقاتك ومظهرها بدون أن يحتاج المستخدمون إلى تنزيل تحديث للتطبيق أو إعادة نشر الخلفية.

لضبط تطبيقاتك، عليك تحديد المَعلمات (أزواج المفتاح/القيمة) في Remote Config واستخدامها في تطبيقك أو رمز الخلفية. يمكنك أيضًا تحديد الشروط (قواعد الاستهداف) لتعيين القيم الشرطية التي تلغي القيم التلقائية لشرائح جمهور أو بيئات أو معايير مخصّصة محدّدة.

ينظّم Remote Config المَعلمات والشروط في نماذج. استنادًا إلى البنية الأساسية، يمكنك استخدام نماذج العميل أو نماذج الخادم أو كليهما:

  • المَعلمات والشروط في نماذج العملاء: يمكنك عرض الإعدادات على نُسخ تطبيق العميل على منصات Apple وAndroid والويب وFlutter وUnity وC++. يمكنك استهداف نُسخ التطبيق باستخدام شرائح جمهور Google Analytics وإصدارات التطبيق والنظام الأساسي ولغة الجهاز والبلد والشرائح المئوية للمستخدمين والإشارات المخصّصة من جهة العميل.

  • المَعلمات والشروط في نماذج الخادم: يمكنك عرض الإعدادات لبيئات الخلفية، مثل Cloud Run أو Cloud Functions for Firebase أو الخوادم المستندة إلى حاويات باستخدام Firebase Admin SDK للغات Node.js وPython وGo وJava. يمكنك تقييم المَعلمات من جهة الخادم بوقت استجابة يقترب من الصفر باستخدام الإشارات المخصّصة من جهة الخادم وعمليات الطرح بنسبة مئوية عشوائية.

مقارنة نماذج العميل والخادم

تخدم نماذج العميل والخادم بُنى مختلفة وتتوافق مع حزم تطوير برامج (SDK) وقواعد استهداف مختلفة. استخدِم الجدول التالي لمعرفة نوع النموذج الذي يناسب حالة الاستخدام:

الميزة نماذج العملاء نماذج الخوادم
البيئات المستهدَفة تطبيقات العملاء (Apple وAndroid والويب وFlutter وUnity وC++‎) بيئات الخادم (Cloud Run وCloud Functions for Firebase وGKE وخدمات الخلفية)
حِزم SDK المتوافقة حِزم تطوير البرامج (SDK) لعملاء Firebase Firebase Admin SDK (Node.js وPython وGo وJava)
نموذج التقييم يتم جلبها وتخزينها مؤقتًا على أجهزة العملاء، ويتم تفعيلها من خلال رمز التطبيق يتم تحميلها في ذاكرة الخادم، ويتم تقييمها لكل طلب مع وقت استجابة يقارب الصفر
قواعد الحالة إصدار التطبيق، ونظام التشغيل/النظام الأساسي، ولغة الجهاز، والبلد/المنطقة، وAnalytics شرائح الجمهور وخصائص المستخدمين، والمستخدم في شريحة مئوية عشوائية، وأول مرة يتم فيها فتح التطبيق، والإشارات المخصّصة للعملاء مستخدم في نسبة مئوية عشوائية، إشارات مخصّصة للخادم
حالات الاستخدام الشائعة عمليات طرح الميزات والعروض الترويجية الموسمية ومظاهر واجهة المستخدم وA/B Testing والتخصيص اختيار الطلبات والنماذج المستندة إلى الذكاء الاصطناعي، وعلامات الميزات من جهة الخادم، وتحديد معدّل الطلبات في الخلفية، والتوجيه الديناميكي
دليل مفصّل المَعلمات في نماذج العملاء المَعلمات في نماذج الخادم

المفاهيم الأساسية

سواء كنت تعمل مع نماذج من جهة العميل أو نماذج من جهة الخادم، يتشارك Remote Config المفاهيم الأساسية:

المَعلمات

المَعلمات هي أزواج المفتاح/القيمة التي تحدّدها في وحدة تحكّم Firebase أو باستخدام واجهات برمجة تطبيقات الخلفية لميزة "Remote Config".

  • مفاتيح المَعلمات: معرّفات سلاسل لمَعلماتك يمكن أن يصل طول المفاتيح إلى 256 حرفًا، ويجب أن تبدأ بشرطة سفلية أو حرف إنجليزي (A-Z، a-z)، ويمكن أن تتضمّن أرقامًا.
  • قيم المَعلمات: هي القيم المحدّدة لمَعلماتك. يتم تخزين القيم كسلاسل، ولكن يمكنك اختيار أنواع البيانات في وحدة التحكّم للتحقّق من صحة القيم وفقًا لتنسيقات مثل String أو Boolean أو Number أو JSON.
  • القيم التلقائية: القيمة الأساسية التي يتم تحديدها في حال عدم تطبيق أي قواعد شرطية. يمكنك تحديد القيم التلقائية داخل التطبيق في الرمز البرمجي، بالإضافة إلى القيم التلقائية للنماذج في الخلفية في Remote Config.

الشروط والقواعد والقيم الشرطية

تتيح لك الشروط استهداف شرائح معيّنة من مستخدمي التطبيق أو طلبات الخادم باستخدام قيم مَعلمات مخصّصة:

  • القواعد: معايير فردية يتم تقييمها وفقًا للبيانات الوصفية للعميل أو سياقات الطلبات (مثل رقم الإصدار أو البلد أو الإشارة المخصّصة).
  • الشروط: مجموعات مُسمّاة من قاعدة واحدة أو أكثر. يجب أن يتم تقييم جميع القواعد ضمن شرط معيّن على أنّها true لكي يتم تقييم الشرط على أنّه true.
  • القيم الشرطية: هي قيم بديلة يتم تعيينها لمَعلمة عندما يكون تقييم الشرط true. إذا تم تقييم شروط متعددة على أنّها true، تكون الأولوية للشرط الذي له الأولوية القصوى في وحدة تحكّم Firebase.

مجموعات المَعلمات

لتنظيم الإعدادات التي تتضمّن عشرات أو مئات المَعلمات، يمكنك استخدام مجموعات المَعلمات. توفّر المجموعات تنظيمًا مرئيًا في وحدة تحكّم Firebase وتجميعًا منطقيًا في واجهة برمجة التطبيقات REST API.

  • يمكن أن تنتمي المَعلمة إلى مجموعة واحدة فقط في كل مرة.
  • تظل مفاتيح المَعلمات فريدة بشكل عام في مشروعك بغض النظر عن التجميع.
  • لا يؤدي التجميع إلى تغيير كيفية الإشارة إلى قيم المَعلمات في رمز حزمة تطوير البرامج (SDK).

للحصول على تعليمات حول إنشاء المجموعات وإدارتها، يُرجى الاطّلاع على أدلة المَعلمات التفصيلية الخاصة بالعميل أو الخادم.

إصدارات النماذج والعودة إلى الإصدارات السابقة

في كل مرة تعدّل فيها المَعلمات أو الشروط وتنشرها في Remote Config، تنشئ Firebase نسخة جديدة من النموذج وتخزّنها. يمكنك عرض سجلّ التعديلات ومقارنة التغييرات بين النُسخ والعودة إلى نسخة سابقة متى لزم الأمر.

لمزيد من المعلومات حول إدارة إصدارات النماذج، يُرجى الاطّلاع على المقالة إدارة إصدارات نماذج Remote Config.

الحصص والحدود

في مشروع Firebase، يفرض Remote Config الحدود التالية:

  • المَعلمات: ما يصل إلى 3,000 مَعلمة لكل مشروع
  • الشروط: ما يصل إلى 2,000 شرط لكل مشروع.
  • طول مفتاح المَعلمة: ما يصل إلى 256 حرفًا
  • إجمالي طول سلسلة القيم: ما يصل إلى 1,000,000 حرف في جميع قيم المَعلمات ضمن المشروع

للحصول على قائمة كاملة بالحدود القصوى، يُرجى الاطّلاع على الحصص والحدود القصوى.

الخطوات التالية