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


คุณกําหนดค่าเทมเพลตสําหรับกรณีการใช้งานทั้งฝั่งไคลเอ็นต์และเซิร์ฟเวอร์ได้ ระบบจะแสดงเทมเพลตไคลเอ็นต์ต่ออินสแตนซ์แอปที่ใช้ Firebase Client SDK สําหรับ Remote Config ซึ่งรวมถึงแอป Android, Apple, เว็บ, Unity, Flutter และ C++ ระบบจะแสดงพารามิเตอร์และค่า Remote Config จากเทมเพลตเฉพาะเซิร์ฟเวอร์ต่อการติดตั้งใช้งาน Remote Config (รวมถึง Cloud Run และ Cloud Functions) ที่ใช้สภาพแวดล้อมเซิร์ฟเวอร์ต่อไปนี้

  • Firebase Admin Node.js SDK v12.1.0 ขึ้นไป
  • Firebase Admin Python SDK v6.7.0 ขึ้นไป

เมื่อใช้Firebaseคอนโซลหรือ Remote ConfigAPI แบ็กเอนด์ คุณจะต้องกําหนดพารามิเตอร์อย่างน้อย 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

เช่น คุณอาจสร้างพารามิเตอร์ที่กําหนดชื่อและสตริงเวอร์ชันของโมเดลภาษาขนาดใหญ่ (LLM) และแสดงคําตอบจากโมเดลต่างๆ ตามกฎสัญญาณที่กําหนดเอง ใน Use Case นี้ คุณอาจใช้เวอร์ชันโมเดลที่เสถียรเป็นค่าเริ่มต้นเพื่อให้บริการคำขอส่วนใหญ่ และใช้สัญญาณที่กำหนดเองเพื่อใช้โมเดลเวอร์ชันทดลองเพื่อตอบสนองคำขอทดสอบไคลเอ็นต์

พารามิเตอร์อาจมีค่าแบบมีเงื่อนไขหลายค่าที่ใช้เงื่อนไขที่แตกต่างกัน และพารามิเตอร์สามารถแชร์เงื่อนไขภายในโปรเจ็กต์ได้ ในแท็บพารามิเตอร์ของคอนโซล 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 คุณสามารถเลือกประเภทข้อมูลได้จากเมนูแบบเลื่อนลงข้างคีย์พารามิเตอร์ ใน REST API คุณสามารถตั้งค่าประเภทได้โดยใช้ช่อง value_type ภายในออบเจ็กต์พารามิเตอร์

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

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

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

คุณสามารถสร้างกลุ่มพารามิเตอร์ได้โดยใช้Firebaseคอนโซลหรือ Remote ConfigREST 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 ของแอป คุณจะเห็น applicationId ในไฟล์ build.gradle(.kts) ระดับแอป
เวอร์ชันของแอป สำหรับค่าสตริง:
ตรงกันทั้งหมด,
มี,
ไม่มี,
มีนิพจน์ทั่วไป

สำหรับค่าตัวเลข:
<, <=, =, !=, >, >=

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

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

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

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

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

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

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

สำหรับค่าตัวเลข:
=, ≠, >, ≥, <, ≤

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

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

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

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

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

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

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

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

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

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

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

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

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

พร็อพเพอร์ตี้ผู้ใช้ สำหรับค่าสตริง:
contains,
does not contain,
exactly matches,
contains regex

สำหรับค่าตัวเลข:
=, ≠, >, ≥, <, ≤

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

สัญญาณที่กำหนดเอง สำหรับค่าสตริง:
contains,
does not contain,
exactly matches,
contains regex

สำหรับค่าตัวเลข:
=, ≠, >, ≥, <, ≤

สำหรับค่าเวอร์ชัน:
=, ≠, >, ≥, <, ≤

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

ประเภทข้อมูลที่รองรับสําหรับสภาพแวดล้อมไคลเอ็นต์มีดังนี้
  • iOS: int, double
  • Android: int, long, double
  • เว็บ: ตัวเลข

ตัวเลขที่แสดงถึงหมายเลขเวอร์ชันที่จะจับคู่ (เช่น 2.1.0)

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

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

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

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

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

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

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

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

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

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

ประวัติการเปลี่ยนแปลงของพารามิเตอร์

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

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

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

ประวัติการเปลี่ยนแปลงของเงื่อนไข

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

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

หากต้องการกําหนดค่าโปรเจ็กต์และแอป Firebase ให้ใช้ Remote Config โปรดดูหัวข้อเริ่มต้นใช้งาน Firebase Remote Config