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


يمكنك ضبط النماذج لكلٍّ من حالات استخدام العميل والخادم. عميل يتم عرض النماذج على أيّ مثيلات تطبيقات تنفِّذ Firebase. حِزم تطوير البرامج (SDK) للعميل لـ Remote Config، بما في ذلك Android وApple وWeb وUnity تطبيقات Flutter وC++ Remote Config مَعلمات وقيم من يتم عرض النماذج الخاصة بالخادم في Remote Config عملية تنفيذ (بما في ذلك وظائف التشغيل السحابي ووظائف السحابة) التي تستخدم وحدة تحكُّم المشرف في Firebase الإصدار 12.1.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) في Node.js.

عند استخدام وحدة تحكّم Firebase أو واجهات برمجة تطبيقات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.

على سبيل المثال، يمكنك إنشاء معلمة تحدد لغة كبيرة اسم النموذج وسلسلة الإصدار للنموذج (LLM)، وعرض استجابات من النماذج استنادًا إلى إشارة مخصّصة من القواعد. ضِمن في حالة الاستخدام هذه، يمكنك استخدام إصدار نموذج مستقر كقيمة افتراضية تلبية معظم الطلبات، واستخدام الإشارة المخصّصة لاستخدام نموذج تجريبي الاستجابة لطلبات العميل التجريبية.

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

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

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

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

  2. إذا لم تكن هناك قيم شرطية بشروط يتم تقييمها إلى true، يتم توفير القيمة التلقائية لـ 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، يمكن ضبط الأنواع باستخدام الحقل value_type ضمن كائن المَعلمة.

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

تتيح لك Remote Config تجميع المعلمات معًا من أجل إجراء واجهة المستخدم وتحسين سهولة الاستخدام.

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

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

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

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

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

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

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

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

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

استخدِم هذه السمة على النحو التالي:
  • بالنسبة إلى أنظمة Apple الأساسية: استخدِم CFBundleIdentifier: يمكنك العثور على معرّف الحزمة في علامة التبويب عام لـ الهدف الأساسي للتطبيق في Xcode.
  • على أجهزة Android: استخدِم رقم تعريف التطبيق: يمكنك العثور على applicationId في مستوى تطبيقك. ملف build.gradle.
إصدار التطبيق بالنسبة إلى القيم النصية:
تطابق تمامًا،
تحتوي على،
لا تحتوي على،
تحتوي على تعبير عادي

بالنسبة إلى القيم الرقمية:
<, <=, =, !=, >, >=

حدِّد إصدارات تطبيقك التي تريد استهدافها.

قبل استخدام هذه القاعدة، عليك استخدام قاعدة رقم تعريف التطبيق لاختيار تطبيق Android أو Apple مرتبط بمشروعك على Firebase

على أنظمة Apple الأساسية: استخدِم CFBundleShortVersionString الخاصة بالتطبيق.

ملاحظة: تأكَّد من أنّ تطبيقك المتوافق مع أجهزة Apple يستخدم الإصدار 6.24.0 أو إصدارًا أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Apple من Firebase، لأنّه لا يتم إرسال CFBundleShortVersionString في الإصدارات الأقدم (اطّلِع على ملاحظات الإصدار).

على أجهزة Android: استخدِم versionName الخاص بالتطبيق.

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

عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2 . يمكن أن يتطابق التعبير العادي مع الإصدار المستهدف بالكامل أو جزء منه. السلسلة. يمكنك أيضًا استخدام علامتَي الارتساء ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو كاملة.

رقم الإصدار بالنسبة إلى القيم النصية:
تتطابق تمامًا،
تحتوي على،
لا تحتوي على،
تعبير عادي

بالنسبة إلى القيم الرقمية:
=, ≠, >, ≥, <, ≤

حدِّد إصدارات تطبيقك المستهدفة.

قبل استخدام هذه القاعدة، يجب استخدام قاعدة معرّف التطبيق لاختيار تطبيق Apple أو Android مرتبط بمشروعك على Firebase.

لا يتوفّر عامل التشغيل هذا إلا لتطبيقات Apple وAndroid. ويتوافق مع CFBundleVersion للتطبيقات على أجهزة Apple وversionCode لأجهزة Android. مقارنات السلاسل لهذه القاعدة حساسة لحالة الأحرف.

عند استخدام تطابق تمامًا، يحتوي على، لا يحتوي على ، أو يحتوي على تعبير عادي، يمكنك تحديد قيم متعددة.

عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء نص عادي التعبيرات في RE2 . يمكن أن يتطابق التعبير العادي مع كل الإصدار المستهدف أو جزء منه. يمكنك أيضًا استخدام علامتَي الربط ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو كلّها.

النظام الأساسي == ‫iOS
Android
الويب
 
نظام التشغيل ==

حدِّد أنظمة التشغيل التي تريد استهدافها.

قبل استخدام هذه القاعدة، يجب استخدام قاعدة رقم تعريف التطبيق لاختيار تطبيق ويب مرتبط بمشروعك على Firebase

يتم تقييم هذه القاعدة على أنّها true لمثيل معيّن من تطبيقات الويب إذا كان نظام التشغيل وإصداره يتطابقان مع قيمة مستهدَفة في القائمة المحدّدة.
المتصفح ==

حدِّد المتصفّحات التي تريد استهدافها.

قبل استخدام هذه القاعدة، يجب استخدام قاعدة معرّف التطبيق لاختيار تطبيق ويب مرتبط بمشروعك على Firebase.

يتم تقييم هذه القاعدة إلى true لمثيل تطبيق ويب معيّن إذا كانت يتطابق المتصفّح وإصداره مع قيمة مستهدَفة في القائمة المحدّدة.
فئة الجهاز هو، ليس الجوال تقيِّم هذه القاعدة ما إذا كان الجهاز الذي يصل إلى تطبيقك على الويب هو جهاز جوّال أو غير جوّال (كمبيوتر مكتبي أو وحدة تحكّم). نوع القاعدة هذا متاح على الويب فقط. التطبيقات.
اللغات في اختَر لغة واحدة أو أكثر. يتم تقييم هذه القاعدة إلى true لمثيل تطبيق معيّن إذا كان ذلك تثبيت نسخة افتراضية من التطبيق على جهاز يستخدم إحدى اللغات المدرَجة.
البلد/المنطقة في اختَر منطقة أو بلدًا واحدًا أو أكثر. يتم تقييم هذه القاعدة إلى true لمثيل تطبيق معيّن إذا كانت في أي من المناطق أو البلدان المدرجة. رمز البلد للجهاز يتم تحديده باستخدام عنوان IP للجهاز في الطلب أو رمز البلد يتمّ تحديدها بواسطة "إحصاءات Firebase" (في حال مشاركة بيانات "إحصاءات Google" مع Firebase).
شرائح جمهور المستخدِمين يتضمن واحدًا على الأقل اختَر شريحة واحدة أو أكثر من قائمة Google Analytics من شرائح الجمهور التي قمت بإعدادها لمشروعك.

تتطلّب هذه القاعدة قاعدة "رقم تعريف التطبيق" لاختيار تطبيق مرتبط مشروع على Firebase.

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

خاصيّة المستخدم بالنسبة إلى القيم النصية:
يحتوي على،
لا يحتوي على،
يتطابق تمامًا،
يحتوي على تعبير عادي

بالنسبة إلى القيم الرقمية:
=, ≠, >, ≥, <, ≤

ملاحظة: على العميل، يمكنك ضبط قيم نصية فقط لسمات المستخدم. بالنسبة للشروط التي تستخدم العوامل الرقمية، تؤدي Remote Config إلى تحويل القيمة المقابلة خاصيّة المستخدم إلى عدد صحيح/عدد عائم.
اختَر من قائمة Google Analytics خصائص المستخدِمين المتاحة. تعرّف على كيفية استخدام خصائص المستخدمين لتخصيص تطبيقك بما يتوافق مع شرائح محددة جدًا من قاعدة المستخدمين، يمكنك مراجعة Remote Config وخصائص المستخدمين.

لمزيد من المعلومات عن خصائص المستخدِمين، اطّلِع على الأدلة التالية:

عند استخدام عامل التشغيل تطابق تمامًا أو يحتوي على أو لا يحتوي على أو يحتوي على تعبير عادي، يمكنك اختيار قيم متعدّدة.

عند استخدام عامل التشغيل يحتوي على تعبير عادي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2 . يمكن أن يتطابق التعبير العادي مع الإصدار المستهدف بالكامل أو جزء منه. السلسلة. يمكنك أيضًا استخدام علامتَي الربط ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو كلّها.

ملاحظة: لا تتوفّر خصائص المستخدِمين المجمَّعة تلقائيًا عند إنشاء شروط Remote Config.
نسبة المستخدمين العشوائية شريط التمرير (في وحدة تحكُّم Firebase) تشير رسالة الأشكال البيانية استخدامات REST API عوامل التشغيل <= و> وbetween). 0-100

استخدِم هذا الحقل لتطبيق تغيير على عيّنة عشوائية من مثيلات التطبيق (مع استخدام أحجام عيّنات صغيرة). كنسبة .0001%)، باستخدام أداة شريط التمرير لتقسيم المستخدمين الذين تم ترتيبهم عشوائيًا (مثيلات التطبيق) إلى مجموعات.

يتم ربط كل مثيل تطبيق بشكل دائم برقم صحيح أو كسري عشوائي، وفقًا ل بذرة محدّدة في ذلك المشروع.

ستستخدم القاعدة المفتاح التلقائي (الذي يظهر على أنّه تعديل القيمة الأساسية في وحدة تحكّم Firebase) ما لم يتم تعديل قيمة القيمة الأساسية. يمكنك الرجوع إلى قاعدة باستخدام المفتاح الافتراضي عن طريق محو المحتوى الأساسي.

لمعالجة نُسخ التطبيق نفسها بشكلٍ متسق ضمن نطاقات النسب المئوية المحدّدة، استخدِم قيمة البذرة نفسها في جميع الشروط. أو يمكنك اختيار مجموعة جديدة يتم تحديدها عشوائيًا من مثيلات التطبيقات لمجموعة محدّدة من مثيلات التطبيقات. نطاق النسبة المئوية من خلال تحديد قيمة أساسية جديدة.

على سبيل المثال، لإنشاء شرطَين مرتبطَين ينطبق كل منهما على %5 من مستخدمي التطبيق غير المتداخلين، يمكنك ضبط شرط واحد لمطابقة نسبة مئوية تتراوح بين 0% و%5 وضبط شرط آخر لمطابقة نطاق يتراوح بين %5 و%10. للسماح لبعض المستخدِمين بالظهور بشكل عشوائي في كلتا المجموعتَين، استخدِم قيمًا مختلفة لبذور القواعد ضمن كلّ شرط.

الشريحة المستورَدة في اختَر شريحة واحدة أو أكثر تم استيرادها. تتطلّب هذه القاعدة إعداد شرائح جمهور مستورَدة مخصّصة.
التاريخ/الوقت قبل وبعد تاريخ ووقت محدّدان، إما في المنطقة الزمنية للجهاز أو في منطقة زمنية محدّدة مثل "(GMT+11) توقيت سيدني" تتم مقارنة الوقت الحالي بوقت استرجاع الجهاز.
أول فتح قبل، بعد تاريخ ووقت محدّدَان حسب المنطقة الزمنية المحدّدة.

تتم مطابقة المستخدمين الذين يفتحون التطبيق المستهدَف لأول مرة ضمن النطاق المحدّد. النطاق الزمني.

يتطلب ذلك توفُّر حِزم تطوير البرامج (SDK) التالية:

  • حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بالإصدار Google Analytics
  • حزمة تطوير البرامج (SDK) لنظام التشغيل Apple الإصدار 9.0.0 أو الإصدارات الأحدث أو الإصدار 21.1.1 من حزمة SDK لنظام التشغيل Android أو الإصدارات الأحدث (Firebase BoM الإصدار 30.3.0 والإصدارات الأحدث)
معرّف التثبيت في حدِّد معرّف تثبيت واحدًا أو أكثر (ما يصل إلى 50) لاستهدافه. يتم تقييم هذه القاعدة إلى true لعملية تثبيت معيّنة إذا كان ذلك معرف التثبيت في قائمة القيم المفصولة بفواصل.

لمعرفة كيفية الحصول على أرقام تعريف عمليات التثبيت، يُرجى الاطّلاع على مقالة استرداد معرّفات العملاء.
توفّر المستخدم (بدون عامل تشغيل) تستهدف جميع مستخدمي جميع التطبيقات ضمن المشروع الحالي.

استخدم قاعدة الشرط هذه لمطابقة جميع المستخدمين داخل المشروع، بغض النظر التطبيق أو النظام الأساسي.

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

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

الحدود المفروضة على المَعلمات والشروط

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

عرض التغييرات في المَعلمات والشروط

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

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

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

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

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

في صفحة Remote Config المَعلمات ، يعرض عمود آخر تاريخ نشر آخر مستخدم عدّل كل مَعلمة وتاريخ آخر نشر للتغيير:

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

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

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

على Remote Config الشروط يمكنك معرفة آخر مستخدم عدّل الشرط وتاريخ التعديل عدّلوه بجانب آخر تعديل تحت كل شرط.

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

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