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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ในแอป ระบบจะแสดงผลค่าพารามิเตอร์ด้วยเมธอด get ตาม รายการสำคัญต่อไปนี้

  1. หากมีการเรียกค่าจากแบ็กเอนด์แล้วเปิดใช้งาน แอปจะใช้เมธอด ค่าที่ดึงมา ค่าพารามิเตอร์ที่เปิดใช้งานจะเป็นแบบถาวร

  2. หากไม่มีการเรียกค่าจากแบ็กเอนด์ หรือหากค่าดึงข้อมูลจาก ยังไม่ได้เปิดใช้งานแบ็กเอนด์การกำหนดค่าระยะไกล แอปจะใช้ในแอป ค่าเริ่มต้น

    ดูข้อมูลเพิ่มเติมเกี่ยวกับการรับค่าและการตั้งค่าเริ่มต้นได้ที่ ดาวน์โหลดค่าเริ่มต้นของเทมเพลตการกำหนดค่าระยะไกล

  3. หากไม่ได้กำหนดค่าเริ่มต้นในแอปไว้ แอปจะใช้ประเภทคงที่ (เช่น 0 สำหรับ int และ false สำหรับ boolean)

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

แผนภาพที่แสดงขั้นตอนการดำเนินการตามรายการตามลำดับข้างต้น

ประเภทข้อมูลค่าพารามิเตอร์

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

ประเภทที่รองรับในปัจจุบันมีดังนี้

  • String
  • Boolean
  • Number
  • JSON

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

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

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

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

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

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

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

ใช้แอตทริบิวต์นี้ดังนี้
  • สำหรับแพลตฟอร์ม 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 จํานวนมากถูกกำหนดโดยเหตุการณ์หรือ พร็อพเพอร์ตี้ผู้ใช้ ซึ่งอาจพิจารณาจากการดำเนินการของผู้ใช้แอป รอให้กฎผู้ใช้ในกลุ่มเป้าหมายมีผลสำหรับแอปหนึ่งๆ อินสแตนซ์

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ในการเริ่มกำหนดค่าโปรเจ็กต์ Firebase โปรดดู สร้างโปรเจ็กต์การกำหนดค่าระยะไกลของ Firebase