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

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

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

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

  • פרמטרים ותנאים בתבניות לקוח: הגדרות הצגה למופעים של אפליקציות לקוח בפלטפורמות של Apple,‏ Android,‏ Web,‏ 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, שירותים לקצה העורפי)
thought ערכות SDK נתמכות ערכות Firebase SDK ללקוח Firebase Admin SDK (Node.js, ‏ Python, ‏ Go, ‏ Java)
מודל הערכה אוחזר ונשמר במטמון במכשירי הלקוח; מופעל על ידי קוד האפליקציה נטענים לזיכרון השרת; נבדקים לכל בקשה עם זמן אחזור כמעט אפסי
כללי תנאים גרסת האפליקציה, מערכת ההפעלה/הפלטפורמה, שפת המכשיר, המדינה/האזור, Analytics קהלים ומאפייני משתמשים, משתמש באחוזון אקראי, פתיחה ראשונה של האפליקציה, אותות מותאמים אישית של הלקוח משתמש באחוז אקראי, אותות מותאמים אישית מהשרת
תרחישים נפוצים לדוגמה השקות של תכונות, מבצעים עונתיים, עיצובים של ממשק המשתמש, A/B Testing, התאמה אישית בחירת הנחיות ומודלים של AI, feature flag בצד השרת, הגבלת קצב של יצירת בקשות בקצה העורפי, ניתוב דינמי
מדריך מפורט פרמטרים בתבניות של לקוחות פרמטרים בתבניות בצד השרת

מושגי ליבה

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

פרמטרים

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

  • מפתחות של פרמטרים: מזהי מחרוזות של הפרמטרים. המפתחות יכולים להיות באורך של עד 256 תווים, חייבים להתחיל בקו תחתון או באות באנגלית (A-Z,‏ a-z) ויכולים לכלול מספרים.
  • ערכי פרמטרים: הערכים שהוקצו לפרמטרים. הערכים נשמרים כמחרוזות, אבל אפשר לבחור סוגי נתונים במסוף כדי לאמת ערכים מול פורמטים כמו String,‏ Boolean,‏ Number או JSON.
  • ערכי ברירת מחדל: ערך הבסיס שמוקצה כשלא חלים כללי תנאים. אתם יכולים להגדיר ערכי ברירת מחדל בתוך האפליקציה בקוד שלכם, וגם ערכי ברירת מחדל לתבניות בקצה העורפי של Remote Config.

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

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

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

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

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

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

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

ניהול גרסאות של תבניות וחזרה לגרסאות קודמות

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

ניהול גרסאות של תבניות Remote Config

מכסות ומגבלות

בפרויקט ב-Firebase, המערכת של Remote Config אוכפת את המגבלות הבאות:

  • פרמטרים: עד 3,000 פרמטרים לכל פרויקט.
  • תנאים: עד 2,000 תנאים לכל פרויקט.
  • אורך מפתח הפרמטר: עד 256 תווים.
  • אורך המחרוזת הכולל של הערכים: עד 1,000,000 תווים בכל ערכי הפרמטרים בפרויקט.

לרשימה המלאה של המגבלות, ראו מכסות ומגבלות.

השלבים הבאים