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

تتيح لك 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 حرف في جميع قيم المَعلمات ضمن المشروع

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

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