Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

פרמטרים ותנאים של תצורה מרחוק

בעת שימוש במסוף Firebase או ממשקי ה- API של Backend Remote Config , אתה מגדיר פרמטר אחד או יותר (זוגות ערך מפתח) ומספק ערכי ברירת מחדל בתוך היישום עבור אותם פרמטרים. באפשרותך לבטל ערכי ברירת מחדל בתוך האפליקציה על ידי הגדרת ערכי פרמטר בצד השרת. מקשי פרמטרים וערכי פרמטרים הם מחרוזות, אך ניתן להעביר ערכי פרמטרים כסוגי נתונים אחרים כאשר אתה משתמש בערכים אלה באפליקציה שלך.

באמצעות מסוף Firebase או ה- API של REST Remote Config , תוכל ליצור ערכי ברירת מחדל חדשים עבור הפרמטרים שלך, כמו גם ערכים מותנים המשמשים למיקוד לקבוצות של מופעי אפליקציה. בכל פעם שאתה מעדכן את התצורה שלך במסוף Firebase, Firebase יוצר ומפרסם גרסה חדשה של תבנית Config Remote. הגרסה הקודמת מאוחסנת, ומאפשרת לך לאחזר או להחזיר לאחור לפי הצורך. פעולות אלה זמינות עבורך גם דרך ה- REST API.

מדריך זה מסביר פרמטרים, תנאים, כללים, ערכים מותנים וכיצד יש עדיפות לערכי פרמטרים שונים בשרת Config Remote ובאפליקציה שלך. הוא גם מספק פרטים על סוגי הכללים המשמשים ליצירת תנאים.

תנאים, כללים וערכים מותנים

תנאי משמש למיקוד לקבוצת מופעי אפליקציות. התנאים מורכבים מכלל אחד או יותר, שכולם חייבים להעריך עד true כדי שהתנאי יוערך true עבור מופע יישום נתון. אם הערך עבור כלל אינו מוגדר (למשל, כאשר אין ערך זמין), כלל זה יוערך כ- false .

לדוגמא, פרמטר המגדיר את דף הספלש של אפליקציה יכול להציג תמונות שונות על פי סוג מערכת ההפעלה באמצעות הכלל הפשוט if device_os = Android :

לחלופין, ניתן להשתמש בתנאי זמן כדי לקבוע מתי האפליקציה שלך מציגה פריטי קידום מכירות מיוחדים.

לפרמטר יכולים להיות מספר ערכים מותנים המשתמשים בתנאים שונים, ופרמטרים יכולים לשתף תנאים בתוך פרויקט. בכרטיסיה פרמטרים במסוף Firebase, באפשרותך להציג את אחוז האחזור עבור הערכים המותנים של כל פרמטר. מדד זה מציין את אחוז הבקשות ב- 24 השעות האחרונות שקיבלו כל ערך.

עדיפות ערך פרמטר

לפרמטר עשויים להיות קשורים מספר ערכים מותנים. הכללים הבאים קובעים איזה ערך נשלף משרת Config Remote, ובאיזה ערך משתמשים במופע יישום נתון בנקודת זמן מסוימת:

ערכי פרמטר בצד השרת נאספים על פי רשימת העדיפויות הבאה

  1. ראשית, ערכים מותנים מוחלים, אם ישנם תנאים המוערכים true עבור מופע יישום נתון. אם מספר תנאים מוערכים true , הראשון (העליון) המוצג בממשק המשתמש של מסוף Firebase מקבל עדיפות, וערכים מותנים המשויכים לתנאי זה ניתנים כאשר אפליקציה מביאה ערכים מהקצה האחורי. ניתן לשנות את עדיפות התנאים על ידי גרירה ושחרור של תנאים בכרטיסיה תנאים .

  2. אם אין ערכים מותנים עם תנאים המוערכים true , ערך ברירת המחדל בצד השרת מסופק כאשר אפליקציה מביאה ערכים מה- backend. אם פרמטר אינו קיים בתוכנה האחורית, או אם ערך ברירת המחדל מוגדר ללא ערך , לא נקבע ערך עבור פרמטר זה כאשר אפליקציה תביא ערכים.

באפליקציה שלך, ערכי הפרמטרים מוחזרים בשיטות get בהתאם לרשימת העדיפויות הבאה

  1. אם הושג ערך מהקצה האחורי ואז הופעל, האפליקציה משתמשת בערך שנאסף. ערכי הפרמטרים המופעלים הם קבועים.
  2. אם לא הושג שום ערך מה- backend, או אם לא הופעלו ערכים שנאספו מה- back-Config Remote, היישום משתמש בערך ברירת המחדל בתוך היישום.
  3. אם לא הוגדר ערך ברירת מחדל בתוך האפליקציה, היישום משתמש בערך סוג סטטי (כגון 0 עבור int false עבור boolean ).

גרפיקה זו מסכמת את סדר העדיפויות של ערכי פרמטרים בתוכנה האחורית של Config Remote ובאפליקציה שלך:

קבוצות פרמטרים

Remote Config מאפשר לך לקבץ פרמטרים יחד למודל ממשק משתמש מאורגן יותר ומנטלי.

לדוגמה, נניח שעליך להפעיל או להשבית שלושה סוגי אימות שונים בזמן הפעלת תכונת כניסה חדשה. באמצעות Remote Config, תוכלו ליצור את שלושת הפרמטרים כדי לאפשר את הסוגים לפי הצורך, ואז לארגן אותם בקבוצה בשם "כניסה חדשה", ללא צורך להוסיף קידומות או מיון מיוחד.

באפשרותך ליצור קבוצות פרמטרים באמצעות מסוף Firebase או ממשק ה- API של REST Remote Config. לכל קבוצת פרמטרים שתיצור יש שם ייחודי בתבנית Config Remote שלך. בעת יצירת קבוצות פרמטרים, זכור:

  • פרמטרים יכולים להיכלל רק בקבוצה אחת בכל עת, ומפתח פרמטר עדיין צריך להיות ייחודי בכל הפרמטרים.
  • שמות קבוצות פרמטרים מוגבלים ל 256 תווים.
  • אם אתה משתמש גם ב- REST API וגם במסוף Firebase, ודא שכל לוגיקה של REST API מעודכנת לטיפול בקבוצות פרמטרים בפרסום.

צור או שנה קבוצות פרמטרים באמצעות מסוף Firebase

ניתן לקבץ פרמטרים בכרטיסייה פרמטרים במסוף Firebase. כדי ליצור או לשנות קבוצה:

  1. בחר נהל קבוצות .
  2. בחר תיבות סימון עבור פרמטרים שברצונך להוסיף ובחר העבר לקבוצה .
  3. בחר קבוצה קיימת, או צור קבוצה חדשה על ידי הזנת שם ותיאור ובחירה באפשרות צור קבוצה חדשה . לאחר שמירת קבוצה, ניתן לפרסם אותה באמצעות הלחצן פרסם שינויים .

צור קבוצות באופן פרוגרמטי

ממשק ה- API של REST Remote Config מספק דרך אוטומטית ליצור ולפרסם קבוצות פרמטרים. בהנחה שאתה מכיר את REST ומוגדר לאשר בקשות ל- API, אתה יכול לבצע את השלבים הבאים כדי לנהל קבוצות באופן פרוגרמטי:

  1. אחזר את התבנית הנוכחית
  2. הוסף אובייקטים JSON לייצג את קבוצות הפרמטרים שלך
  3. פרסם את קבוצות הפרמטרים באמצעות בקשת PUT של HTTP.

האובייקט parameterGroups מכיל מפתחות קבוצה, עם תיאור מקונן ורשימת פרמטרים מקובצים. שים לב שכל מפתח קבוצה חייב להיות ייחודי בעולם.

לדוגמה, הנה קטע pumpkin_spice_season תבנית שמוסיף את קבוצת הפרמטרים "תפריט חדש" עם פרמטר אחד, pumpkin_spice_season :

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

    …


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

סוגי כלל התנאים

סוגי הכללים הבאים נתמכים במסוף Firebase. פונקציונליות מקבילה זמינה ב- Remote Config REST API, כמפורט בהתייחס לביטוי מותנה .

סוג כלל מפעילים ערך הערה
אפליקציה == בחר מרשימת מזהי אפליקציות לאפליקציות המשויכות לפרויקט Firebase שלך. כאשר אתה מוסיף אפליקציה ל- Firebase, אתה מזין מזהה חבילה של iOS או שם חבילה של Android המגדיר מאפיין שנחשף כמזהה אפליקציה בכללי תצורה מרחוק.

השתמש במאפיין זה באופן הבא:
  • עבור iOS: השתמש ב- CFBundleIdentifier של האפליקציה. אתה יכול למצוא את מזהה הצרור בכרטיסיה כללי עבור היעד העיקרי של האפליקציה שלך ב- Xcode.
  • לאנדרואיד: השתמש ביישום היישום של האפליקציה . אתה יכול למצוא את applicationId בקובץ build.gradle ברמת האפליקציה שלך.
גרסת אפליקציה לערכי מחרוזת:
תואם בדיוק,
מכיל,
לא מכיל,
הבעה רגילה

לערכים מספריים:
=, ≠,>, ≥, <, ≤

ציין את גרסאות היישומים שלך שאליהם אתה ממקד.

לפני שתשתמש בכלל זה, עליך להשתמש בכללי זיהוי אפליקציה כדי לבחור אפליקציית Android / iOS המשויכת לפרויקט Firebase שלך.

עבור iOS: השתמש ב- CFBundleShortVersionString של האפליקציה.

הערה: וודא שאפליקציית iOS שלך משתמשת ב- Firebase iOS SDK בגרסה 6.24.0 ומעלה, מכיוון ש- CFBundleShortVersionString לא נשלח בגרסאות קודמות (ראה הערות גרסה ).

עבור אנדרואיד: השתמש באפליקציה שם גרסה .

השוואות מחרוזות לכלל זה תלויות רישיות. בעת שימוש באופרטור ההתאמה המדויק , המכיל , אינו מכיל או הביטוי הרגיל , ניתן לבחור מספר ערכים.

בעת שימוש במפעיל הביטוי הרגולרי , ניתן ליצור ביטויים רגולריים בפורמט RE2 . הביטוי הרגיל שלך יכול להתאים לכל מחרוזת גרסת היעד או לחלקה. אתה יכול גם להשתמש בעוגני ^ ו- $ כדי להתאים את ההתחלה, הסוף או את כל מחרוזת היעד.

לבנות מספר לערכי מחרוזת:
תואם בדיוק,
מכיל,
לא מכיל,
הבעה רגילה

לערכים מספריים:
=, ≠,>, ≥, <, ≤

ציין את המבנה / ים של האפליקציה שלך למיקוד.

לפני שתשתמש בכלל זה, עליך להשתמש בכללי מזהה אפליקציה כדי לבחור אפליקציית iOS או Android המשויכת לפרויקט Firebase שלך.

מפעיל זה זמין רק לאפליקציות iOS ו- Android. זה תואם ל- CFBundleVersion של האפליקציה ל- iOS ול- versionCode לאנדרואיד. השוואות מחרוזות לכלל זה תלויות רישיות.

בעת שימוש באופרטור ההתאמה המדויק , המכיל , אינו מכיל או הביטוי הרגיל , ניתן לבחור מספר ערכים.

בעת שימוש במפעיל הביטוי הרגולרי , ניתן ליצור ביטויים רגולריים בפורמט RE2 . הביטוי הרגיל שלך יכול להתאים לכל מחרוזת גרסת היעד או לחלקה. אתה יכול גם להשתמש בעוגני ^ ו- $ כדי להתאים את ההתחלה, הסוף או את כל מחרוזת היעד.

פּלַטפוֹרמָה == iOS
דְמוּי אָדָם
אינטרנט
מערכת הפעלה ==

ציין את מערכות ההפעלה אליהן אתה רוצה למקד.

לפני שתשתמש בכלל זה, עליך להשתמש בכללי מזהה אפליקציה כדי לבחור אפליקציית אינטרנט המשויכת לפרויקט Firebase שלך.

כלל זה מוערך true עבור מופע יישום אינטרנט מסוים אם מערכת ההפעלה וגרסתה תואמות ערך יעד ברשימה שצוינה.
דפדפן ==

ציין את הדפדפנים שאליהם אתה רוצה למקד.

לפני שתשתמש בכלל זה, עליך להשתמש בכללי מזהה אפליקציה כדי לבחור אפליקציית אינטרנט המשויכת לפרויקט Firebase שלך.

כלל זה מוערך כ- true עבור מופע יישום אינטרנט מסוים אם הדפדפן וגרסתו תואמים לערך יעד ברשימה שצוינה.
תאריך שעה <=,> תאריך ושעה מוגדרים, באזור הזמן של המכשיר או באזור זמן מוגדר כגון "(GMT + 11) שעון סידני." משווה את הזמן הנוכחי לזמן אחזור המכשיר.
משתמש באחוזים אקראיים <=,> 0-100

השתמש בשדה זה כדי להחיל שינוי על מדגם אקראי של מופעי אפליקציות (בגדלים מדומים קטנים כמו .0001%), תוך שימוש במפעילים <= ו- > לפלח משתמשים (מופעי אפליקציה) לקבוצות.

כל מופע של אפליקציה ממופה באופן קבוע למספר אקראי שלם או חלקי, על פי מפתח שהוגדר בפרויקט זה. כלל ישתמש במקש ברירת המחדל (מוצג כ- DEF במסוף Firebase) אלא אם כן תבחר או תיצור מפתח אחר. באפשרותך להחזיר כלל לשימוש במקש ברירת המחדל על ידי ניקוי שדה אקראי באמצעות שדה מפתח זה . תוכל להשתמש במקש יחיד בכללים כדי לטפל בעקביות באותם מופעי אפליקציה בטווחי אחוז נתונים. לחלופין, תוכל לבחור קבוצה חדשה שהוקצה באופן אקראי של מופעי אפליקציה לטווח אחוזים נתון על ידי יצירת מפתח חדש.

לדוגמא, כדי ליצור שני תנאים קשורים שכל אחד מהם חל על 5% לא חופפים ממשתמשי האפליקציה, ייתכן שתנאי אחד יכלול כלל <= 5% , ותנאי אחר יכלול גם כלל > 5% וגם <= כלל 10% . כדי לאפשר לחלק מהמשתמשים להופיע באופן אקראי בשתי הקבוצות, השתמש במקשים שונים עבור הכללים בכל תנאי.

משתמש בקהל == בחר אחד או יותר מרשימת קהלי Google Analytics שהגדרת עבור הפרויקט שלך.

כלל זה מחייב כלל מזהה אפליקציה כדי לבחור אפליקציה המשויכת לפרויקט Firebase שלך.

הערה: מכיוון שקהלים רבים ב- Analytics מוגדרים על ידי אירועים או מאפייני משתמש, אשר יכולים להתבסס על פעולותיהם של משתמשי האפליקציה, ייתכן שייקח זמן מה עד שכל משתמש בקהל ייכנס לתוקף עבור מופע יישום מסוים.

מכשיר באזור / מדינה == בחר אזור אחד או יותר מארצות. כלל זה מוערך true עבור מופע אפליקציה נתון אם המופע נמצא באיזורים או ארצות המפורטים. קוד המדינה של המכשיר נקבע באמצעות כתובת ה- IP של המכשיר בבקשה או בקוד המדינה שנקבע על ידי Firebase Analytics (אם נתוני Analytics משותפים עם Firebase).
שפת המכשיר == בחר שפה אחת או יותר. כלל זה מוערך true עבור מופע יישום נתון אם מופע יישום זה מותקן במכשיר המשתמש באחת מהשפות המפורטות.
נכס משתמש לערכי מחרוזת:
מכיל,
לא מכיל,
תואם בדיוק,
הבעה רגילה

לערכים מספריים:
=, ≠,>, ≥, <, ≤

הערה: בלקוח, אתה יכול להגדיר רק ערכי מחרוזות עבור מאפייני המשתמש. בתנאים המשתמשים במפעילים מספריים, Remote Config ממיר את הערך של מאפיין המשתמש המתאים למספר שלם / צף.
בחר מתוך רשימה של מאפייני משתמש זמינים ב- Google Analytics. כדי ללמוד כיצד ניתן להשתמש במאפייני משתמש להתאמה אישית של האפליקציה שלך עבור פלחים ספציפיים מאוד בבסיס המשתמשים שלך, ראה תצורה מרחוק ומאפייני משתמש .

למידע נוסף על מאפייני משתמש, עיין במדריכים הבאים:

בעת שימוש באופרטור ההתאמה , המכיל , אינו מכיל או הביטוי הרגיל , ניתן לבחור מספר ערכים.

בעת שימוש במפעיל הביטוי הרגולרי , ניתן ליצור ביטויים רגולריים בפורמט RE2 . הביטוי הרגיל שלך יכול להתאים לכל מחרוזת גרסת היעד או לחלקה. אתה יכול גם להשתמש בעוגני ^ ו- $ כדי להתאים את ההתחלה, הסוף או את כל מחרוזת היעד.

הערה: מאפייני משתמש שנאספו אוטומטית אינם זמינים כעת בעת יצירת תנאי תצורה מרחוק.
פלח מיובא == בחר קטע מיובא אחד או יותר. כלל זה מחייב הגדרת פלחים מיובאים בהתאמה אישית.

חיפוש פרמטרים ותנאים

באפשרותך לחפש את מקשי הפרמטרים, ערכי הפרמטרים והתנאים של הפרויקט שלך ממסוף Firebase באמצעות תיבת החיפוש בחלק העליון של הכרטיסייה פרמטרים של תצורת תצורה מרחוק.

מגבלות על פרמטרים ותנאים

במסגרת פרויקט Firebase, אתה יכול להכיל עד 2000 פרמטרים ועד 500 תנאים. מקשי פרמטרים יכולים להיות באורך של עד 256 תווים, עליהם להתחיל בתו תחתון או אות אנגלית (AZ, az), והם עשויים לכלול מספרים. האורך הכולל של מחרוזות ערך הפרמטר בתוך פרויקט לא יכול לחרוג מ- 800,000 תווים.

הצעדים הבאים

כדי להתחיל בהגדרת התצורה של פרויקט Firebase שלך, ראה הגדרת פרוייקט תצורה מרחוק של Firebase .