พารามิเตอร์และการกำหนดค่าระยะไกลในเทมเพลตไคลเอ็นต์

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

เมื่อใช้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 สำหรับอินสแตนซ์แอปที่กำหนด หากค่าของกฎเป็น undefined (เช่น เมื่อไม่มีค่า) กฎนั้นจะประเมินเป็น false

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

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

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

เพิ่ม แก้ไข เรียงลำดับใหม่ หรือลบเงื่อนไขโดยใช้Firebaseคอนโซล

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

1. ในFirebaseคอนโซล ให้ไปที่ DevOps และความผูกพัน > การกำหนดค่าระยะไกล > หน้าเงื่อนไข (หรือเลือกจัดการเงื่อนไขจากหน้าพารามิเตอร์)
2. เพิ่มเงื่อนไข: คลิกเพิ่มเงื่อนไข (หรือสร้างเงื่อนไขแรก) ป้อนชื่อที่กำหนดวัตถุประสงค์การกำหนดเป้าหมาย แล้วเลือกกฎการกำหนดเป้าหมายอย่างน้อย 1 รายการ
3. แก้ไขเงื่อนไข: คลิกชื่อเงื่อนไขหรือไอคอนแก้ไข แก้ไขกฎตามที่ต้องการ แล้วคลิกบันทึก
4. เปลี่ยนลำดับความสำคัญของเงื่อนไข: ในหน้าเงื่อนไข ให้ลาก เงื่อนไขโดยใช้แฮนเดิลการจับเพื่อจัดลำดับใหม่ เงื่อนไขที่อยู่สูงกว่าในรายการ จะมีความสำคัญเหนือกว่าเงื่อนไขที่อยู่ต่ำกว่าในรายการ
5. ลบเงื่อนไข: คลิกไอคอนลบข้างเงื่อนไขที่ต้องการนำออก หากพารามิเตอร์ใดอ้างอิงเงื่อนไข การนำเงื่อนไขออกจะนำค่าแบบมีเงื่อนไขที่เชื่อมโยงออกด้วย

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

ข้อจำกัดของ IPv6 ที่มีการควบคุมการเข้าถึงตาม IP

Remote Config มีการรองรับ IPv6 แบบจำกัดเมื่อใช้กับนโยบายการเข้าถึงตาม IP หากองค์กรจำกัดการเข้าถึงช่วง IP สาธารณะที่เฉพาะเจาะจง การเชื่อมต่อผ่านเครือข่าย IPv6 อาจทำให้เกิดปัญหาต่อไปนี้

• การเข้าถึงคอนโซล: คุณอาจใช้Remote Config ฟีเจอร์บางอย่างในคอนโซล Firebase ไม่ได้ เช่น การโหลดข้อมูลหรือการตั้งค่า การกำหนดเป้าหมาย
• การเข้าถึงของไคลเอ็นต์: แอปไคลเอ็นต์อาจพบข้อผิดพลาด PERMISSION_DENIED

หากต้องการป้องกันปัญหาเหล่านี้ ให้กำหนดค่าเครือข่ายให้ใช้ IPv4 หรือ เพิ่มช่วง IP ของ Firebase ที่จำเป็นลงในรายการที่อนุญาตขององค์กร

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

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

1. ก่อนอื่น ระบบจะใช้ค่าแบบมีเงื่อนไขสำหรับเงื่อนไขใดๆ ที่ประเมินเป็น true สำหรับคำขอของไคลเอ็นต์ที่ระบุ หากเงื่อนไขหลายรายการประเมินเป็น true เงื่อนไขบนสุดที่แสดงใน Firebase คอนโซล UI จะมีความสำคัญเหนือกว่า และระบบจะระบุค่าแบบมีเงื่อนไข ที่เชื่อมโยงกับเงื่อนไขนั้นเมื่อแอปดึงค่าจากแบ็กเอนด์ คุณเปลี่ยนลำดับความสำคัญของเงื่อนไขได้โดยการลาก และวางเงื่อนไขในหน้าเงื่อนไข

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 Config REST API กลุ่มพารามิเตอร์แต่ละกลุ่มที่คุณสร้างจะมีชื่อที่ไม่ซ้ำกันในเทมเพลต Remote Config เมื่อสร้างกลุ่มพารามิเตอร์ โปรดคำนึงถึงสิ่งต่อไปนี้

• พารามิเตอร์จะรวมอยู่ในกลุ่มได้เพียงกลุ่มเดียวในแต่ละครั้ง และคีย์พารามิเตอร์ ยังคงต้องไม่ซ้ำกันในพารามิเตอร์ทั้งหมด
• ชื่อกลุ่มพารามิเตอร์มีความยาวได้ไม่เกิน 256 อักขระ
• หากคุณใช้ทั้ง 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 มีคีย์กลุ่มพร้อมคำอธิบายที่ซ้อนกันและ รายการพารามิเตอร์ที่จัดกลุ่ม โปรดทราบว่าคีย์กลุ่มแต่ละรายการต้องไม่ซ้ำกันทั่วโลก

ตัวอย่างเช่น ต่อไปนี้เป็นข้อความที่ตัดตอนมาจากการแก้ไขเทมเพลตซึ่งเพิ่มพารามิเตอร์ กลุ่ม "เมนูใหม่" ที่มีพารามิเตอร์ 1 รายการ 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: v11.8.0 ขึ้นไป
• Android: v22.1.0 ขึ้นไป (Firebase BoM v33.8.0 ขึ้นไป)
• เว็บ: v11.2.0 ขึ้นไป
• Flutter: Flutter BoM เวอร์ชัน 3.6.0 ขึ้นไป

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

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

จำกัดสูงสุด

เมื่อสร้างเงื่อนไขสัญญาณที่กำหนดเอง คุณต้องปฏิบัติตามขีดจำกัดต่อไปนี้

• จำนวนสัญญาณที่กำหนดเอง: คุณสร้างสัญญาณที่กำหนดเองได้สูงสุด 100 รายการต่ออินสแตนซ์ของแอป คุณยกเลิกการตั้งค่าสัญญาณที่กำหนดเองได้โดยตั้งค่าเป็น Null
• ชื่อสัญญาณที่กำหนดเอง: ชื่อสัญญาณที่กำหนดเองแต่ละชื่อมีความยาวได้สูงสุด 250 อักขระ
• ค่าสัญญาณที่กำหนดเอง: ค่าสัญญาณที่กำหนดเองแต่ละค่ามีอักขระได้สูงสุด 500 ตัว เมื่อใช้นิพจน์ทั่วไป ระบบจะจำกัดจำนวนอักขระไว้ที่ 250 ตัว

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

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

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

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

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

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

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

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

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

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

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

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

ในคอนโซล Firebase ให้ไปที่หน้า DevOps และความผูกพัน > การกำหนดค่าระยะไกล > พารามิเตอร์ คอลัมน์เผยแพร่ล่าสุดแสดงผู้ใช้รายล่าสุดที่แก้ไขพารามิเตอร์แต่ละรายการ และวันที่เผยแพร่การเปลี่ยนแปลงล่าสุด

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

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

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

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

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

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