مَعلمات وشروط "الإعداد عن بُعد" في نماذج العملاء

اختيار نوع النموذج:

نماذج العميل نماذج الخادم

يمكنك عرض مَعلمات Remote Config وقيمها من نماذج العميل إلى أي مثيلات للتطبيق تنفّذ حِزم تطوير البرامج (SDK) للعميل في Firebase من أجل Remote Config، بما في ذلك تطبيقات Apple وAndroid والويب وFlutter وUnity وC++.

عند استخدام وحدة تحكّم Firebase أو Remote Config واجهات برمجة التطبيقات الخلفية، يمكنك تحديد مَعلمة واحدة أو أكثر (أزواج المفتاح-القيمة) وتقديم قيم تلقائية داخل التطبيق لهذه المَعلمات. يمكنك إلغاء القيم التلقائية داخل التطبيق من خلال تحديد قيم المَعلمات. مفاتيح المَعلمات وقيم المَعلمات هي سلاسل، ولكن يمكن تحويل قيم المَعلمات إلى أنواع بيانات أخرى عند استخدام هذه القيم في تطبيقك.

ملاحظة مهمة: لا تخزِّن بيانات سرية في مفاتيح أو قيم المَعلمة Remote Config. يتم تشفير بيانات Remote Config أثناء نقلها، ولكن يمكن للمستخدمين النهائيين الوصول إلى أي مَعلمة تلقائية أو تم استرجاعها من Remote Config تكون متاحة لنسخة تطبيق العميل.

باستخدام وحدة تحكّم Firebase، Admin SDK أو Remote Config REST API، يمكنك إنشاء قيم تلقائية جديدة للمَعلمات، بالإضافة إلى قيم شرطية تُستخدَم لاستهداف مجموعات من نُسخ التطبيق. في كل مرة تعدّل فيها إعداداتك في وحدة تحكّم Firebase، ينشئ Firebase إصدارًا جديدًا من نموذج Remote Config وينشره. يتم تخزين الإصدار السابق، ما يتيح لك استرداده أو الرجوع إليه عند الحاجة. تتوفّر هذه العمليات في وحدة تحكّم Firebase وFirebase Admin SDK وREST API، ويتم توضيحها بشكل أكثر تفصيلاً في إدارة إصدارات نموذج Remote Config.

يوضّح هذا الدليل المَعلمات والشروط والقواعد والقيم الشرطية وكيفية تحديد أولويات قيم المَعلمات المختلفة في الخلفية Remote Config وفي تطبيقك، كما يقدّم تفاصيل عن أنواع القواعد المستخدَمة لإنشاء الشروط.

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

يتم استخدام شرط لاستهداف مجموعة من مثيلات التطبيق. تتألف الشروط من قاعدة واحدة أو أكثر يجب أن يتم تقييمها على أنّها true لكي يتم تقييم الشرط على أنّه true لمثيل تطبيق معيّن. إذا كانت قيمة القاعدة غير محدّدة (على سبيل المثال، عندما لا تتوفّر أي قيمة)، يتم تقييم هذه القاعدة على أنّها false.

على سبيل المثال، يمكن أن تعرض مَعلمة تحدّد صفحة البداية في تطبيق صورًا مختلفة استنادًا إلى نوع نظام التشغيل باستخدام القاعدة if device_os = Android:

أو يمكن استخدام شرط زمني للتحكّم في وقت عرض تطبيقك للعناصر الترويجية الخاصة.

يمكن أن تتضمّن المَعلمة قيمًا شرطية متعددة تستخدم شروطًا مختلفة، ويمكن أن تتشارك المَعلمات في الشروط ضمن مشروع واحد. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات DevOps ومعدّل الاهتمام بالتطبيق > الإعداد عن بُعد > المَعلمات للاطّلاع على النسبة المئوية لعمليات الاسترجاع لكل قيمة شرطية خاصة بكل مَعلمة. يشير هذا المقياس إلى النسبة المئوية للطلبات التي تلقّت كل قيمة في آخر 24 ساعة.

إضافة الشروط أو تعديلها أو إعادة ترتيبها أو حذفها باستخدام وحدة تحكّم Firebase

يمكنك إنشاء شروط الاستهداف وتعديلها وإعادة ترتيبها وحذفها في وحدة تحكّم Firebase. تتم مشاركة الشروط بين المَعلمات ضِمن المشروع. إليك كيفية إدارة الشروط:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات تطوير البرامج وإشراك المستخدمين > Remote Config > الشروط (أو اختَر إدارة الشروط من صفحة المَعلمات).
2. إضافة شرط: انقر على إضافة شرط (أو إنشاء الشرط الأول)، وأدخِل اسمًا يحدّد هدف الاستهداف، ثم اختَر قاعدة استهداف واحدة أو أكثر.
3. تعديل شرط: انقر على اسم الشرط أو رمز التعديل، وعدِّل القواعد حسب الحاجة، ثم انقر على حفظ.
4. تغيير أولوية الشرط: في صفحة الشروط، اسحب الشروط من مقبض السحب لإعادة ترتيبها. تحظى الشروط الأعلى في القائمة بالأولوية على الشروط الأدنى في القائمة.
5. حذف شرط: انقر على رمز الحذف بجانب الشرط الذي تريد إزالته. إذا كانت أي مَعلمة تشير إلى الشرط، ستؤدي إزالته إلى إزالة القيم الشرطية المرتبطة به أيضًا.

بعد حفظ التغييرات التي أجريتها على الشرط، انشر النموذج باستخدام نشر التغييرات.

قيود الإصدار السادس من بروتوكول الإنترنت (IPv6) مع ميزة "التحكّم في الوصول المستند إلى عنوان IP"

Remote Config لا تتوافق بشكل كامل مع الإصدار 6 من بروتوكول الإنترنت (IPv6) عند استخدامها مع سياسات الوصول المستندة إلى عناوين IP. إذا كانت مؤسستك تحظر الوصول إلى نطاقات محددة من عناوين IP العامة، قد يؤدي الاتصال من خلال شبكة IPv6 إلى حدوث المشاكل التالية:

• الوصول إلى وحدة التحكّم: قد لا تتمكّن من استخدام ميزات معيّنة Remote Configفي وحدة تحكّم Firebase، مثل تحميل البيانات أو إعداد الاستهداف.
• وصول العميل: قد تواجه تطبيقات العميل أخطاء PERMISSION_DENIED.

لمنع حدوث هذه المشاكل، اضبط شبكتك لاستخدام IPv4 أو أضِف نطاقات عناوين IP المطلوبة في Firebase إلى القائمة المسموح بها في مؤسستك.

أولوية قيمة المَعلمة

قد تتضمّن المَعلمة عدّة قيم شرطية مرتبطة بها. تحدّد القواعد التالية القيمة التي يتم جلبها من نموذج Remote Config، والقيمة التي يتم استخدامها في نسخة تطبيق معيّنة في وقت معيّن:

1. أولاً، يتم تطبيق القيم الشرطية على أي شروط يتم تقييمها على أنّها true لطلب عميل معيّن. إذا تم تقييم عدة شروط على أنّها true، سيكون الشرط الأعلى ترتيبًا في واجهة مستخدم وحدة تحكّم Firebase هو الشرط الذي له الأولوية، وسيتم تقديم القيم الشرطية المرتبطة بهذا الشرط عندما يجلب التطبيق القيم من الخلفية. يمكنك تغيير أولوية الشروط من خلال سحب الشروط وإفلاتها في صفحة الشروط.

2. إذا لم تكن هناك قيم شرطية مع شروط يتم تقييمها على أنّها true، يتم توفير القيمة التلقائية لـ Remote Config عندما يجلب تطبيق قيمًا من الخلفية. إذا لم تكن إحدى المَعلمات متوفّرة في الخلفية، أو إذا تم ضبط القيمة التلقائية على استخدام القيمة التلقائية داخل التطبيق، لن يتم تقديم أي قيمة لهذه المَعلمة عندما يجلب التطبيق القيم.

   ملاحظة: عند استخدام المَعلمة Remote Config في تجربة نشطة Firebase A/B Testing، تكون الأولوية لقيم التجربة على أي قيم شرطية خاصة بالمَعلمة Remote Config.

في تطبيقك، يتم عرض قيم المَعلمات من خلال طرق get وفقًا لقائمة الأولوية التالية

1. إذا تم استرداد قيمة من الخلفية ثم تفعيلها، سيستخدم التطبيق القيمة المستردّة. تكون قيم المَعلمات المفعَّلة ثابتة.

2. إذا لم يتم استرداد أي قيمة من الخلفية، أو إذا لم يتم تفعيل القيم التي تم استردادها من الخلفية Remote Config، سيستخدم التطبيق القيمة التلقائية داخل التطبيق.

   لمزيد من المعلومات حول الحصول على القيم التلقائية وتعيينها، راجِع مقالة تنزيل الإعدادات التلقائية لنموذج Remote Config.

3. إذا لم يتم ضبط قيمة تلقائية داخل التطبيق، سيستخدم التطبيق قيمة ثابتة (مثل 0 لـ int وfalse لـ boolean).

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

أنواع بيانات قيم المَعلمات

تتيح لك Remote Config اختيار نوع بيانات لكل مَعلمة، كما تتحقّق من صحة جميع قيم Remote Config مقارنةً بهذا النوع قبل تعديل أحد النماذج. يتم تخزين نوع البيانات وعرضه عند تلقّي طلب getRemoteConfig.

أنواع البيانات المتوافقة هي:

• String
• Boolean
• Number
• JSON

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

ملاحظة: لا يؤثر اختيار نوع البيانات في طريقة عرض القيم لحِزم SDK الخاصة بالعميل. ومع ذلك، تأكَّد من أنّ طريقة get في تطبيقك تحوّل القيمة إلى نوع البيانات المقصود.

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

تتيح لك Remote Config تجميع المَعلمات معًا للحصول على واجهة مستخدم أكثر تنظيمًا وتحسين سهولة الاستخدام.

على سبيل المثال، لنفترض أنّك بحاجة إلى تفعيل أو إيقاف ثلاثة أنواع مختلفة من المصادقة أثناء طرح ميزة تسجيل دخول جديدة. باستخدام Remote Config، يمكنك إنشاء المَعلمات الثلاث لتفعيل الأنواع التي تريدها، ثم تنظيمها في مجموعة باسم "تسجيل دخول جديد"، بدون الحاجة إلى إضافة بادئات أو ترتيب خاص.

ملاحظة: توفّر مجموعات المَعلمات التنظيم في وحدة تحكّم Firebase وواجهة برمجة تطبيقات REST الخاصة بـ Remote Config. ومع ذلك، لا تغيّر هذه الأسماء طريقة إشارة حزمة SDK إلى المَعلمات.

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

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

إنشاء مجموعات المَعلمات أو تعديلها باستخدام وحدة تحكّم Firebase

يمكنك تجميع المَعلمات في وحدة تحكّم Firebase. في ما يلي كيفية إنشاء مجموعة أو تعديلها:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > Remote Config > المَعلمات.
2. انقر على إدارة المجموعات.
3. ضَع علامة في مربّعات الاختيار بجانب المَعلمات التي تريد إضافتها، ثم انقر على نقل إلى المجموعة.
4. اختَر مجموعة حالية أو أنشِئ مجموعة جديدة من خلال إدخال اسم ووصف، ثم النقر على إنشاء مجموعة جديدة. بعد حفظ مجموعة، يمكنك نشرها باستخدام الزر نشر التغييرات.

إنشاء مجموعات آليًا

توفّر Remote Config واجهة REST API طريقة آلية لإنشاء مجموعات المَعلمات ونشرها. بافتراض أنّك على دراية بـ REST وأنّك أعددت كل ما يلزم لتفويض الطلبات إلى واجهة برمجة التطبيقات، يمكنك اتّباع الخطوات التالية لإدارة المجموعات آليًا:

1. استرجاع النموذج الحالي
2. أضِف عناصر JSON لتمثيل مجموعات المَعلمات.
3. انشر مجموعات المَعلمات باستخدام طلب HTTP PUT.

يحتوي العنصر parameterGroups على مفاتيح المجموعات، مع وصف مضمّن وقائمة بالمعلَمات المجمّعة. يُرجى العِلم أنّه يجب أن يكون كل مفتاح مجموعة فريدًا على مستوى العالم.

على سبيل المثال، إليك مقتطف من مراجعة نموذج تضيف مجموعة المَعلمات "قائمة جديدة" مع مَعلمة واحدة، pumpkin_spice_season:

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …

  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's pumpkin spice season."
        }
      }
    }
  }
}

شروط الإشارات المخصّصة

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

تتوفّر شروط الإشارات المخصّصة في بيئات العميل التالية:

• ‫iOS: الإصدار 11.8.0 أو إصدار أحدث
• ‫Android: الإصدار 22.1.0 أو إصدار أحدث (الإصدار 33.8.0 أو إصدار أحدث من قائمة مواد Firebase)
• على الويب: الإصدار 11.2.0 أو إصدار أحدث
• Flutter: الإصدار 3.6.0 من قائمة المواد (BoM) أو إصدار أحدث

على سبيل المثال، لنفترض أنّك تعمل على تطبيق لبيع التذاكر وتريد عرض بانر على الشاشة الرئيسية. يمكنك استخدام شروط الإشارات المخصّصة من جهة العميل لتخصيص هذه البانرات استنادًا إلى الموقع الجغرافي للمستخدم واهتماماته. يمكنك اتّخاذ الإجراءات التالية:

1. أضِف banner_image_url وbanner_link إلى نموذج العميل Remote Config. تمثّل هذه السمة صورة البانر وصفحة الحدث المرتبطة بهذه الصورة.
2. اضبط إشارات مخصّصة من تطبيقك باستخدام القيمتَين city وpreferred_event_category.
3. أضِف قيمًا تلقائية إلى نموذج Remote Config الخاص بعميلك وأنشئ قيمًا شرطية استنادًا إلى الإشارات المخصّصة التي ضبطتها في الخطوة السابقة.
4. أضِف قيمًا تلقائية إلى نموذج Remote Config الخاص بالعميل وقيمًا شرطية لكل شرط حدّدته.
5. عدِّل الرمز البرمجي لتطبيقك لضبط شروط الإشارات المخصّصة واستخدامها.

يمكن لتطبيقك الآن تنزيل banner_image_url وbanner_link المناسبَين عندما يستردّ هاتين المَعلمتَين من خادم Remote Config.

الحدود

عند إنشاء شروط إشارات مخصّصة، يجب الالتزام بالحدود التالية:

• عدد الإشارات المخصّصة: يمكنك إنشاء ما يصل إلى 100 إشارة مخصّصة لكل مثيل من التطبيق. يمكنك إلغاء ضبط إشارة مخصّصة من خلال ضبط قيمتها على "null".
• اسم الإشارة المخصّصة: يمكن أن يتضمّن كل اسم إشارة مخصّصة 250 حرفًا كحدّ أقصى.
• قيمة الإشارة المخصّصة: يمكن أن تتضمّن كل قيمة إشارة مخصّصة ما يصل إلى 500 حرف. عند استخدام التعبيرات العادية، يبلغ الحدّ الأقصى 250 حرفًا.

ملاحظة: عند ضبط شروط متعدّدة لإشارات مخصّصة، يجب الالتزام بهذه الحدود لكل إشارة. يؤدي تجاوز أي حدّ إلى منع ضبط جميع الإشارات.

أنواع قواعد الشروط

تتوفّر أنواع القواعد التالية في وحدة تحكّم Firebase. تتوفّر ميزات مكافئة في واجهة برمجة تطبيقات Remote Config REST، كما هو موضّح بالتفصيل في مرجع التعبير الشرطي.

نوع القاعدة	المشغِّلون	القيمة(القيم)	ملاحظة
التطبيق	==	اختَر من قائمة معرّفات التطبيقات للتطبيقات المرتبطة بمشروعك على Firebase.	عند إضافة تطبيق إلى Firebase، عليك إدخال معرّف حزمة أو اسم حزمة Android يحدّد سمة يتم عرضها على أنّها معرّف التطبيق في قواعد Remote Config. استخدِم هذه السمة على النحو التالي: على منصات Apple: استخدِم CFBundleIdentifier الخاص بالتطبيق. يمكنك العثور على معرّف الحزمة في علامة التبويب عام للاستهداف الأساسي لتطبيقك في Xcode. على Android: استخدِم applicationId الخاص بالتطبيق. يمكنك العثور على applicationId في ملف build.gradle(.kts) على مستوى التطبيق.
إصدار التطبيق	بالنسبة إلى القيم النصية: تطابق تام، يحتوي على، لا يحتوي على، يحتوي على تعبير عادي بالنسبة إلى القيم الرقمية: <، <=، =، !=، >، >=	حدِّد إصدارات تطبيقك التي تريد استهدافها. قبل استخدام هذه القاعدة، عليك استخدام قاعدة معرّف التطبيق لاختيار تطبيق Android أو Apple مرتبط بمشروع Firebase.	في منصات Apple: استخدِم CFBundleShortVersionString الخاص بالتطبيق. ملاحظة: تأكَّد من أنّ تطبيقك على Apple يستخدم الإصدار 6.24.0 أو إصدارًا أحدث من حزمة تطوير البرامج لمنصات Apple في Firebase، لأنّه لا يتم إرسال CFBundleShortVersionString في الإصدارات الأقدم (راجِع ملاحظات الإصدار). في Android: استخدِم versionName للتطبيق. ملاحظة: لا تتوافق عوامل مقارنة الأرقام (< و<= و= و!= و> و>=) إلا مع الإصدارات الدلالية الرقمية (مثل 1.2.3). ولا تتوافق مع اللاحقات أو الواصلات الخاصة بالإصدارات التجريبية (مثل -beta أو -rc). بالنسبة إلى سلاسل الإصدارات التي تتضمّن لاحقات أو واصلات غير رقمية (مثل 1.5-beta)، استخدِم عوامل تشغيل السلاسل بدلاً من ذلك (مثل يتضمّن تعبيرًا عاديًا أو يتضمّن أو يطابق تمامًا). مقارنات السلاسل لهذه القاعدة حساسة لحالة الأحرف. عند استخدام عامل التشغيل تطابق تام أو يحتوي على أو لا يحتوي على أو يحتوي على تعبير عادي، يمكنك اختيار قيم متعدّدة. عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2. يمكن أن يتطابق التعبير العادي مع السلسلة المستهدفة للإصدار بشكل كامل أو جزئي. يمكنك أيضًا استخدام أداتَي الربط ^ و$ لمطابقة بداية سلسلة مستهدَفة أو نهايتها أو السلسلة بأكملها.
رقم الإصدار	بالنسبة إلى قيم السلسلة: تطابق تام، يحتوي على، لا يحتوي على، تعبير عادي بالنسبة إلى القيم الرقمية: =, ≠, >, ≥, <, ≤	حدِّد إصدارات تطبيقك التي تريد استهدافها. قبل استخدام هذه القاعدة، يجب استخدام قاعدة معرّف التطبيق لاختيار تطبيق Apple أو Android مرتبط بمشروعك على Firebase.	لا يتوفّر عامل التشغيل هذا إلا لتطبيقات Apple وAndroid. وهو يتوافق مع CFBundleVersion للتطبيق على أجهزة Apple وversionCode على أجهزة Android. تكون مقارنات السلاسل لهذه القاعدة حساسة لحالة الأحرف. عند استخدام عامل التشغيل تطابق تمامًا أو تحتوي على أو لا تحتوي على أو تحتوي على تعبير عادي، يمكنك اختيار قيم متعدّدة. عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2. يمكن أن يتطابق التعبير العادي مع كل أو جزء من سلسلة إصدار الاستهداف. يمكنك أيضًا استخدام أدوات الربط ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو السلسلة بأكملها.
النظام الأساسي	==	iOS Android الويب
نظام التشغيل	==	حدِّد أنظمة التشغيل التي تريد استهدافها. قبل استخدام هذه القاعدة، عليك استخدام قاعدة معرّف التطبيق لاختيار تطبيق ويب مرتبط بمشروع Firebase.	تُقيّم هذه القاعدة على أنّها true لمثيل تطبيق ويب معيّن إذا كان نظام التشغيل وإصداره يطابقان قيمة مستهدَفة في القائمة المحدّدة.
المتصفح	==	حدِّد المتصفحات التي تريد استهدافها. قبل استخدام هذه القاعدة، عليك استخدام قاعدة معرّف التطبيق لاختيار تطبيق ويب مرتبط بمشروع Firebase.	تُقيَّم هذه القاعدة على أنّها true لمثيل تطبيق ويب معيّن إذا كان المتصفّح وإصداره يتطابقان مع قيمة مستهدَفة في القائمة المحدّدة.
فئة الجهاز	يساوي، لا يساوي	الجوال	تتحقّق هذه القاعدة ممّا إذا كان الجهاز الذي يصل إلى تطبيق الويب الخاص بك هو جهاز جوّال أو جهاز غير جوّال (كمبيوتر مكتبي أو وحدة تحكّم). لا يتوفّر نوع القاعدة هذا إلا لتطبيقات الويب.
اللغات	في	اختَر لغة واحدة أو أكثر.	تُقيّم هذه القاعدة على أنّها true لمثيل تطبيق معيّن إذا كان مثيل التطبيق هذا مثبَّتًا على جهاز يستخدم إحدى اللغات المدرَجة.
البلد/المنطقة	في	اختَر منطقة واحدة أو أكثر أو بلدًا واحدًا أو أكثر.	تكون قيمة هذه القاعدة true لمثيل تطبيق معيّن إذا كان المثيل في أي من المناطق أو البلدان المدرَجة. يتم تحديد رمز البلد للجهاز باستخدام عنوان IP للجهاز في الطلب أو رمز البلد الذي تحدّده &quot;إحصاءات Firebase&quot; (في حال مشاركة بيانات &quot;إحصاءات Google&quot; مع Firebase).
شرائح جمهور المستخدمين	تتضمّن واحدًا على الأقل	اختَر واحدًا أو أكثر من قائمة Google Analytics الجماهير التي أعددتها لمشروعك.	تتطلّب هذه القاعدة قاعدة معرّف التطبيق لاختيار تطبيق مرتبط بمشروع Firebase. ملاحظة: بما أنّ العديد من شرائح الجمهور Analytics يتم تحديدها من خلال الأحداث أو خصائص المستخدمين، والتي يمكن أن تستند إلى إجراءات مستخدمي التطبيق، قد يستغرق تنفيذ قاعدة مستخدم في شريحة الجمهور بعض الوقت في نسخة تطبيق معيّنة. وهذا يعني أنّه حتى إذا كان المستخدم مؤهلاً فنيًا للانضمام إلى شريحة جمهور، إذا لم تكن Analytics قد أضافت المستخدم إلى شريحة الجمهور عند تنفيذ fetchAndActivate()، لن يستوفي المستخدم الشرط.
خاصيّة المستخدم	بالنسبة إلى قيم السلسلة: contains, does not contain, exactly matches, contains regular expression بالنسبة إلى القيم الرقمية: =, ≠, >, ≥, <, ≤ ملاحظة: على العميل، يمكنك ضبط قيم السلسلة فقط لخصائص المستخدم. بالنسبة إلى الشروط التي تستخدم عوامل تشغيل رقمية، تحوّل Remote Config قيمة خاصية المستخدم المقابلة إلى عدد صحيح أو عدد عشري.	اختَر من قائمة Google Analytics خصائص المستخدم المتاحة.	للتعرّف على كيفية استخدام خصائص المستخدِمين لتخصيص تطبيقك لشرائح محدّدة جدًا من قاعدة المستخدِمين، اطّلِع على Remote Config وخصائص المستخدِمين. لمزيد من المعلومات عن خصائص المستخدِمين، اطّلِع على الأدلة التالية: ضبط خصائص المستخدِمين على أجهزة Apple ضبط خصائص المستخدِمين على Android عند استخدام عامل التشغيل يتطابق تمامًا مع أو يحتوي على أو لا يحتوي على أو يحتوي على تعبير عادي، يمكنك اختيار قيم متعدّدة. عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2. يمكن أن يتطابق التعبير العادي مع كل أو جزء من سلسلة إصدار الاستهداف. يمكنك أيضًا استخدام أدوات الربط ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو السلسلة بأكملها. ملاحظة: لا تتوفّر خصائص المستخدمين المجمَّعة تلقائيًا عند إنشاء شروط Remote Config.
المستخدمون في نسبة مئوية عشوائية	شريط التمرير (في وحدة تحكّم Firebase) تستخدم REST API عوامل التشغيل <= و> وbetween.	0-100	استخدِم هذا الحقل لتطبيق تغيير على عيّنة عشوائية من مثيلات التطبيق (بأحجام عيّنات صغيرة تصل إلى 0 .0001%)، وذلك باستخدام أداة شريط التمرير لتقسيم المستخدمين (مثيلات التطبيق) الذين تم ترتيبهم عشوائيًا إلى مجموعات. يتم ربط كل مثيل تطبيق بشكل دائم بعدد عشوائي صحيح أو كسري، وذلك وفقًا لقيمة أولية محدّدة في هذا المشروع. يمكن أن تحتوي قيم البذور على ما بين حرف واحد و32 حرفًا تتضمّن قيمًا أبجدية رقمية ونقاطًا و/أو شرطات و/أو شرطات سفلية. ستستخدِم القاعدة المفتاح التلقائي (المعروض على أنّه تعديل القيمة الأولية في وحدة تحكّم Firebase) ما لم تعدِّل قيمة القيمة الأولية. يمكنك إعادة القاعدة إلى استخدام المفتاح التلقائي من خلال محو حقل المفتاح الأساسي. للتوجّه باستمرار إلى مثيلات التطبيق نفسها ضمن نطاقات النسبة المئوية المحدّدة، استخدِم قيمة seed نفسها في جميع الشروط. يمكنك أيضًا اختيار مجموعة جديدة من مثيلات التطبيق تم تعيينها عشوائيًا لنطاق نسبة مئوية معيّن من خلال تحديد قيمة أولية جديدة. على سبيل المثال، لإنشاء شرطَين مرتبطَين ينطبق كل منهما على% 5 من مستخدمي التطبيق غير المتداخلين، يمكنك ضبط أحد الشرطَين ليتطابق مع نسبة تتراوح بين% 0 و% 5، وضبط الشرط الآخر ليتطابق مع نطاق يتراوح بين% 5 و%10. للسماح لبعض المستخدمين بالظهور بشكل عشوائي في كلتا المجموعتين، استخدِم قيمًا مختلفة للقيم الأولية للقواعد ضمن كل شرط.
شريحة مستورَدة	في	اختَر شريحة مستورَدة واحدة أو أكثر.	تتطلّب هذه القاعدة إعداد شرائح مستورَدة مخصّصة.
التاريخ/الوقت	قبل وبعد	تاريخ ووقت محدّدان، إما في المنطقة الزمنية للجهاز أو في منطقة زمنية محدّدة، مثل "توقيت سيدني (GMT+11)"	تقارن هذه السمة الوقت الحالي بوقت استرجاع الجهاز.
أول فتح	قبل وبعد	استهداف المستخدمين استنادًا إلى المرة الأولى التي يفتحون فيها تطبيقك: اختَر المستخدمون الجدد لاستهداف المستخدمين الذين يفتحون تطبيقك للمرة الأولى بعد تاريخ ووقت محدّدين في المستقبل. اختَر النطاق الزمني لاستهداف المستخدمين الذين يفتحون تطبيقك للمرة الأولى خلال النطاق قبل أو بعد التاريخ والوقت اللذين تحدّدهما. يمكنك الجمع بين شرطَي قبل وبعد لاستهداف المستخدمين خلال نطاق زمني محدّد.	تتوفّر استهداف المستخدمين حسب عملية التشغيل لأول مرة بعد اختيار تطبيق Android أو iOS أو تطبيق على الويب. يتطلّب حِزم تطوير البرامج (SDK) التالية: حزمة تطوير البرامج (SDK) لمنصة Firebase لنظام التشغيل Google Analytics الإصدار 9.0.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لمنصات Apple أو الإصدار 21.1.1 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android (Firebase BoM الإصدار 30.3.0 أو إصدار أحدث)، والإصدار 12.8.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) بلغة JavaScript. يجب أيضًا أن يكون Analytics مفعّلاً على الجهاز العميل أثناء حدث فتح التطبيق للمرة الأولى.
معرّف التثبيت	في	حدِّد معرّف تثبيت واحدًا أو أكثر (بما يصل إلى 50 معرّفًا) لاستهدافه.	تُقيَّم هذه القاعدة على أنّها true لعملية تثبيت معيّنة إذا كان رقم تعريف عملية التثبيت هذه مدرَجًا في قائمة القيم المفصولة بفواصل. للتعرّف على كيفية الحصول على أرقام تعريف عمليات التثبيت، يُرجى الاطّلاع على مقالة استرداد معرّفات العملاء.
المستخدم موجود	(بدون عامل تشغيل)	يستهدف جميع مستخدمي جميع التطبيقات ضِمن المشروع الحالي.	استخدِم قاعدة الشرط هذه لمطابقة جميع المستخدمين ضِمن المشروع، بغض النظر عن التطبيق أو النظام الأساسي. عند استخدام Remote Config التخصيص، يمكنك استخدام هذا المعامل لضمان تلقّي جميع المستخدمين في المشروع قيم مخصّصة.
إشارة مخصّصة	لقيم السلسلة: يحتوي على، لا يحتوي على، مطابقة تامة، يحتوي على تعبير عادي لقيم الأرقام: =, ≠, >, ≥, <, ≤ لقيم الإصدار: =, ≠, >, ≥, <, ≤	مقارنات السلاسل لهذه القاعدة حساسة لحالة الأحرف. عند استخدام عامل التشغيل "تطابق تام" أو "تحتوي على" أو "لا تحتوي على" أو "تحتوي على تعبير عادي"، يمكنك اختيار قيم متعدّدة. عند استخدام عامل التشغيل "يحتوي على تعبير عادي"، يمكنك إنشاء تعبيرات عادية بتنسيق RE2. يمكن أن يتطابق التعبير العادي مع كل سلسلة الإصدار المستهدَفة أو جزء منها. يمكنك أيضًا استخدام علامات الربط ^ و $ لمطابقة بداية سلسلة مستهدَفة أو نهايتها أو السلسلة بأكملها. تتوفّر أنواع البيانات التالية لبيئات العملاء: ‫iOS: int وdouble ‫Android: int وlong وdouble الويب: رقم رقم يمثّل أرقام الإصدارات التي يجب أن تتطابق (على سبيل المثال، 2.1.0).	لمزيد من المعلومات عن شروط الإشارات المخصّصة والعبارات الشرطية التي يجب استخدامها، اطّلِع على شروط الإشارات المخصّصة والعناصر المستخدَمة لإنشاء الشروط.

مَعلمات البحث وشروطه

يمكنك البحث عن مفاتيح المَعلمات وقيم المَعلمات والشروط الخاصة بمشروعك من وحدة تحكّم Firebase باستخدام مربّع البحث في أعلى صفحة DevOps والتفاعل > الإعداد عن بُعد > المَعلمات.

الحدود القصوى للمَعلمات والشروط

يمكنك استخدام ما يصل إلى 3,000 مَعلمة و2,000 شرط في مشروع Firebase واحد. يمكن أن يصل طول مفاتيح المَعلمات إلى 256 حرفًا، ويجب أن تبدأ بشرطة سفلية أو حرف أبجدي إنجليزي (من A إلى Z ومن a إلى z)، ويمكن أن تتضمّن أيضًا أرقامًا. يجب ألا يتجاوز إجمالي طول سلاسل قيم المَعلمات في أحد المشاريع 1,000,000 حرف. بالإضافة إلى ذلك، يمكن أن تتضمّن قواعد الشروط المستندة إلى خصائص المستخدم ما يصل إلى 100 قيمة من قيم خصائص المستخدم. للاطّلاع على القائمة الكاملة بالحدود، يُرجى الرجوع إلى الحصص والحدود.

عرض التغييرات التي تم إجراؤها على المَعلمات والشروط

يمكنك الاطّلاع على آخر التغييرات التي أجريتها على نماذج Remote Config من وحدة تحكّم Firebase. بالنسبة إلى كل مَعلمة وشرط على حدة، يمكنك إجراء ما يلي:

• عرض اسم المستخدم الذي أجرى آخر تعديل على المَعلمة أو الشرط

• إذا حدث التغيير في اليوم نفسه، اطّلِع على عدد الدقائق أو الساعات التي مرّت منذ نشر التغيير في النموذج النشط Remote Config.

• إذا حدث التغيير قبل يوم واحد أو أكثر، اطّلِع على تاريخ نشر التغيير في نموذج Remote Config النشط.

سجلّ التغييرات الخاص بالمعلَمات

في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات التطوير والتشغيل والتفاعل > Remote Config > المَعلمات. يعرض عمود آخر نشر آخر مستخدم عدّل كل مَعلمة وتاريخ آخر نشر للتغيير:

• لعرض بيانات وصفية للتغيير خاصة بالمَعلمات المجمّعة، وسِّع مجموعة المَعلمات.

• لترتيب البيانات تصاعديًا أو تنازليًا حسب تاريخ النشر، انقر على تصنيف العمود تاريخ آخر نشر.

سجلّ التغييرات للشروط

في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات تطوير البرامج وإشراك المستخدمين > Remote Config > الشروط. يمكنك الاطّلاع على آخر مستخدم عدّل الشرط وتاريخ تعديله بجانب آخر تعديل ضمن كل شرط.

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

لضبط مشروعك وتطبيقك على Firebase لاستخدام Remote Config، اطّلِع على بدء استخدام Firebase Remote Config.