پارامترها و شرایط «پیکربندی از راه دور» در الگوهای کارخواه

نوع الگو را انتخاب کنید:

الگوهای کارخواه الگوهای سرور

می‌توانید پارامترها و مقادیر Remote Config را از الگوهای مشتری به هر نمونه برنامه‌ای که کیت‌های توسعه نرم‌افزار مشتری Firebase را برای Remote Config پیاده‌سازی می‌کند، ازجمله برنامه‌های Apple،‏ Android،‏ Web،‏ 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 و تعامل > پیکربندی از راه دور > پارامترها بروید تا درصد واکشی را برای مقادیر شرطی هر پارامتر مشاهده کنید. این سنجه درصد درخواست‌هایی را نشان می‌دهد که در ۲۴ ساعت گذشته هر مقدار را دریافت کرده‌اند.

افزودن، ویرایش، تغییر ترتیب، یا حذف شرایط بااستفاده از کنسول Firebase

می‌توانید شرایط هدف‌یابی را در کنسول Firebase ایجاد، ویرایش، بازآرایی، و حذف کنید. شرایط در پارامترهای درون پروژه هم‌رسانی می‌شود. نحوه مدیریت شرایط در اینجا آمده است:

1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > شرایط بروید (یا مدیریت شرایط را از صفحه پارامترها انتخاب کنید).
2. افزودن شرط: روی افزودن شرط (یا ایجاد اولین شرط) کلیک کنید، نامی را وارد کنید که هدف‌گذاری را تعریف می‌کند، و یک یا چند قانون هدف‌یابی را انتخاب کنید.
3. ویرایش کردن شرط: روی نام شرط یا نماد ویرایش کلیک کنید، قوانین را درصورت نیاز اصلاح کنید، و روی ذخیره کلیک کنید.
4. تغییر اولویت شرط: در صفحه شرایط، شرایط را با دستگیره جابه‌جایی بکشید تا ترتیب آن‌ها را تغییر دهید. شرایطی که در بالای فهرست قرار دارند بر شرایطی که در پایین فهرست قرار دارند اولویت دارند.
5. حذف شرط: روی نماد حذف در کنار شرطی که می‌خواهید بردارید کلیک کنید. اگر شرطی توسط پارامتری ارجاع داده شود، برداشتن آن باعث می‌شود مقادیر شرطی مرتبط نیز برداشته شود.

پس‌از ذخیره کردن تغییرات شرط، الگوی خود را بااستفاده از انتشار تغییرات منتشر کنید.

محدودیت پروتکل اینترنتی نسخه ۶ با کنترل دسترسی مبتنی بر IP

Remote Config پشتیبانی محدودی از 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 در شیء پارامتر تنظیم کرد.

توجه: انتخاب نوع داده بر نحوه برگرداندن مقادیر به کیت‌های توسعه نرم‌افزار کارخواه تأثیری ندارد. بااین‌حال، بررسی کنید که در برنامه‌تان روش get مقدار را به نوع داده موردنظر برگرداند.

گروه‌های پارامتر

Remote Config به شما امکان می‌دهد پارامترها را باهم گروه‌بندی کنید تا واسط کاربر سازمان‌یافته‌تر و قابلیت استفاده بهبودیافته‌تری داشته باشید.

برای مثال، فرض کنید باید سه نوع اصالت‌سنجی مختلف را فعال یا غیرفعال کنید درحالی‌که ویژگی ورود به سیستم جدیدی را عرضه می‌کنید. با Remote Config، می‌توانید سه پارامتر را برای فعال کردن انواع موردنظرتان ایجاد کنید و سپس آن‌ها را در گروهی به‌نام «ورود جدید به سیستم» سازمان‌دهی کنید، بدون اینکه نیازی به افزودن پیشوند یا مرتب‌سازی خاصی باشد.

توجه: گروه‌های پارامتر سازمان‌دهی را در کنسول Firebase و Remote Config REST API ارائه می‌دهند. بااین‌حال، این نام‌ها نحوه ارجاع پارامترها توسط کیت توسعه نرم‌افزار را تغییر نمی‌دهند.

می‌توانید بااستفاده از کنسول Firebase یا Remote Config REST API، گروه‌های پارامتر ایجاد کنید. هر گروه پارامتری که ایجاد می‌کنید نام منحصربه‌فردی در الگوی Remote Config شما دارد. هنگام ایجاد گروه‌های پارامتر، موارد زیر را به‌خاطر داشته باشید:

• پارامترها را می‌توان در هر زمان فقط در یک گروه گنجاند، و کلید پارامتر همچنان باید در بین همه پارامترها منحصربه‌فرد باشد.
• نام گروه‌های پارامتر به ۲۵۶ نویسه محدود است.
• اگر هم از REST API و هم از کنسول Firebase استفاده می‌کنید، مطمئن شوید که هر منطق REST API برای مدیریت گروه‌های پارامتر در زمان انتشار به‌روز شده باشد.

ایجاد یا اصلاح گروه‌های پارامتر بااستفاده از کنسول Firebase

می‌توانید پارامترها را در کنسول Firebase گروه‌بندی کنید. نحوه ایجاد یا اصلاح گروه:

1. در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید.
2. مدیریت گروه‌ها را انتخاب کنید.
3. چارگوش‌های انتخاب پارامترهایی را که می‌خواهید اضافه کنید انتخاب کنید و انتقال به گروه را انتخاب کنید.
4. گروه موجودی را انتخاب کنید یا با وارد کردن نام و شرح و انتخاب ایجاد گروه جدید، گروه جدیدی ایجاد کنید. پس‌از ذخیره کردن گروه، بااستفاده از دکمه انتشار تغییرات می‌توانید آن را منتشر کنید.

ایجاد گروه‌ها به‌صورت برنامه‌نویسی‌شده

Remote Config REST API روشی خودکار برای ایجاد و انتشار گروه‌های پارامتر ارائه می‌دهد. با فرض اینکه با REST آشنا هستید و برای صدور مجوز درخواست‌ها به API راه‌اندازی شده‌اید، می‌توانید این مراحل را برای مدیریت گروه‌ها به‌صورت برنامه‌نویسی انجام دهید:

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: نسخه ۱۱.۸.۰ یا بالاتر
• ‫Android: نسخه ۲۲.۱.۰ یا بالاتر (Firebase BoM نسخه ۳۳.۸.۰ یا بالاتر)
• وب: نسخه ۱۱.۲.۰ یا بالاتر
• Flutter: Flutter 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 بارگیری کند.

محدودیت‌ها

هنگام ایجاد شرایط سیگنال سفارشی، باید از محدودیت‌های زیر پیروی کنید:

• تعداد سیگنال‌های سفارشی: می‌توانید حداکثر ۱۰۰ سیگنال سفارشی برای هر نمونه برنامه ایجاد کنید. با تنظیم مقدار سیگنال سفارشی روی null، می‌توانید آن را لغو تنظیم کنید.
• نام سیگنال سفارشی: هر نام سیگنال سفارشی می‌تواند حداکثر ۲۵۰ نویسه داشته باشد.
• مقدار سیگنال سفارشی: هر مقدار سیگنال سفارشی می‌تواند حداکثر ۵۰۰ نویسه داشته باشد. هنگام استفاده از عبارت‌های باقاعده، حد مجاز ۲۵۰ نویسه است.

توجه: هنگام تنظیم چند شرط سیگنال سفارشی، برای هر سیگنال در این محدوده‌ها بمانید. فراتر رفتن از هریک از محدودیت‌ها مانع از تنظیم همه سیگنال‌ها می‌شود.

انواع قانون شرطی

انواع قانون زیر در کنسول Firebase پشتیبانی می‌شود. ویژگی‌های معادل در Remote Config REST API دردسترس است، همان‌طور که در مرجع عبارت شرطی به‌تفصیل شرح داده شده است.

نوع قانون	اپراتور(ها)	مقدار(ها)	توجه
برنامه	==	از فهرست «شناسه‌های برنامه» برای برنامه‌های مرتبط با پروژه Firebase خود انتخاب کنید.	وقتی برنامه‌ای را به Firebase اضافه می‌کنید، شناسه بسته ترکیبی یا نام بسته Android را وارد می‌کنید که مشخصه‌ای را تعریف می‌کند که به‌عنوان شناسه برنامه در قوانین Remote Config نشان داده می‌شود. از این مشخصه به‌صورت زیر استفاده کنید: برای پلاتفرم‌های Apple: از CFBundleIdentifier برنامه استفاده کنید. می‌توانید شناسه بسته نرم‌افزاری را در برگه عمومی برای هدف اصلی برنامه‌تان در Xcode پیدا کنید. برای Android: از applicationId برنامه استفاده کنید. می‌توانید applicationId را در فایل build.gradle(.kts) در سطح برنامه پیدا کنید.
نسخه برنامه	برای مقادیر رشته‌ای: دقیقاً مطابقت دارد، دربردارد، دربرندارد، دربردارنده عبارت باقاعده است برای مقادیر عددی: <، <=، =، !=، >، >=	نسخه(های) برنامه‌تان را برای هدف‌یابی مشخص کنید. قبل‌از استفاده از این قانون، باید از قانون شناسه برنامه برای انتخاب برنامه Android/Apple مرتبط با پروژه Firebase خود استفاده کنید.	برای پلاتفرم‌های Apple: از CFBundleShortVersionString برنامه استفاده کنید. توجه: مطمئن شوید برنامه Apple شما از نسخه ۶.۲۴.۰ یا بالاتر کیت توسعه نرم‌افزار پلاتفرم‌های Firebase Apple استفاده می‌کند، زیرا CFBundleShortVersionString در نسخه‌های قبلی ارسال نمی‌شود (یادداشت‌های انتشار را ببینید). برای Android: از versionName برنامه استفاده کنید. توجه: عملگرهای مقایسه عددی (<، <=، =، !=، >، >=) فقط از نسخه‌های معنایی عددی (مانند 1.2.3) پشتیبانی می‌کنند. این عملگرها از پسوندهای پیش‌انتشار یا خط تیره (مانند -beta یا -rc) پشتیبانی نمی‌کنند. برای رشته‌های نسخه با پسوندهای غیرعددی یا خط تیره (مانند 1.5-beta)، به‌جای آن از عملگرهای رشته‌ای (مانند حاوی عبارت باقاعده، حاوی، یا مطابقت دقیق) استفاده کنید. مقایسه‌های رشته‌ای برای این قانون به حروف بزرگ و کوچک حساس است. هنگام استفاده از عملگرهای دقیقاً مطابقت دارد، شامل، شامل نمی‌شود ، یا شامل عبارت باقاعده است، می‌توانید چند مقدار را انتخاب کنید. هنگام استفاده از عملگر حاوی عبارت باقاعده، می‌توانید عبارت‌های باقاعده را در قالب RE2 ایجاد کنید. عبارت باقاعده شما می‌تواند با همه یا بخشی از رشته نسخه هدف مطابقت داشته باشد. همچنین می‌توانید از لنگرهای ^ و $ برای مطابقت دادن ابتدا، انتها، یا کل رشته هدف استفاده کنید.
شماره ساخت	برای مقادیر رشته‌ای: دقیقاً مطابقت دارد، دربردارد، دربرندارد، عبارت باقاعده برای مقادیر عددی: =، ≠، >، ≥، <، ≤	ساخت(های) برنامه‌تان را برای هدف‌یابی مشخص کنید. قبل‌از استفاده از این قانون، باید از قانون شناسه برنامه برای انتخاب برنامه Apple یا Android مرتبط با پروژه Firebase خود استفاده کنید.	این اپراتور فقط برای برنامه‌های Apple و Android دردسترس است. این شناسه با CFBundleVersion برنامه برای Apple و versionCode برای Android مطابقت دارد. مقایسه‌های رشته‌ای برای این قانون به حروف بزرگ و کوچک حساس است. هنگام استفاده از عملگرهای دقیقاً مطابقت دارد، دربردارد، دربرندارد، یا دربردارنده عبارت باقاعده است، می‌توانید چند مقدار را انتخاب کنید. هنگام استفاده از عملگر حاوی عبارت باقاعده، می‌توانید عبارت‌های باقاعده را در قالب RE2 ایجاد کنید. عبارت باقاعده شما می‌تواند با همه یا بخشی از رشته نسخه هدف مطابقت داشته باشد. همچنین می‌توانید از لنگرهای ^ و $ برای مطابقت دادن ابتدا، انتها، یا کل رشته هدف استفاده کنید.
Platform	==	iOS Android وب
سیستم‌عامل	==	سیستم‌عامل(های) موردنظر را برای هدف‌یابی مشخص کنید. قبل‌از استفاده از این قانون، باید از قانون شناسه برنامه برای انتخاب برنامه وب مرتبط با پروژه Firebase خود استفاده کنید.	این قانون برای نمونه برنامه وب داده‌شده به true ارزیابی می‌شود اگر سیستم‌عامل و نسخه آن با مقدار هدف در فهرست مشخص‌شده مطابقت داشته باشد.
مرورگر	==	مرورگر(های) موردنظر را مشخص کنید. قبل‌از استفاده از این قانون، باید از قانون شناسه برنامه برای انتخاب برنامه وب مرتبط با پروژه Firebase خود استفاده کنید.	این قانون برای نمونه برنامه وب داده‌شده به true ارزیابی می‌شود اگر مرورگر و نسخه آن با مقدار هدف در فهرست مشخص‌شده مطابقت داشته باشد.
دسته دستگاه	is, is not	تلفن همراه	این قانون ارزیابی می‌کند که دستگاهی که به برنامه وب شما دسترسی دارد، تلفن همراه است یا غیرتلفن همراه (رایانه یا کنسول). این نوع قانون فقط برای برنامه‌های وب دردسترس است.
زبان‌ها	داخل	یک یا چند زبان را انتخاب کنید.	این قانون برای نمونه برنامه داده‌شده به true ارزیابی می‌شود اگر آن نمونه برنامه در دستگاهی نصب شده باشد که از یکی از زبان‌های فهرست‌شده استفاده می‌کند.
کشور/منطقه	داخل	یک یا چند منطقه یا کشور را انتخاب کنید.	این قانون برای نمونه برنامه داده‌شده، اگر نمونه در هرکدام از مناطق یا کشورهای فهرست‌شده باشد، به true ارزیابی می‌شود. کد کشور دستگاه بااستفاده از نشانی IP دستگاه در درخواست یا کد کشور تعیین‌شده توسط Firebase Analytics (اگر داده‌های Analytics با Firebase هم‌رسانی شده باشد) تعیین می‌شود.
مخاطب(های) کاربر	شامل حداقل یک مورد	یک یا چند مخاطب را از فهرست Google Analytics مخاطبی که برای پروژه‌تان راه‌اندازی کرده‌اید انتخاب کنید.	این قانون به قانون «شناسه برنامه» نیاز دارد تا برنامه‌ای را که با پروژه Firebase شما مرتبط است انتخاب کند. توجه: چون بسیاری از مخاطبان Analytics براساس رویدادها یا ویژگی‌های کاربر تعریف می‌شوند، که می‌تواند براساس کنش‌های کاربران برنامه باشد، ممکن است مدتی طول بکشد تا قانون کاربر در مخاطب برای نمونه برنامه خاصی اعمال شود. این یعنی حتی اگر کاربری ازنظر فنی واجدشرایط مخاطب باشد، اگر Analytics هنوز کاربر را به مخاطب اضافه نکرده باشد، وقتی fetchAndActivate() اجرا شود، کاربر با شرایط مطابقت نخواهد داشت.
مشخصه کاربر	برای مقادیر رشته‌ای: شامل، شامل نمی‌شود، دقیقاً مطابقت دارد، شامل عبارت باقاعده است برای مقادیر عددی: =، ≠، >، ≥، <، ≤ توجه: در کلاینت، فقط می‌توانید مقادیر رشته‌ای برای مشخصه‌های کاربر تنظیم کنید. برای شرایطی که از عملگرهای عددی استفاده می‌کنند، Remote Config مقدار مشخصه کاربر مربوطه را به عدد صحیح/ اعشاری تبدیل می‌کند.	از فهرست ویژگی‌های کاربر Google Analytics دردسترس انتخاب کنید.	برای آشنایی با نحوه استفاده از مشخصه‌های کاربر برای سفارشی‌سازی برنامه برای بخش‌های بسیار خاصی از پایگاه کاربر، به Remote Config و مشخصه‌های کاربر مراجعه کنید. برای کسب اطلاعات بیشتر درباره ویژگی‌های کاربر، راهنماهای زیر را ببینید: تنظیم ویژگی‌های کاربر در Apple تنظیم کردن ویژگی‌های کاربر در Android هنگام استفاده از عملگرهای دقیقاً مطابقت دارد، دربردارد، دربرندارد، یا دربردارنده عبارت باقاعده است، می‌توانید چند مقدار را انتخاب کنید. هنگام استفاده از عملگر حاوی عبارت باقاعده، می‌توانید عبارت‌های باقاعده را در قالب RE2 ایجاد کنید. عبارت باقاعده شما می‌تواند با همه یا بخشی از رشته نسخه هدف مطابقت داشته باشد. همچنین می‌توانید از لنگرهای ^ و $ برای مطابقت دادن ابتدا، انتها، یا کل رشته هدف استفاده کنید. توجه: ویژگی‌های کاربر که به‌طور خودکار جمع‌آوری شده‌اند هنگام ایجاد شرایط Remote Config دردسترس نیستند.
کاربر در درصد تصادفی	لغزنده (در کنسول Firebase. REST API از عملگرهای <=،‏ >، و between استفاده می‌کند.	0-100	از این فیلد برای اعمال تغییر در نمونه تصادفی از نمونه‌های برنامه (با اندازه نمونه‌های کوچک تا ۰٫۰۰۰۱٪) استفاده کنید، بااستفاده از ابزاره لغزنده برای تقسیم کاربران به‌هم‌ریخته تصادفی (نمونه‌های برنامه) به گروه‌ها. هر نمونه برنامه به‌طور مداوم به یک عدد کامل یا کسری تصادفی، طبق یک مقدار اولیه تعریف‌شده در آن پروژه، نگاشت می‌شود. مقادیر بنیادی می‌توانند بین یک تا ۳۲ نویسه داشته باشند که شامل مقادیر الفباعددی، نقطه، خط تیره، و/یا زیرخط است. قانون از کلید پیش‌فرض (که به‌صورت ویرایش مقدار بنیادی در کنسول Firebase نشان داده می‌شود) استفاده خواهد کرد، مگراینکه مقدار بنیادی را تغییر دهید. با پاک کردن فیلد دانه می‌توانید قانون را به استفاده از کلید پیش‌فرض برگردانید. برای اینکه به‌طور مداوم نمونه‌های برنامه یکسانی را در محدوده‌های درصد مشخص‌شده هدف قرار دهید، از مقدار بنیادی یکسانی در شرایط استفاده کنید. یا با مشخص کردن یک مقدار اولیه جدید، گروه جدیدی از نمونه‌های برنامه را که به‌طور تصادفی اختصاص داده شده‌اند برای محدوده درصد معینی انتخاب کنید. برای مثال، برای ایجاد دو شرط مرتبط که هرکدام برای ۵٪ غیرهم‌پوشان از کاربران برنامه اعمال می‌شود، می‌توانید یک شرط را برای مطابقت با درصدی بین ۰٪ و ۵٪ پیکربندی کنید و شرط دیگر را برای مطابقت با محدوده‌ای بین ۵٪ و ۱۰٪ پیکربندی کنید. برای اینکه برخی‌از کاربران به‌طور تصادفی در هر دو گروه ظاهر شوند، از مقادیر بنیادی متفاوتی برای قوانین درون هر شرط استفاده کنید.
بخش واردشده	داخل	یک یا چند بخش واردشده را انتخاب کنید.	این قانون مستلزم راه‌اندازی بخش‌های واردشده سفارشی است.
تاریخ/ساعت	قبل، بعد	تاریخ و زمان مشخص‌شده، در منطقه زمانی دستگاه یا منطقه زمانی مشخص‌شده‌ای مثل «(GMT+11) وقت سیدنی».	زمان فعلی را با زمان واکشی دستگاه مقایسه می‌کند.
نخستین باز کردن	قبل، بعد	کاربران را براساس اولین باری که برنامه‌تان را باز می‌کنند هدف‌یابی کنید: کاربران جدید را انتخاب کنید تا کاربرانی را هدف قرار دهید که برای اولین‌بار برنامه شما را پس‌از تاریخ و زمان مشخصی در آینده باز می‌کنند. محدوده زمانی را انتخاب کنید تا کاربرانی را هدف قرار دهید که برای اولین‌بار برنامه شما را در محدوده قبل یا بعداز تاریخ و زمان مشخص‌شده باز می‌کنند. شرایط قبل و بعد را ترکیب کنید تا کاربران را در محدوده زمانی خاصی هدف‌یابی کنید.	هدف‌یابی کاربر براساس اولین باز کردن پس‌از انتخاب برنامه Android،‏ iOS، یا وب دردسترس است. به کیت‌های توسعه نرم‌افزار زیر نیاز دارد: کیت توسعه نرم‌افزار Firebase برای Google Analytics کیت توسعه نرم‌افزار پلاتفرم‌های Apple نسخه ۹.۰.۰+ یا کیت توسعه نرم‌افزار Android نسخه ۲۱.۱.۱+ (Firebase BoM نسخه ۳۰.۳.۰+)، و کیت توسعه نرم‌افزار JavaScript نسخه ۱۲.۸.۰+. Analytics باید درطول اولین رویداد باز در کارخواه فعال شده باشد.
شناسه نصب	داخل	یک یا چند شناسه نصب (حداکثر ۵۰) را برای هدف‌یابی مشخص کنید.	این قانون برای نصب مشخصی به true ارزیابی می‌شود اگر شناسه آن نصب در فهرست مقادیر جداشده با کاما باشد. برای آشنایی با نحوه دریافت شناسه‌های نصب، به بازیابی شناسه‌های مشتری مراجعه کنید.
کاربر وجود دارد	(بدون اپراتور)	همه کاربران همه برنامه‌های موجود در پروژه فعلی را هدف قرار می‌دهد.	از این قانون شرطی برای مطابقت دادن همه کاربران در پروژه، صرف‌نظر از برنامه یا پلاتفرم، استفاده کنید. هنگام استفاده از شخصی‌سازی Remote Config، می‌توانید از این عملگر استفاده کنید تا مطمئن شوید همه کاربران در پروژه مقادیر شخصی‌سازی‌شده را دریافت می‌کنند.
سیگنال سفارشی	برای مقادیر رشته‌ای: شامل، شامل نیست، دقیقاً مطابقت دارد، شامل عبارت باقاعده است برای مقادیر عددی: =، ≠، >، ≥، <، ≤ برای مقادیر نسخه: =، ≠، >، ≥، <، ≤	مقایسه‌های رشته‌ای برای این قانون به حروف بزرگ و کوچک حساس است. هنگام استفاده از عملگرهای «دقیقاً مطابقت دارد»، «شامل می‌شود»، «شامل نمی‌شود»، یا «شامل عبارت باقاعده می‌شود»، می‌توانید چند مقدار را انتخاب کنید. هنگام استفاده از عملگر عبارت باقاعده «شامل»، می‌توانید عبارت‌های باقاعده را در قالب RE2 ایجاد کنید. عبارت باقاعده شما می‌تواند با همه یا بخشی از رشته نسخه هدف مطابقت داشته باشد. همچنین می‌توانید از لنگرهای ^ و $ برای مطابقت دادن ابتدا، انتها، یا کل رشته هدف استفاده کنید. انواع داده‌های زیر برای محیط‌های مشتری پشتیبانی می‌شود: iOS: int, double ‫Android: int, long, double وب: شماره عددی که نشان‌دهنده شماره(های) نسخه برای مطابقت است (برای مثال، ۲.۱.۰).	برای اطلاعات بیشتر درباره شرایط سیگنال سفارشی و عبارت‌های شرطی قابل‌استفاده، به شرایط سیگنال سفارشی و عناصر مورداستفاده برای ایجاد شرایط مراجعه کنید.

پارامترها و شرایط جستجو

می‌توانید کلیدهای پارامتر، مقادیر پارامتر، و شرایط پروژه‌تان را از کنسول Firebase بااستفاده از چارگوش جستجو در بالای صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها جستجو کنید.

محدودیت‌های پارامترها و شرایط

در یک پروژه Firebase، می‌توانید حداکثر ۳۰۰۰ پارامتر و حداکثر ۲۰۰۰ شرط داشته باشید. کلیدهای پارامتر می‌توانند حداکثر ۲۵۶ نویسه داشته باشند، باید با زیرخط یا نویسه حرف انگلیسی (A-Z،‏ a-z) شروع شوند، و می‌توانند شامل عدد هم باشند. طول کل رشته‌های مقدار پارامتر در یک پروژه نمی‌تواند از ۱٬۰۰۰٬۰۰۰ نویسه بیشتر باشد. علاوه‌براین، قوانین شرطی براساس مشخصه‌های کاربر می‌تواند شامل حداکثر ۱۰۰ مقدار مشخصه کاربر باشد. برای مشاهده فهرست کامل محدودیت‌ها، به سهمیه‌ها و محدودیت‌ها مراجعه کنید.

مشاهده تغییرات پارامترها و شرایط

می‌توانید جدیدترین تغییرات الگوهای Remote Config را در کنسول Firebase مشاهده کنید. برای هر پارامتر و شرط جداگانه، می‌توانید:

• نام کاربری را که آخرین بار پارامتر یا شرط را اصلاح کرده است مشاهده کنید.

• اگر تغییر در همان روز رخ داده است، تعداد دقیقه‌ها یا ساعت‌هایی را که از زمان انتشار تغییر در الگوی فعال Remote Config گذشته است مشاهده کنید.

• اگر تغییر یک یا چند روز قبل رخ داده است، تاریخی را که تغییر در الگوی فعال Remote Config منتشر شده است مشاهده کنید.

سابقه تغییرات برای پارامترها

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > پارامترها بروید. ستون آخرین انتشار آخرین کاربری را که هر پارامتر را اصلاح کرده است و آخرین تاریخ انتشار تغییر را نشان می‌دهد:

• برای مشاهده فراداده تغییر برای پارامترهای گروه‌بندی‌شده، گروه پارامتر را ازهم باز کنید.

• برای مرتب‌سازی صعودی یا نزولی براساس تاریخ انتشار، روی برچسب ستون آخرین انتشار کلیک کنید.

سابقه تغییرات برای شرایط

در کنسول Firebase، به صفحه DevOps و تعامل > پیکربندی از راه دور > شرایط بروید. می‌توانید آخرین کاربری را که شرط را اصلاح کرده است و تاریخ اصلاح آن را در کنار آخرین اصلاح در زیر هر شرط ببینید.

مراحل بعدی

برای پیکربندی برنامه و پروژه Firebase جهت استفاده از Remote Config، شروع به کار با Firebase Remote Config را ببینید.