พารามิเตอร์และเงื่อนไขการกำหนดค่าระยะไกล

คุณสามารถกำหนดค่าเทมเพลตสำหรับทั้งกรณีการใช้งานของไคลเอ็นต์และเซิร์ฟเวอร์ได้ ลูกค้า จะแสดงไปยังอินสแตนซ์ของแอปทั้งหมดที่ใช้งาน Firebase SDK ของไคลเอ็นต์สำหรับ Remote Config ซึ่งรวมถึง Android, Apple, เว็บ, Unity แอป Flutter และ C++ Remote Config พารามิเตอร์และค่าจาก เทมเพลตเฉพาะเซิร์ฟเวอร์จะแสดงในการใช้งาน Remote Config (รวมถึง Cloud Run และ Cloud Functions) ที่ใช้ผู้ดูแลระบบ Firebase Node.js SDK v12.1.0 ขึ้นไป

เมื่อใช้คอนโซล Firebase หรือ API แบ็กเอนด์ Remote Config รายการ คุณกำหนดพารามิเตอร์อย่างน้อย 1 รายการ (คีย์-ค่า) ) และระบุค่าเริ่มต้นในแอปสำหรับพารามิเตอร์เหล่านั้น คุณสามารถลบล้าง ค่าเริ่มต้นในแอปโดยการกําหนดค่าพารามิเตอร์ คีย์พารามิเตอร์และค่าพารามิเตอร์เป็นสตริง แต่ ค่าพารามิเตอร์สามารถแคสต์เป็นข้อมูลประเภทอื่นๆ เมื่อคุณใช้ค่าเหล่านี้ใน แอปของคุณ

เมื่อใช้คอนโซล Firebase Admin SDK หรือ Remote Config REST API คุณสามารถสร้างค่าเริ่มต้นใหม่สำหรับ รวมถึงค่าแบบมีเงื่อนไขซึ่งใช้กำหนดเป้าหมายกลุ่มของแอป อินสแตนซ์ ทุกครั้งที่คุณอัปเดตการกำหนดค่าในคอนโซล Firebase Firebase สร้างและเผยแพร่เทมเพลต Remote Config เวอร์ชันใหม่ เวอร์ชันก่อนหน้าจะได้รับการจัดเก็บไว้ เพื่อให้คุณเรียกดูหรือย้อนกลับได้ตามที่ต้องการ การดำเนินการเหล่านี้พร้อมให้คุณใช้งานผ่านคอนโซล Firebase Firebase Admin SDK และ REST API และมีการอธิบายอย่างครอบคลุมมากขึ้นใน จัดการเวอร์ชันเทมเพลต Remote Config รายการ

คู่มือนี้จะอธิบายพารามิเตอร์ เงื่อนไข กฎ และแบบมีเงื่อนไข และวิธีจัดลำดับความสำคัญของค่าพารามิเตอร์ต่างๆ Remote Config เซิร์ฟเวอร์และในแอปของคุณ และยังมีรายละเอียดเกี่ยวกับประเภท ของกฎที่ใช้สร้างเงื่อนไข

เงื่อนไข กฎ และค่าแบบมีเงื่อนไข

ระบบใช้เงื่อนไขเพื่อกำหนดเป้าหมายกลุ่มของอินสแตนซ์แอป สร้างเงื่อนไขแล้ว กฎอย่างน้อย 1 ข้อที่ต้องประเมินผลเป็น true สำหรับเงื่อนไข ประเมินผลเป็น true สำหรับอินสแตนซ์ของแอปที่ระบุ หากค่าของกฎคือ ไม่ระบุ (เช่น เมื่อไม่มีค่าที่ใช้ได้) กฎนั้นจะประเมินค่าเป็น false

เช่น พารามิเตอร์ที่กำหนด หน้าจอแนะนำของแอปอาจแสดงรูปภาพที่ต่างกัน ขึ้นอยู่กับประเภทระบบปฏิบัติการที่ใช้ กฎง่ายๆ if device_os = Android:

จับภาพหน้าจอของ "Splash_page" ในคอนโซล Firebase ที่แสดงค่าเริ่มต้นสําหรับ iOS และค่าแบบมีเงื่อนไขสําหรับ Android

หรือเงื่อนไขเวลา สามารถใช้ในการควบคุมเวลาที่แอปของคุณจะแสดงแบบพิเศษ สินค้าโปรโมชัน

พารามิเตอร์หนึ่งๆ อาจมีเงื่อนไข ที่ใช้เงื่อนไขที่แตกต่างกัน และพารามิเตอร์สามารถใช้เงื่อนไขร่วมกันภายใน โปรเจ็กต์ ในแท็บพารามิเตอร์ ของคอนโซล Firebase คุณสามารถดูเปอร์เซ็นต์การดึงข้อมูลของแต่ละ ค่าแบบมีเงื่อนไขของพารามิเตอร์ เมตริกนี้ระบุเปอร์เซ็นต์ของคำขอ ในช่วง 24 ชั่วโมงที่ผ่านมาซึ่งได้รับแต่ละค่า

ลำดับความสำคัญของค่าพารามิเตอร์

พารามิเตอร์อาจมีค่าแบบมีเงื่อนไขหลายรายการเชื่อมโยงอยู่ กฎต่อไปนี้จะกำหนดว่าค่าใดที่ดึงข้อมูลจาก Remote Config เซิร์ฟเวอร์ และค่าที่ใช้ในอินสแตนซ์ของแอปที่ระบุ ณ จุดใดจุดหนึ่งใน เวลา:

ระบบจะดึงข้อมูลค่าพารามิเตอร์ตามลำดับความสำคัญต่อไปนี้ รายการ

  1. อย่างแรก จะใช้ค่าแบบมีเงื่อนไข หากมีเงื่อนไขที่ประเมิน เป็น true สำหรับอินสแตนซ์ของแอปที่ระบุ หากมีหลายเงื่อนไขที่ประเมินเป็น true รายการแรก (ด้านบน) ที่แสดงใน UI ของคอนโซล 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

คุณเลือกประเภทข้อมูลได้ในเมนูแบบเลื่อนลงถัดไปใน UI ของคอนโซล Firebase ลงในคีย์พารามิเตอร์ ในประเภท API ของ REST นั้นตั้งค่าได้โดยใช้ value_type ภายในออบเจ็กต์พารามิเตอร์

กลุ่มพารามิเตอร์

Remote Config ช่วยให้คุณจัดกลุ่มพารามิเตอร์เข้าด้วยกันเพื่อให้เป็นระเบียบมากขึ้น UI และโมเดลในจิตใจ

ตัวอย่างเช่น สมมติว่าคุณต้องเปิดหรือปิดใช้การตรวจสอบสิทธิ์ 3 ประเภท ระหว่างที่เปิดตัวฟีเจอร์การเข้าสู่ระบบใหม่ Remote Configช่วยให้คุณสร้าง พารามิเตอร์ทั้ง 3 รายการนี้เพื่อเปิดใช้ประเภทตามต้องการ แล้วจัดระเบียบใน กลุ่มชื่อ "การเข้าสู่ระบบใหม่" โดยไม่จำเป็นต้องเพิ่มคำนำหน้าหรือการจัดเรียงพิเศษ

คุณสามารถสร้างกลุ่มพารามิเตอร์โดยใช้คอนโซล Firebase หรือ Remote Config REST API กลุ่มพารามิเตอร์แต่ละกลุ่มที่คุณสร้างมีชื่อที่ไม่ซ้ำกัน เทมเพลต Remote Config โปรดคํานึงถึงสิ่งต่อไปนี้เมื่อสร้างกลุ่มพารามิเตอร์

  • คุณสามารถใส่พารามิเตอร์ไว้ในกลุ่มเดียวได้ตลอดเวลา และพารามิเตอร์ คีย์ต้องไม่ซ้ำกันในพารามิเตอร์ทั้งหมด
  • ชื่อกลุ่มพารามิเตอร์มีอักขระได้ไม่เกิน 256 ตัว
  • หากคุณใช้ทั้ง REST API และคอนโซล Firebase โปรดตรวจสอบว่า อัปเดตตรรกะ REST API เพื่อจัดการกลุ่มพารามิเตอร์เมื่อเผยแพร่

สร้างหรือแก้ไขกลุ่มพารามิเตอร์โดยใช้คอนโซล Firebase

คุณสามารถจัดกลุ่มพารามิเตอร์ใน แท็บพารามิเตอร์ของ คอนโซล Firebase วิธีสร้างหรือแก้ไขกลุ่ม

  1. เลือกจัดการกลุ่ม
  2. เลือกช่องทำเครื่องหมายของพารามิเตอร์ที่ต้องการเพิ่มและเลือก ย้ายไปที่กลุ่ม
  3. เลือกกลุ่มที่มีอยู่หรือสร้างกลุ่มใหม่โดยป้อนชื่อและ คำอธิบาย แล้วเลือกสร้างกลุ่มใหม่ หลังจากบันทึกกลุ่มแล้ว คุณจะเผยแพร่กลุ่มได้โดยใช้ ปุ่มเผยแพร่การเปลี่ยนแปลง

สร้างกลุ่มแบบเป็นโปรแกรม

API ของ REST สำหรับการกำหนดค่าระยะไกล มี วิธีสร้างและเผยแพร่กลุ่มพารามิเตอร์โดยอัตโนมัติ สมมติว่าคุณคุ้นเคยกับ 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 currently pumpkin spice season."
        }
      }
    }
  }
}

ประเภทกฎเงื่อนไข

คอนโซล Firebase รองรับกฎประเภทต่อไปนี้ เทียบเท่า มีฟังก์ชันการทำงานนี้ใน Remote Config REST API ตามรายละเอียดใน การอ้างอิงนิพจน์เงื่อนไข

ประเภทของกฎ ผู้ดำเนินการ ค่า หมายเหตุ
แอป == เลือกจากรายการรหัสแอปสำหรับแอปที่เชื่อมโยงกับ Firebase เมื่อเพิ่มแอปลงใน Firebase ให้ป้อนรหัสชุดหรือ Android ชื่อแพ็กเกจที่กำหนดแอตทริบิวต์ที่แสดงเป็นรหัสแอปใน กฎ Remote Config ข้อ

ใช้แอตทริบิวต์นี้ดังนี้
  • สำหรับแพลตฟอร์ม Apple: ใช้แอป CFBundleIdentifier คุณสามารถค้นหารหัสชุดได้ในแท็บทั่วไปสำหรับ เป้าหมายหลักของแอปใน Xcode
  • สำหรับ Android: ใช้แอปต่อไปนี้ applicationId คุณสามารถดูapplicationIdได้ในระดับแอป build.gradle
เวอร์ชันของแอป สำหรับค่าสตริง:
ตรงทั้งหมด,
มี,
ไม่มี,
นิพจน์ทั่วไป

สำหรับค่าที่เป็นตัวเลข
=, ≠, >, ≥, <, ≤

ระบุเวอร์ชันของแอปที่จะกำหนดเป้าหมาย

ก่อนที่จะใช้กฎนี้ คุณต้องใช้กฎรหัสแอปเพื่อเลือก แอป Android/Apple ที่เชื่อมโยงกับโปรเจ็กต์ Firebase

สำหรับแพลตฟอร์ม Apple: ใช้ CFBundleShortVersionString ของแอป

หมายเหตุ: ตรวจสอบว่าแอป Apple ใช้ SDK สำหรับแพลตฟอร์ม Firebase ของ Firebase เวอร์ชัน 6.24.0 ขึ้นไปเนื่องจากไม่มีการส่ง CFBundleShortVersionString เวอร์ชันก่อนหน้า (ดูบันทึกประจำรุ่น)

สำหรับ Android: ใช้ versionName ของแอป

การเปรียบเทียบสตริงสำหรับกฎนี้จะพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เมื่อใช้ ตรงกันทุกประการ, มี, ไม่มี หรือนิพจน์ทั่วไป คุณสามารถเลือกหลายค่าได้

เมื่อใช้โอเปอเรเตอร์นิพจน์ทั่วไป คุณสามารถสร้าง นิพจน์ใน RE2 นิพจน์ทั่วไปสามารถจับคู่กับเวอร์ชันเป้าหมายทั้งหมดหรือบางส่วน สตริง นอกจากนี้ คุณยังสามารถใช้แท็ก Anchor ^ และ $ เพื่อจับคู่ จุดเริ่มต้น จุดสิ้นสุด หรือทั้งหมดของสตริงเป้าหมาย
หมายเลขบิลด์ สำหรับค่าสตริง:
ตรงทั้งหมด,
มี,
ไม่มี,
นิพจน์ทั่วไป

สำหรับค่าที่เป็นตัวเลข
=, ≠, >, ≥, <, ≤

ระบุบิลด์ของแอปที่จะกำหนดเป้าหมาย

ก่อนใช้กฎนี้ คุณต้องใช้กฎรหัสแอปเพื่อเลือก Apple หรือ แอป Android ที่เชื่อมโยงกับโปรเจ็กต์ Firebase

โอเปอเรเตอร์นี้ใช้ได้กับแอป Apple และ Android เท่านั้น ซึ่งสอดคล้องกับ CFBundleVersion สำหรับ Apple และ versionCode สำหรับ Android การเปรียบเทียบสตริงสำหรับกฎนี้คือ คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

เมื่อใช้รายการที่ตรงกันทั้งหมด มี ไม่มี หรือนิพจน์ทั่วไป คุณสามารถเลือกหลายค่าได้

เมื่อใช้โอเปอเรเตอร์นิพจน์ทั่วไป คุณสามารถสร้าง นิพจน์ใน RE2 นิพจน์ทั่วไปสามารถจับคู่กับเวอร์ชันเป้าหมายทั้งหมดหรือบางส่วน สตริง นอกจากนี้ คุณยังสามารถใช้แท็ก Anchor ^ และ $ เพื่อจับคู่ จุดเริ่มต้น จุดสิ้นสุด หรือทั้งหมดของสตริงเป้าหมาย
แพลตฟอร์ม == iOS
Android
เว็บ		  
ระบบปฏิบัติการ ==

ระบุระบบปฏิบัติการที่จะกำหนดเป้าหมาย

ก่อนที่จะใช้กฎนี้ คุณต้องใช้กฎรหัสแอปเพื่อเลือก เว็บแอปที่เชื่อมโยงกับโปรเจ็กต์ Firebase

 กฎนี้จะประเมินค่าเป็น true สำหรับอินสแตนซ์ของเว็บแอปหนึ่งๆ หาก ระบบปฏิบัติการและเวอร์ชันของระบบปฏิบัติการตรงกับค่าเป้าหมายในรายการที่ระบุ
เบราว์เซอร์ ==

ระบุเบราว์เซอร์ที่จะกำหนดเป้าหมาย

ก่อนที่จะใช้กฎนี้ คุณต้องใช้กฎรหัสแอปเพื่อเลือก เว็บแอปที่เชื่อมโยงกับโปรเจ็กต์ Firebase

 กฎนี้จะประเมินค่าเป็น true สำหรับอินสแตนซ์ของเว็บแอปหนึ่งๆ หาก และเวอร์ชันของเบราว์เซอร์ตรงกับค่าเป้าหมายในรายการที่ระบุ
หมวดหมู่ของอุปกรณ์ เท่ากับ, ไม่เท่ากับ อุปกรณ์เคลื่อนที่ กฎนี้ประเมินว่าอุปกรณ์ที่เข้าถึงเว็บแอปของคุณเป็นอุปกรณ์เคลื่อนที่หรือ ไม่ใช่อุปกรณ์เคลื่อนที่ (เดสก์ท็อปหรือคอนโซล) กฎประเภทนี้ใช้ได้กับเว็บเท่านั้น แอป
ภาษา อยู่ใน เลือกอย่างน้อย 1 ภาษา กฎนี้จะประเมินค่าเป็น true สำหรับอินสแตนซ์ของแอปหนึ่งๆ หาก อินสแตนซ์ของแอปได้รับการติดตั้งในอุปกรณ์ที่ใช้ภาษาใดภาษาหนึ่งที่แสดงอยู่
ประเทศ/ภูมิภาค อยู่ใน เลือกภูมิภาคหรือประเทศอย่างน้อย 1 รายการ กฎนี้จะประเมินค่าเป็น true สำหรับอินสแตนซ์ของแอปหนึ่งๆ หาก อยู่ในภูมิภาคหรือประเทศใดประเทศหนึ่งที่อยู่ในรายการ รหัสประเทศของอุปกรณ์ จะกำหนดโดยใช้ที่อยู่ IP ของอุปกรณ์ในคำขอหรือรหัสประเทศ กำหนดโดย Firebase Analytics (หากมีการแชร์ข้อมูล Analytics กับ Firebase)
กลุ่มเป้าหมายที่เป็นผู้ใช้ รวมอย่างน้อย 1 รายการ เลือกอย่างน้อย 1 กลุ่มจากรายการกลุ่มเป้าหมาย Google Analytics กลุ่ม ที่คุณสร้างไว้สำหรับโปรเจ็กต์

กฎนี้ต้องใช้กฎรหัสแอปเพื่อเลือกแอปที่เชื่อมโยงกับ โปรเจ็กต์ Firebase

หมายเหตุ: เนื่องจากกลุ่มเป้าหมายAnalyticsจำนวนมากได้รับการกำหนดโดยเหตุการณ์หรือ พร็อพเพอร์ตี้ผู้ใช้ ซึ่งอาจพิจารณาจากการดำเนินการของผู้ใช้แอป รอให้กฎผู้ใช้ในกลุ่มเป้าหมายมีผลสำหรับแอปหนึ่งๆ อินสแตนซ์

พร็อพเพอร์ตี้ผู้ใช้ สำหรับค่าสตริง
มี
ไม่มี
ตรงทุกประการกับ
นิพจน์ทั่วไป

สำหรับค่าที่เป็นตัวเลข
=, ≠, >, ≥, <, ≤

หมายเหตุ: ในไคลเอ็นต์ คุณจะตั้งค่าได้เฉพาะค่าสตริงสำหรับผู้ใช้เท่านั้น พร็อพเพอร์ตี้ สำหรับเงื่อนไขที่ใช้โอเปอเรเตอร์ที่เป็นตัวเลข Remote Config จะแปลงค่าของ ลงในจำนวนเต็ม/จำนวนทศนิยม 		เลือกจากรายชื่อผู้ใช้ Google Analytics ที่มีอยู่ พร็อพเพอร์ตี้ ดูวิธีใช้พร็อพเพอร์ตี้ผู้ใช้เพื่อปรับแต่งแอปสําหรับ ดูกลุ่มที่เจาะจงมากๆ ในฐานผู้ใช้ของคุณ Remote Config และพร็อพเพอร์ตี้ผู้ใช้

ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ผู้ใช้ได้จากคู่มือต่อไปนี้

เมื่อใช้รายการที่ตรงกันทั้งหมด มี ไม่มี หรือนิพจน์ทั่วไป คุณสามารถเลือกหลายค่าได้

เมื่อใช้โอเปอเรเตอร์นิพจน์ทั่วไป คุณสามารถสร้าง นิพจน์ใน RE2 นิพจน์ทั่วไปสามารถจับคู่กับเวอร์ชันเป้าหมายทั้งหมดหรือบางส่วน สตริง นอกจากนี้ คุณยังสามารถใช้แท็ก Anchor ^ และ $ เพื่อจับคู่ จุดเริ่มต้น จุดสิ้นสุด หรือทั้งหมดของสตริงเป้าหมาย

หมายเหตุ: พร็อพเพอร์ตี้ผู้ใช้ที่รวบรวมโดยอัตโนมัติ ไม่พร้อมใช้งานในขณะนี้เมื่อสร้างเงื่อนไข Remote Config
ผู้ใช้ในเปอร์เซ็นต์แบบสุ่ม แถบเลื่อน (ในคอนโซล Firebase REST API ใช้ โอเปอเรเตอร์ <=, > และ between) 0-100

ใช้ช่องนี้เพื่อใช้การเปลี่ยนแปลงกับตัวอย่างแบบสุ่มของอินสแตนซ์แอป (โดยมีขนาดการสุ่มตัวอย่างเล็กเพียง .0001%) โดยใช้วิดเจ็ตแถบเลื่อน เพื่อแบ่งกลุ่มผู้ใช้ที่สับเปลี่ยนแบบสุ่ม (อินสแตนซ์ของแอป) เป็นกลุ่มๆ

ระบบจะแมปอินสแตนซ์ของแอปแต่ละรายการกับอินสแตนซ์ทั้งหมดแบบสุ่มแบบถาวร หรือเศษส่วนตาม seed ที่กำหนดไว้ในโปรเจ็กต์นั้น

กฎจะใช้คีย์เริ่มต้น (แสดงเป็นแก้ไข Seed ใน Firebase) เว้นแต่คุณจะแก้ไขค่าตั้งต้น คุณสามารถคืนค่ากฎไปยัง ใช้คีย์เริ่มต้นโดยการล้างช่อง Seed

เพื่อจัดการกับอินสแตนซ์แอปเดียวกันภายในเปอร์เซ็นต์ที่ระบุให้สอดคล้องกัน ให้ใช้ค่าตั้งต้นเดียวกันในเงื่อนไขต่างๆ หรือเลือก กลุ่มอินสแตนซ์ของแอปที่กำหนดแบบสุ่มสำหรับช่วงเปอร์เซ็นต์ที่กำหนดตาม ระบุ Seed ใหม่

เช่น ในการสร้างเงื่อนไขที่เกี่ยวข้อง 2 ข้อ โดยแต่ละเงื่อนไขจะใช้กับ ไม่ทับซ้อนกัน 5% ของผู้ใช้แอป คุณสามารถกำหนดค่าเงื่อนไข 1 รายการให้จับคู่กับ เปอร์เซ็นต์ระหว่าง 0% ถึง 5% และกำหนดค่าเงื่อนไขอื่นให้ตรงกับช่วง ระหว่าง 5% ถึง 10% หากต้องการให้ผู้ใช้บางรายปรากฏแบบสุ่มในทั้ง 2 กลุ่ม ให้ใช้ ค่าตั้งต้นที่แตกต่างกันสำหรับกฎภายในแต่ละเงื่อนไข

กลุ่มที่นำเข้า อยู่ใน เลือกกลุ่มที่นำเข้าอย่างน้อย 1 กลุ่ม กฎนี้ต้องมีการตั้งค่าที่กำหนดเอง กลุ่มที่นำเข้า
วันที่/เวลา ก่อน หลัง วันที่และเวลาที่ระบุ ทั้งในเขตเวลาของอุปกรณ์หรือเวลาที่ระบุ เช่น "(GMT+11) เวลาซิดนีย์" เปรียบเทียบเวลาปัจจุบันกับเวลาดึงข้อมูลอุปกรณ์
การเปิดครั้งแรก ก่อน หลัง วันที่และเวลาที่ระบุในเขตเวลาที่ระบุ

จับคู่ผู้ใช้ที่เปิดแอปเป้าหมายเป็นครั้งแรกภายในรายการที่ระบุ ช่วงเวลา

ต้องใช้ SDK ต่อไปนี้

  • Firebase SDK สำหรับ Google Analytics
  • SDK ของแพลตฟอร์ม Apple v9.0.0 ขึ้นไปหรือ Android SDK v21.1.1 ขึ้นไป (Firebase BoM v30.3.0 ขึ้นไป)
รหัสการติดตั้ง อยู่ใน ระบุรหัสการติดตั้งอย่างน้อย 1 รหัส (สูงสุด 50 รหัส) เพื่อกำหนดเป้าหมาย กฎนี้จะประเมินค่าเป็น true สำหรับการติดตั้งที่กำหนด หาก รหัสการติดตั้งจะอยู่ในรายการค่าที่คั่นด้วยคอมมา

ดูวิธีรับรหัสการติดตั้งได้ที่ เรียกข้อมูลตัวระบุลูกค้า
มีผู้ใช้แล้ว (ไม่มีโอเปอเรเตอร์) กำหนดเป้าหมายผู้ใช้ทั้งหมดของแอปทั้งหมดภายในโปรเจ็กต์ปัจจุบัน

ใช้กฎเงื่อนไขนี้เพื่อจับคู่ผู้ใช้ทั้งหมดภายในโปรเจ็กต์ โดยไม่คำนึงถึง ของแอปหรือแพลตฟอร์ม

การค้นหาพารามิเตอร์และเงื่อนไข

คุณค้นหาคีย์พารามิเตอร์ ค่าพารามิเตอร์ และเงื่อนไขของโปรเจ็กต์ได้ จากคอนโซล Firebase โดยใช้ ช่องค้นหาที่ด้านบนของแท็บพารามิเตอร์ Remote Config

ขีดจำกัดของพารามิเตอร์และเงื่อนไข

คุณมีพารามิเตอร์ได้สูงสุด 2,000 รายการและสูงสุด 500 รายการภายในโปรเจ็กต์ Firebase คีย์พารามิเตอร์มีความยาวได้ไม่เกิน 256 อักขระ และต้องขึ้นต้นด้วยแท็ก ขีดล่างหรือตัวอักษรภาษาอังกฤษ (A-Z, a-z) และอาจมีคำว่า ตัวเลข ความยาวรวมของสตริงค่าพารามิเตอร์ภายในโปรเจ็กต์ไม่สามารถ เกิน 1,000,000 อักขระ

การดูการเปลี่ยนแปลงของพารามิเตอร์และเงื่อนไข

คุณดูการเปลี่ยนแปลงล่าสุดในเทมเพลต Remote Config ได้ จากคอนโซลของ Firebase สำหรับ พารามิเตอร์และเงื่อนไขแต่ละรายการ คุณจะทําสิ่งต่อไปนี้ได้

  • ดูชื่อของผู้ใช้ที่แก้ไขพารามิเตอร์หรือเงื่อนไขครั้งล่าสุด

  • ถ้าการเปลี่ยนแปลงเกิดขึ้นในวันเดียวกัน ให้ดูจำนวนนาที หรือ ชั่วโมงที่ผ่านไปนับจากที่มีการเผยแพร่การเปลี่ยนแปลงไปยัง เทมเพลต Remote Config

  • หากการเปลี่ยนแปลงเกิดขึ้นในอดีตอย่างน้อย 1 วัน ให้ดูวันที่ที่ เผยแพร่การเปลี่ยนแปลงไปยังเทมเพลต Remote Config ที่ใช้งานอยู่แล้ว

การอัปเดตพารามิเตอร์

ใน พารามิเตอร์ Remote Config คอลัมน์ เผยแพร่ล่าสุด จะแสดงผู้ใช้ล่าสุดที่แก้ไข และวันที่เผยแพร่ล่าสุดสำหรับการเปลี่ยนแปลง

  • หากต้องการดูข้อมูลเมตาการเปลี่ยนแปลงสำหรับพารามิเตอร์ที่จัดกลุ่ม ให้ขยายกลุ่มพารามิเตอร์

  • หากต้องการจัดเรียงตามลำดับจากน้อยไปมากหรือมากไปน้อยตามวันที่เผยแพร่ ให้คลิก ป้ายกำกับคอลัมน์เผยแพร่ล่าสุด

การอัปเดตสภาพสินค้า

ใน Remote Config คุณสามารถดำเนินการต่อไปนี้ในหน้าเงื่อนไข ดูผู้ใช้ล่าสุดที่แก้ไขเงื่อนไขและวันที่ที่แก้ไข ถัดจากแก้ไขล่าสุดใต้เงื่อนไขแต่ละรายการ

ขั้นตอนถัดไป

ในการเริ่มกำหนดค่าโปรเจ็กต์ Firebase โปรดดู ตั้งค่าโปรเจ็กต์ Firebase Remote Config