เทมเพลตการกำหนดค่าระยะไกลและการกำหนดเวอร์ชัน


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

ส่วนนี้จะกล่าวถึงเทมเพลตเซิร์ฟเวอร์ หากต้องการดูข้อมูลเกี่ยวกับเทมเพลตเฉพาะลูกค้า ให้คลิกเทมเพลตลูกค้า

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

ต่อไปนี้คือตัวอย่างของไฟล์เทมเพลตเซิร์ฟเวอร์

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

คุณสามารถทำสิ่งต่อไปนี้ได้โดยใช้คอนโซล Firebase

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

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

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

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

จัดการเวอร์ชันเทมเพลตของ Remote Config

ส่วนนี้จะอธิบายวิธีจัดการเวอร์ชันของRemote Config เทมเพลต

แสดงรายการเทมเพลต Remote Config เวอร์ชันที่เก็บไว้ทั้งหมด

คุณสามารถเรียกข้อมูลรายการเทมเพลต Remote Config เวอร์ชันที่เก็บไว้ทั้งหมดได้ โดยทำดังนี้

  1. เปิด Remote Config จากคอนโซล Firebase

  2. จากนั้นจากแท็บพารามิเตอร์ ให้เลือกไอคอน "นาฬิกา" ที่แสดงที่ด้านขวาบน

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

    รายการเทมเพลตประกอบด้วยข้อมูลเมตาสำหรับเวอร์ชันที่จัดเก็บไว้ทั้งหมด ซึ่งรวมถึง เวลาที่อัปเดต ผู้ใช้ที่สร้าง และวิธีทำการอัปเดต

ดึงข้อมูลเทมเพลต Remote Config เวอร์ชันที่ต้องการ

คุณสามารถเรียกข้อมูลเทมเพลต Remote Config เวอร์ชันที่เก็บไว้ได้ วิธีเรียกข้อมูลเทมเพลตที่เก็บไว้ เวอร์ชัน:

  1. เปิดแผงรายละเอียดของ ประวัติการเปลี่ยนแปลง

  2. หากต้องการดูรายละเอียดของเวอร์ชันอื่นในรายการ ให้เลือกจากด้านขวา เมนู

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

เปลี่ยนกลับไปใช้เทมเพลต Remote Config เวอร์ชันที่เก็บไว้

คุณสามารถย้อนกลับไปยัง ของเทมเพลต วิธีย้อนกลับเทมเพลต

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

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

ลบเทมเพลต Remote Config

คุณลบเทมเพลต Remote Config ออกจากคอนโซล Firebase ได้ ถึง ลบเทมเพลต Remote Config:

1. จาก Remote Config พารามิเตอร์ ให้คลิก ประวัติการเปลี่ยนแปลง

  1. สลับไปยังเทมเพลตที่ต้องการลบ แล้วคลิก เพิ่มเติม แล้วเลือก Delete

  2. เมื่อมีข้อความแจ้งให้ยืนยันการลบ ให้คลิกลบ

ดาวน์โหลดและเผยแพร่เทมเพลต Remote Config

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

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

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

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

พารามิเตอร์และค่าพารามิเตอร์ที่สร้างขึ้นเป็นตัวแปรโดยเฉพาะใน การทดสอบ A/B Testing รายการไม่รวมอยู่ในเทมเพลตที่ส่งออก

วิธีส่งออกและนำเข้าเทมเพลต Remote Config รายการ

  1. ดาวน์โหลดเทมเพลตการกำหนดค่าปัจจุบันของ Remote Config
  2. ตรวจสอบเทมเพลต Remote Config
  3. เผยแพร่เทมเพลต Remote Config

ดาวน์โหลดเทมเพลตการกำหนดค่าระยะไกลปัจจุบัน

ใช้รายการต่อไปนี้เพื่อดาวน์โหลดเทมเพลต Remote Config ที่ใช้งานอยู่ใน รูปแบบ JSON:

  1. จากแท็บRemote Config พารามิเตอร์หรือเงื่อนไข ให้เปิดเมนู แล้วเลือกดาวน์โหลดไฟล์การกําหนดค่าปัจจุบัน
  2. เมื่อมีข้อความแจ้ง ให้คลิกดาวน์โหลดไฟล์การกําหนดค่า แล้วเลือกตําแหน่งที่ ที่คุณต้องการบันทึกไฟล์ แล้วคลิกบันทึก

ตรวจสอบความถูกต้องของเทมเพลตการกำหนดค่าระยะไกล

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

เผยแพร่เทมเพลต Remote Config

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

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

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

ใช้คำสั่งต่อไปนี้เพื่อเผยแพร่เทมเพลตของคุณ

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

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