रिमोट कॉन्फ़िगरेशन कंडिशनल एक्सप्रेशन का रेफ़रंस

इस पेज पर, Remote Config बैकएंड एपीआई या Firebase कंसोल का इस्तेमाल करके, शर्त वाले एक्सप्रेशन बनाने के बारे में रेफ़रंस जानकारी दी गई है. बैकएंड एपीआई को सेट अप और इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, प्रोग्राम के हिसाब से रिमोट कॉन्फ़िगरेशन में बदलाव करना लेख पढ़ें.

शर्तें बनाने के लिए इस्तेमाल किए जाने वाले एलिमेंट

Remote Config REST API में वे सभी एलिमेंट काम करते हैं जिनका इस्तेमाल, Firebase कंसोल की मदद से Remote Config को कॉन्फ़िगर करते समय शर्तें बनाने के लिए किया जा सकता है:

तत्व ब्यौरा
&&

अगर किसी शर्त के लिए एक से ज़्यादा एलिमेंट का इस्तेमाल किया जा रहा है, तो एलिमेंट का लॉजिकल "and" बनाने के लिए इस्तेमाल किया जाता है. अगर किसी एलिमेंट का इस्तेमाल, REST सिंटैक्स में && के बिना किया जाता है, तो उस एलिमेंट को एक शर्त के तौर पर माना जाता है.

ध्यान दें: ऐंपरसैंड से पहले और बाद में स्पेस होना ज़रूरी है. उदाहरण के लिए: element1 && element2.

app.build

ऐप्लिकेशन के बिल्ड नंबर की वैल्यू के आधार पर, TRUE या FALSE का आकलन करता है.

ध्यान दें: यह सुविधा सिर्फ़ Apple और Android डिवाइसों पर उपलब्ध है. Apple के लिए, CFBundleVersion की वैल्यू का इस्तेमाल करें. वहीं, Android के लिए, versionCode की वैल्यू का इस्तेमाल करें.

app.version

ऐप्लिकेशन के वर्शन नंबर की वैल्यू के आधार पर, TRUE या FALSE का आकलन करता है.

ध्यान दें: Android डिवाइसों के लिए, versionName की वैल्यू का इस्तेमाल करें. Apple डिवाइसों के लिए, CFBundleShortVersionString की वैल्यू का इस्तेमाल करें.

app.id ऐप्लिकेशन के Firebase ऐप्लिकेशन आईडी पर आधारित एलिमेंट
app.audiences एक ऐसा एलिमेंट जो एक या उससे ज़्यादा Firebase Analytics ऑडियंस में उपयोगकर्ता की मौजूदगी या गैर-मौजूदगी के आधार पर, TRUE या FALSE का आकलन करता है.
app.firstOpenTimestamp यह एलिमेंट, उपयोगकर्ता के पहली बार ऐप्लिकेशन लॉन्च करने पर आधारित होता है. इसे Google Analytics first_open इवेंट से हासिल किया जाता है. यह ISO तारीख के फ़ॉर्मैट का इस्तेमाल करता है. इसमें, तय किए गए टाइम ज़ोन को बताने का विकल्प होता है. उदाहरण के लिए, app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles'). अगर कोई टाइम ज़ोन नहीं बताया गया है, तो जीएमटी का इस्तेमाल किया जाता है.
app.userProperty यह एक ऐसा एलिमेंट है जो Google Analyticsउपयोगकर्ता प्रॉपर्टी की संख्या या स्ट्रिंग वैल्यू के आधार पर, TRUE या FALSE का आकलन करता है.
app.operatingSystemAndVersion

यह एलिमेंट, उस ऑपरेटिंग सिस्टम पर आधारित होता है जिस पर कोई ऐप्लिकेशन चल रहा है. जब ओएस और ओएस वर्शन, तय किए गए टारगेट से मैच करता है, तो TRUE के तौर पर आकलन किया जाता है.

ध्यान दें: यह सुविधा सिर्फ़ वेब ऐप्लिकेशन के लिए उपलब्ध है.

app.browserAndVersion

यह एलिमेंट, उस ब्राउज़र पर आधारित होता है जिस पर कोई ऐप्लिकेशन चल रहा है. जब ब्राउज़र और ब्राउज़र का वर्शन, तय किए गए टारगेट से मैच करता है, तो TRUE के तौर पर आकलन किया जाता है.

ध्यान दें: यह सुविधा सिर्फ़ वेब ऐप्लिकेशन के लिए उपलब्ध है.

app.firebaseInstallationId यह एलिमेंट, खास डिवाइस इंस्टॉलेशन के आईडी पर आधारित होता है. इंस्टॉलेशन आईडी, दिए गए इंस्टॉलेशन आईडी में से किसी एक से मैच होने पर, TRUE वैल्यू दिखाता है.
app.customSignal ऐसा एलिमेंट जो कस्टम सिग्नल की शर्तों की न्यूमेरिक, सिमैंटिक या स्ट्रिंग वैल्यू के आधार पर, TRUE या FALSE का आकलन करता है.
device.country यह एलिमेंट, उस देश/इलाके पर आधारित होता है जहां डिवाइस मौजूद है. इसके लिए, आईएसओ 3166-1 ऐल्फ़ा-2 स्टैंडर्ड का इस्तेमाल किया जाता है. उदाहरण के लिए, US या UK. जब कोई देश, देश के कोड से मैच करता है, तो यह TRUE दिखाता है.
device.dateTime यह एलिमेंट, डिवाइस से पिछली बार फ़ेच किए गए डेटा के समय पर आधारित होता है. यह आईएसओ तारीख फ़ॉर्मैट का इस्तेमाल करता है. इसमें, टाइम ज़ोन तय करने का विकल्प होता है. उदाहरण के लिए, dateTime('2017-03-22T13:39:44', 'America/Los_Angeles').
device.language यह एलिमेंट, डिवाइस पर चुनी गई भाषा के हिसाब से तय होता है. भाषा को आईईटीएफ़ भाषा टैग का इस्तेमाल करके दिखाया जाता है. जैसे, es-ES, pt-BR या en-US. जब कोई भाषा, उम्मीद के मुताबिक भाषा कोड से मैच करती है, तो TRUE के तौर पर नतीजा दिखाता है.
device.os किसी डिवाइस पर इस्तेमाल किए जाने वाले ऑपरेटिंग सिस्टम (Apple या Android) के आधार पर तय किया गया एलिमेंट. डिवाइस का ओएस, अनुमानित टाइप होने पर, TRUE के तौर पर आकलन किया जाता है.
percent उपयोगकर्ता को रैंडम तरीके से असाइन किए गए फ़्रैक्शनल पर्सेंटेज में शामिल करने के आधार पर, TRUE का आकलन करता है. इसमें सैंपल का साइज़ 0.000001% जितना छोटा हो सकता है.

सिंगल-एलिमेंट कंडिशन में तीन फ़ील्ड होते हैं:

  1. मनमुताबिक तय किया गया name (ज़्यादा से ज़्यादा 100 वर्ण)
  2. एक शर्त वाला एक्सप्रेशन, जो TRUE या FALSE का आकलन करता है. यह पिछली टेबल में दिखाए गए एलिमेंट से बना होता है.
  3. (ज़रूरी नहीं) tagColor, जो "BLUE", "BROWN", "CYAN", "DEEP_ORANGE", "GREEN", "INDIGO", "LIME", "ORANGE", "PINK", "PURPLE" या "TEAL" हो सकता है. रंग केस-इनसेंसिटिव होता है और यह सिर्फ़ इस बात पर असर डालता है कि Firebase कंसोल में शर्तें कैसे दिखती हैं.

ये ऑपरेटर इस्तेमाल किए जा सकते हैं

तत्व ये ऑपरेटर इस्तेमाल किए जा सकते हैं ब्यौरा
app.audiences .inAtLeastOne([...])

अगर असल ऑडियंस, सूची में मौजूद कम से कम एक ऑडियंस के नाम से मैच करती है, तो TRUE दिखाता है.
उदाहरण के लिए:

app.audiences.inAtLeastOne(['Audience 1', 'Audience 2'])
app.audiences .notInAtLeastOne([...])

अगर असल ऑडियंस, सूची में मौजूद कम से कम एक ऑडियंस के नाम से मैच नहीं करती है, तो TRUE दिखाता है.

app.audiences .inAll([...])

अगर असल ऑडियंस, सूची में मौजूद हर ऑडियंस नाम की सदस्य है, तो TRUE दिखाता है.

app.audiences .notInAll([...])

अगर असल ऑडियंस, सूची में मौजूद किसी भी ऑडियंस की सदस्य नहीं है, तो TRUE दिखाता है.

app.firstOpenTimestamp <=, >

यह फ़ंक्शन, first_open इवेंट के समय की तुलना, शर्त में बताए गए समय से करता है. साथ ही, ऑपरेटर के आधार पर TRUE या FALSE दिखाता है.
इस्तेमाल का उदाहरण:
app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles').
रेंज तय करने के लिए:
app.firstOpenTimestamp >= ('2022-11-01T00:00:00') && app.firstOpenTimestamp < ('2022-12-01T00:00:00') अगर कोई टाइम ज़ोन तय नहीं किया गया है, तो जीएमटी का इस्तेमाल किया जाता है.

app.userProperty <, <=, ==, !=, >=, >

अगर उपयोगकर्ता प्रॉपर्टी की असल वैल्यू, ऑपरेटर से मैच होने वाली वैल्यू से संख्या के हिसाब से मेल खाती है, तो TRUE दिखाता है.

app.userProperty .contains([...])

अगर कोई टारगेट वैल्यू, उपयोगकर्ता की असल प्रॉपर्टी की सबस्ट्रिंग है, तो TRUE दिखाता है.

app.userProperty .notContains([...])

अगर टारगेट की गई कोई भी वैल्यू, असल उपयोगकर्ता प्रॉपर्टी की सबस्ट्रिंग नहीं है, तो TRUE दिखाता है.

app.userProperty .exactlyMatches([...])

अगर उपयोगकर्ता की असल प्रॉपर्टी, सूची में मौजूद टारगेट वैल्यू में से किसी से पूरी तरह मैच करती है, तो TRUE दिखाता है. यह मैच केस-सेंसिटिव होता है.

app.userProperty .matches([...])

अगर सूची में मौजूद कोई भी टारगेट रेगुलर एक्सप्रेशन, असल वैल्यू की सबस्ट्रिंग या पूरी वैल्यू से मैच करता है, तो TRUE दिखाता है. पूरी स्ट्रिंग का मिलान करने के लिए, रेगुलर एक्सप्रेशन के पहले "^" और बाद में "$" लगाएं. इसमें RE2 सिंटैक्स का इस्तेमाल किया जाता है.

app.id ==

अगर दी गई वैल्यू, ऐप्लिकेशन के ऐप्लिकेशन आईडी से मैच करती है, तो TRUE दिखाता है.

app.build <, <=, ==, !=, >=, >

अगर ऐप्लिकेशन का असल बिल्ड, ऑपरेटर से मैच करने वाले तरीके से बताई गई वैल्यू से संख्या के हिसाब से मेल खाता है, तो TRUE दिखाता है.

app.build .contains([...])

अगर टारगेट की गई कोई भी वैल्यू, ऐप्लिकेशन के असल बिल्ड की सबस्ट्रिंग है, तो TRUE दिखाता है. उदाहरण के लिए, "a" और "bc", "abc" की सबस्ट्रिंग हैं.

app.build .notContains([...])

अगर कोई भी टारगेट वैल्यू, असल ऐप्लिकेशन बिल्ड की सबस्ट्रिंग नहीं है, तो TRUE दिखाता है. उदाहरण के लिए, अगर ऐप्लिकेशन का असल बिल्ड 123 या 492 है, तो app.build.notContains([123, 456]) से TRUE मिलता है. हालांकि, अगर ऐप्लिकेशन का असल बिल्ड 999 है, तो FALSE मिलता है.

app.build .exactlyMatches([...])

अगर असल ऐप्लिकेशन बिल्ड, सूची में मौजूद टारगेट वैल्यू में से किसी भी वैल्यू से पूरी तरह मैच करता है, तो TRUE दिखाता है.

app.build .matches([...])

अगर सूची में मौजूद कोई भी टारगेट रेगुलर एक्सप्रेशन, असल वैल्यू की किसी सबस्ट्रिंग या पूरी वैल्यू से मैच करता है, तो TRUE दिखाता है. पूरी स्ट्रिंग को मैच करने के लिए, रेगुलर एक्सप्रेशन के शुरू में "^" और आखिर में "$" लगाएं. इसमें RE2 सिंटैक्स का इस्तेमाल किया जाता है.

app.version <, <=, ==, !=, >=, >

अगर ऐप्लिकेशन का असल वर्शन, ऑपरेटर से मैच करने वाले तरीके से बताई गई वैल्यू से संख्या के हिसाब से मेल खाता है, तो TRUE दिखाता है.

ध्यान दें: संख्याओं की तुलना करने वाले ऑपरेटर, सिर्फ़ संख्याओं वाले सिमैंटिक वर्शन (जैसे, 1.2.3) के साथ काम करते हैं. ये रिलीज़ से पहले वाले सफ़िक्स या हाइफ़न (जैसे, -beta या -rc) के साथ काम नहीं करते. अगर वर्शन स्ट्रिंग में बिना संख्याओं वाले सफ़िक्स या हाइफ़न शामिल हैं, तो स्ट्रिंग ऑपरेटर (जैसे, .matches या .contains) का इस्तेमाल करें.

app.version .contains([...])

अगर कोई टारगेट वैल्यू, ऐप्लिकेशन के असल वर्शन की सबस्ट्रिंग है, तो TRUE दिखाता है. उदाहरण के लिए, "a" और "bc", "abc" की सबस्ट्रिंग हैं.

app.version .notContains([...])

अगर कोई भी टारगेट वैल्यू, ऐप्लिकेशन के असल वर्शन की सबस्ट्रिंग नहीं है, तो TRUE दिखाता है. उदाहरण के लिए, अगर ऐप्लिकेशन का असल वर्शन 123 या 492 है, तो app.version.notContains([123, 456]) से TRUE मिलता है. हालांकि, अगर ऐप्लिकेशन का असल वर्शन 999 है, तो FALSE मिलता है.

app.version .exactlyMatches([...])

अगर ऐप्लिकेशन का असल वर्शन, सूची में मौजूद टारगेट वैल्यू में से किसी से पूरी तरह मैच होता है, तो TRUE दिखाता है.

app.version .matches([...])

अगर सूची में मौजूद कोई भी टारगेट रेगुलर एक्सप्रेशन, असल वैल्यू की किसी सबस्ट्रिंग या पूरी वैल्यू से मैच करता है, तो TRUE दिखाता है. पूरी स्ट्रिंग को मैच करने के लिए, रेगुलर एक्सप्रेशन के शुरू में "^" और आखिर में "$" लगाएं. इसमें RE2 सिंटैक्स का इस्तेमाल किया जाता है.

app.operatingSystemAndVersion .inOne([...])

अगर ओएस और वर्शन, सूची में मौजूद टारगेट वैल्यू में से किसी से मैच करता है, तो TRUE दिखाता है.
उदाहरण के लिए:

app.operatingSystemAndVersion.inOne([operatingSystemName('Macintosh')
    .version.==('10.15')])
app.browserAndVersion .inOne([...])

अगर ब्राउज़र और उसका वर्शन, सूची में मौजूद टारगेट वैल्यू में से किसी से भी मैच करता है, तो यह TRUE दिखाता है.
उदाहरण के लिए:

app.browserAndVersion.inOne([browserName('Chrome').anyVersion])
app.firebaseInstallationId in [...]

अगर इंस्टॉलेशन आईडी, सूची में दिए गए किसी भी आईडी से मेल खाता है, तो TRUE दिखाता है. इस्तेमाल का उदाहरण: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']

app.customSignal <, <=, ==, !=, >=, >

अगर कस्टम सिग्नल की शर्त, ऑपरेटर से मैच करने वाले तरीके से दी गई वैल्यू से संख्या के हिसाब से तुलना करती है, तो TRUE दिखाता है.

app.customSignal .contains([...])

अगर कोई भी टारगेट वैल्यू, कस्टम सिग्नल की असल शर्त की सबस्ट्रिंग है, तो TRUE दिखाता है.

app.customSignal .notContains([...])

अगर कोई भी टारगेट वैल्यू, कस्टम सिग्नल की असल शर्त की सबस्ट्रिंग है, तो TRUE दिखाता है.

app.customSignal .exactlyMatches([...])

अगर कस्टम सिग्नल की असल शर्त, सूची में मौजूद किसी भी टारगेट वैल्यू से पूरी तरह मैच (केस-सेंसिटिव) होती है, तो TRUE दिखाता है.

app.customSignal .matches([...])

अगर सूची में मौजूद कोई भी टारगेट रेगुलर एक्सप्रेशन, कस्टम सिग्नल की असल शर्त की सबस्ट्रिंग या पूरी शर्त से मैच करता है, तो यह TRUE दिखाता है. पूरी स्ट्रिंग को मैच करने के लिए, रेगुलर एक्सप्रेशन के शुरू में "^" और आखिर में "$" लगाएं. यह RE2 सिंटैक्स का इस्तेमाल करता है.

version(app.customSignal) <, <=, ==, !=, >=, >

अगर कस्टम सिग्नल की शर्त, ऑपरेटर से मैच करने वाले तरीके से बताई गई वैल्यू से मिलती-जुलती है, तो TRUE दिखाता है.

device.country in [...]

अगर डिवाइस का देश, सूची में दिए गए किसी भी देश से मेल खाता है, तो TRUE दिखाता है. इस्तेमाल का उदाहरण: device.country in ['gb', 'us']. डिवाइस के देश का कोड, अनुरोध में मौजूद डिवाइस के आईपी पते या Firebase Analytics से तय किए गए देश के कोड का इस्तेमाल करके तय किया जाता है. ऐसा तब होता है, जब Analytics का डेटा Firebase के साथ शेयर किया जाता है.

device.dateTime <=, >

यह मौजूदा समय की तुलना, शर्त के टारगेट समय से करता है. साथ ही, ऑपरेटर के आधार पर TRUE या FALSE के तौर पर आकलन करता है. इस्तेमाल का उदाहरण: dateTime < dateTime('2017-03-22T13:39:44').

device.language in [...]

अगर ऐप्लिकेशन की कोई भी भाषा, सूची में मौजूद किसी भाषा से मेल खाती है, तो TRUE दिखाता है. इस्तेमाल का उदाहरण: device.language in ['en-UK', 'en-US'].

device.os ==, != अगर डिवाइस का ऑपरेटिंग सिस्टम, ऑपरेटर से मैच करने वाले फ़ील्ड की वैल्यू से मेल खाता है, तो TRUE दिखाता है.
percent <=, >, between

अगर percent फ़ील्ड में मौजूद वैल्यू, ऑपरेटर से मैच करने के लिए रैंडम तरीके से असाइन की गई वैल्यू से मेल खाती है, तो TRUE दिखाता है.

शर्त के नियम के टाइप में बताए गए तरीके के मुताबिक, प्रतिशत की किसी रेंज के लिए, ऐप्लिकेशन के इंस्टेंस के रैंडम तरीके से असाइन किए गए नए ग्रुप को चुनने के लिए, सीड तय किया जा सकता है.

ऐसा करने के लिए, ऑपरेटर से पहले सीड का नाम दें, जैसा कि इस उदाहरण में दिया गया है:

percent('keyName') <= 10

किसी खास रेंज को कॉन्फ़िगर करने के लिए, between ऑपरेटर का इस्तेमाल किया जा सकता है. डिफ़ॉल्ट सीड का इस्तेमाल करके, 20 से 60 उपयोगकर्ताओं की रेंज कॉन्फ़िगर करने के लिए:

percent between 20 and 60

कस्टम सीड का इस्तेमाल करके, 60 से 80 उपयोगकर्ताओं की रेंज कॉन्फ़िगर करने के लिए:

percent('seedName') between 60 and 80