सेगमेंटेशन भाषा

Pushwoosh टैग मानों के आधार पर विस्तृत सेगमेंट बनाने के लिए एक शक्तिशाली सेगमेंटेशन इंजन प्रदान करता है। सेगमेंटेशन भाषा सेगमेंटेशन मानदंडों को लिखने और संयोजित करने का एक विशिष्ट तरीका है ताकि उन मानदंडों से मेल खाने वाले उपयोगकर्ताओं के एक विशेष समूह का वर्णन किया जा सके और उन्हें एक एकल दर्शक सेगमेंट के रूप में माना जा सके।

यह लेख सेगमेंटेशन भाषा की मूल अवधारणाओं और सिंटैक्स का वर्णन करता है और विभिन्न मामलों के लिए सेगमेंटेशन मानदंड बनाने के व्यापक उदाहरण प्रदान करता है।

सहेजे गए सेगमेंट के बिना इनलाइन उपयोग

एक फ़िल्टर एक्सप्रेशन को सहेजे गए सेगमेंट से संबंधित होना आवश्यक नहीं है। इसे सीधे NotifySegment के expression फ़ील्ड में पास करें ताकि एक ही भेज को लक्षित किया जा सके — कोई सेगमेंट नहीं बनाया जाता है, और एक्सप्रेशन खाते पर संग्रहीत नहीं होता है।

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "expression": "AT(\"XXXXX-XXXXX\", \"City\", eq, \"Tokyo\") * AT(\"XXXXX-XXXXX\", \"Age\", gte, 18)",
      "payload": {
        "content": {
          "localized_content": {
            "en": { "ios": { "body": "Hello, Tokyo!" } }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" }
    }
  }'

नोट

इनलाइन एक्सप्रेशन भेजने के समय मूल्यांकित किए जाते हैं और प्रीकंपाइलेशन को छोड़ देते हैं — वे हाई-स्पीड डिलीवरी के साथ काम नहीं करते हैं, जिसके लिए code द्वारा संदर्भित एक सहेजे गए सेगमेंट की आवश्यकता होती है।

मूल बातें

आपके उपयोगकर्ता आधार में प्रत्येक डिवाइस के साथ टैग मानों के माध्यम से विशिष्ट विशेषताएँ जुड़ी होती हैं।

उदाहरण के लिए, मान लीजिए कि जेन नाम की एक उपयोगकर्ता टोक्यो में रहती है, और उसकी उम्र 28 है। उस उपयोगकर्ता के डिवाइस के लिए निम्नलिखित टैग सेट होंगे:

• नाम: जेन
• शहर: टोक्यो
• आयु: 28

जेन को लक्षित करने के लिए, आपको एक सेगमेंट का वर्णन इस प्रकार करना होगा:

AT("XXXXX-XXXXX", "Name", eq, "Jane") * AT("XXXXX-XXXXX", "Age", eq, 28) * AT("XXXXX-XXXXX", "City", eq, "Tokyo")

शर्तों का यह संयोजन एक फ़िल्टर एक्सप्रेशन है जिसका उपयोग सेगमेंटेशन भाषा में उपयोगकर्ताओं के समूहों यानी दर्शक सेगमेंट का वर्णन करने के लिए किया जाता है।

फ़िल्टर एक्सप्रेशन

फ़िल्टर एक्सप्रेशन एक स्ट्रिंग है जिसमें एक शर्त या शर्तों का संयोजन होता है जो आपके आवश्यक सेगमेंट का वर्णन करता है।

शर्तें

प्रत्येक शर्त उन डिवाइसों के एक सेगमेंट का वर्णन करती है जो उस शर्त में निर्दिष्ट मानदंडों से मेल खाते हैं।

उदाहरण के लिए, निम्नलिखित शर्त टोक्यो में रहने वाले उपयोगकर्ताओं का एक सेगमेंट बनाती है:

AT("XXXXX-XXXXX", "City", eq, "Tokyo")

जहाँ

• AT एक ऐप-स्कोप्ड टैग (शर्त का प्रकार) है;
• “XXXXX-XXXXX” उस ऐप का कोड है जिससे टैग मान संबद्ध है;
• eq लागू करने के लिए एक ऑपरेटर है;
• “Tokyo” एक टैग मान है जो उपयोगकर्ताओं के डिवाइसों से जुड़ा हुआ है।

शर्त के प्रकार

सेगमेंटेशन के लिए निम्नलिखित शर्त प्रकार उपलब्ध हैं:

• A (Application) – एक विशेष ऐप इंस्टॉल किए हुए डिवाइसों के एक सेगमेंट का वर्णन करता है। उपनाम: App, Application;
• AT (App-scoped tag) – निर्दिष्ट टैग मानों वाले डिवाइसों के एक सेगमेंट का वर्णन करता है; पहले तर्क के रूप में ऐप कोड आवश्यक है। उपनाम: Tag;
• Event – एक विशिष्ट Pushwoosh ईवेंट को ट्रिगर करने वाले डिवाइसों के एक सेगमेंट का वर्णन करता है;
• Geo – एक विशिष्ट भौगोलिक दायरे के भीतर डिवाइसों के एक सेगमेंट का वर्णन करता है;
• BTTS – उनके भेजने के लिए सबसे अच्छे समय के आधार पर डिवाइसों के एक सेगमेंट का वर्णन करता है;
• Updated – उनके अंतिम अपडेट टाइमस्टैम्प के आधार पर डिवाइसों के एक सेगमेंट का वर्णन करता है;
• Segment – किसी अन्य फ़िल्टर/सेगमेंट को उसके कोड द्वारा संदर्भित करता है;
• FeatureFlag – डिवाइसों को मिले फ़ीचर फ़्लैग की स्थिति के आधार पर डिवाइसों के एक सेगमेंट का वर्णन करता है;

टैग शर्तों के लिए एक ऐप कोड आवश्यक है

प्रत्येक कस्टम टैग एक एप्लिकेशन से संबंधित होता है। यह टैग बनाते समय सेट होता है, और इसे Control Panel या listTags में नहीं देखा जा सकता। टैग शर्तों को उस एप्लिकेशन के कोड के साथ AT("<app code>", "tag", ...) (उपनाम Tag) के रूप में लिखें, ताकि Pushwoosh को पता रहे कि टैग का मान कहाँ खोजना है।

Control Panel में बनाए गए Segment को इसकी आवश्यकता नहीं होती। यह पहले से ही एक एप्लिकेशन से बंधा होता है, इसलिए इसकी टैग शर्तें अपने आप हल हो जाती हैं। API के माध्यम से भेजे गए एक्सप्रेशन (NotifySegment में expression/filter_expression) के पास ऐसा कोई संदर्भ नहीं होता, इसलिए ऐप कोड स्पष्ट रूप से देना आवश्यक है।

शर्तों के साथ संचालन

परिष्कृत सेगमेंट बनाने के लिए, फ़िल्टर एक्सप्रेशन के भीतर शर्तों पर निम्नलिखित संचालन लागू किए जा सकते हैं:

यूनियन (+)

सेगमेंट को जोड़ता है, यानी, उन उपयोगकर्ताओं का एक नया सेगमेंट बनाता है जो निर्दिष्ट शर्तों में से कम से कम एक से मेल खाते हैं।

उदाहरण के लिए, टोक्यो या ओसाका में रहने वाले उपयोगकर्ताओं को लक्षित करने के लिए, आपको निम्नलिखित शर्तों के साथ सेगमेंट का वर्णन करना होगा:

AT("XXXXX-XXXXX", "City", eq, "Tokyo") + AT("XXXXX-XXXXX", "City", eq, "Osaka")

नोट

तार्किक वियोजन (OR) के बराबर। इसे or ऑपरेटर के रूप में भी लिखा जा सकता है।

इंटरसेक्शन (*)

शर्तों द्वारा वर्णित दोनों सेगमेंट से संबंधित उपयोगकर्ताओं का एक सेगमेंट बनाता है। इस प्रकार, केवल वे उपयोगकर्ता शामिल किए जाएंगे जो आपके द्वारा निर्दिष्ट प्रत्येक शर्त का पालन करते हैं।

निम्नलिखित एक्सप्रेशन उन उपयोगकर्ताओं के एक सेगमेंट का वर्णन करता है जो टोक्यो में रहते हैं और जिन्होंने अपने नाम निर्दिष्ट किए हैं:

AT("XXXXX-XXXXX", "City", eq, "Tokyo") * AT("XXXXX-XXXXX", "Name", any)

नोट

तार्किक संयोजन (AND) के अनुरूप। इसे and ऑपरेटर के रूप में भी लिखा जा सकता है।

अंतर (\)

उन उपयोगकर्ताओं का एक सेगमेंट बनाता है जो वर्णित सेगमेंट में से एक से संबंधित हैं और दूसरे से संबंधित नहीं हैं।

टोक्यो में रहने वाले लेकिन जिन्होंने आपको अपना नाम नहीं दिया है, उन उपयोगकर्ताओं का वर्णन इस प्रकार किया जाएगा:

AT("XXXXX-XXXXX", "City", eq, "Tokyo") \ AT("XXXXX-XXXXX", "Name", any)

नोट

तार्किक निषेध (NOT) के बराबर। इसे not ऑपरेटर के रूप में भी लिखा जा सकता है।

कोष्ठक

आपके फ़िल्टर एक्सप्रेशन में शर्तों के साथ किए जाने वाले संचालन के क्रम को निर्धारित करते हैं।

उदाहरण के लिए, निम्नलिखित फ़िल्टर एक्सप्रेशन पहले 12345-67890 ग्राहकों का एक सेगमेंट प्राप्त करेगा जिनकी आयु 18 है और फिर उस सेगमेंट के सभी पुरुषों को घटा देगा:

( A("12345-67890") * AT("12345-67890", "Age", eq, 18) ) \ AT("12345-67890", "Gender", eq, "Male")

टैग शर्तों के ऑपरेटर

प्रत्येक टैग प्रकार के लिए, उनके अपने ऑपरेटर लागू होते हैं।

इंटीजर टैग ऑपरेटर

• eq - एक निर्दिष्ट मान के बराबर
• noteq - एक निर्दिष्ट मान के बराबर नहीं
• lte - एक निर्दिष्ट मान से कम या बराबर
• gte - एक निर्दिष्ट मान से अधिक या बराबर
• in - निर्दिष्ट मानों में से कोई भी
• notin - निर्दिष्ट मानों में से किसी के बराबर नहीं
• between - एक निर्दिष्ट सीमा में
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

इंटीजर टैग सिंटैक्स उदाहरण

AT("XXXXX-XXXXX", "int", eq, 42)

स्ट्रिंग टैग ऑपरेटर

• eq - एक निर्दिष्ट मान के बराबर
• noteq - एक निर्दिष्ट मान के बराबर नहीं
• startswith - एक निर्दिष्ट उपसर्ग से शुरू होता है
• endswith - एक निर्दिष्ट प्रत्यय के साथ समाप्त होता है
• contains - एक निर्दिष्ट सबस्ट्रिंग शामिल है
• in - निर्दिष्ट मानों में से किसी के बराबर
• notin - निर्दिष्ट मानों में से किसी के बराबर नहीं
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

स्ट्रिंग टैग सिंटैक्स उदाहरण

• AT("XXXXX-XXXXX", "str", eq, "kangaroo") - सटीक मिलान
• AT("XXXXX-XXXXX", "str", startswith, "kang") - “kang” से शुरू होता है
• AT("XXXXX-XXXXX", "str", endswith, "roo") - “roo” के साथ समाप्त होता है
• AT("XXXXX-XXXXX", "str", contains, "nga") - स्ट्रिंग में कहीं भी “nga” शामिल है

लिस्ट टैग ऑपरेटर

• in - निर्दिष्ट टैग मानों में से किसी के साथ डिवाइस
• notin - डिवाइस से जुड़े निर्दिष्ट टैग मानों में से कोई नहीं
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

लिस्ट टैग सिंटैक्स उदाहरण

AT("XXXXX-XXXXX", "list", notin, ["kangaroo", "raccoon"])

डेट टैग ऑपरेटर

• eq - निर्दिष्ट तिथि के बराबर
• noteq - निर्दिष्ट तिथि के बराबर नहीं
• lte - निर्दिष्ट तिथि से पहले या उस पर
• gte - निर्दिष्ट तिथि के बाद या उस पर
• in - निर्दिष्ट तिथियों में से किसी के बराबर
• notin - निर्दिष्ट तिथियों में से किसी के बराबर नहीं
• between - एक निर्दिष्ट सीमा में
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस
• match - वर्ष के एक निर्दिष्ट महीने और महीने के दिन से मेल खाता है।

match ऑपरेटर उदाहरण

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - वे डिवाइस जिनका “Date tag” किसी भी वर्ष के 1 अप्रैल पर सेट है।
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - वे डिवाइस जिनका “Date tag” वर्तमान महीने के 13वें दिन पर सेट है।
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - वे डिवाइस जिनका “Date tag” परसों के दिन पर सेट है। सामान्य उपयोग का मामला: जन्मदिन की शुभकामनाएं।

वर्षगांठ और जन्मदिन सेगमेंट के लिए मैच ऑपरेटर के उदाहरण

आप आवर्ती कैलेंडर तिथियों के आधार पर उपयोगकर्ताओं को सेगमेंट कर सकते हैं, जैसे जन्मदिन या वर्षगांठ। इन मामलों में, केवल महीने और दिन को ध्यान में रखा जाता है, जबकि वर्ष को अनदेखा कर दिया जाता है।

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now") उन उपयोगकर्ताओं को लक्षित करता है जिनका जन्मदिन आज है (आज के समान दिन और महीना)। इसका उपयोग उपयोगकर्ता के वास्तविक जन्मदिन पर जन्मदिन की शुभकामनाएं या विशेष ऑफ़र भेजने के लिए करें।

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now+N") उन उपयोगकर्ताओं को लक्षित करता है जिनका जन्मदिन N दिनों में है (समान महीना और दिन, आज से N दिन)। इसका उपयोग उपयोगकर्ताओं को पहले से तैयार करने के लिए करें, उदाहरण के लिए, उलटी गिनती संदेश या आगामी ईवेंट रिमाइंडर भेजें।

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now-N") उन उपयोगकर्ताओं को लक्षित करता है जिनका जन्मदिन N दिन पहले था। इसका उपयोग विलंबित जन्मदिन संदेशों या फीडबैक अनुरोधों जैसे फॉलो-अप के लिए करें।

• AT("XXXXX-XXXXX", "birthday", match month "now" day N) उन उपयोगकर्ताओं को लक्षित करता है जिनका जन्मदिन वर्तमान महीने के Nवें दिन है, वर्ष की परवाह किए बिना। इसका उपयोग तब करें जब विशिष्ट तिथियों से जुड़ी निश्चित मासिक अभियानों की योजना बना रहे हों (उदाहरण के लिए, 10 तारीख को मासिक वफादारी पुरस्कार)।

• daysago eq - वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों के बराबर
• daysago noteq - वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों के बराबर नहीं
• daysago lte - वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों से कम या बराबर
• daysago gte - वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों से अधिक या बराबर
• daysago between - दिनों की निर्दिष्ट संख्याओं के बीच

daysago ऑपरेटर उदाहरण

• AT("XXXXX-XXXXX", "Date tag", daysago, eq, 0) - वर्तमान दिन 00:00 से वर्तमान क्षण तक
• AT("XXXXX-XXXXX", "Date tag", daysago, eq, 1) - पिछले दिन के 00:00 से वर्तमान दिन के 00:00 तक
• AT("XXXXX-XXXXX", "Date tag", daysago, gte, 1) - वर्तमान दिन के 00:00 तक का सारा समय
• AT("XXXXX-XXXXX", "Date tag", daysago, lte, 7) - 6 दिन पहले के 00:00 से वर्तमान क्षण तक
• AT("XXXXX-XXXXX", "Date tag", daysago, between, [2,7]) - 7 से 2 दिन पहले तक।

• minutesago lte - वर्तमान क्षण से पहले एक निर्दिष्ट संख्या के मिनटों से कम या बराबर
• minutesago gte - वर्तमान क्षण से पहले एक निर्दिष्ट संख्या के मिनटों से अधिक या बराबर

minutesago ऑपरेटर उदाहरण

• AT("XXXXX-XXXXX", "Date tag", minutesago, lte, 30) - पिछले 30 मिनट;
• AT("XXXXX-XXXXX", "Date tag", minutesago, gte, 60) - 60 या अधिक मिनट पहले;
• AT("XXXXX-XXXXX", "Date tag", minutesago, lte, 1) - पिछले मिनट के भीतर।

• daysahead - वर्तमान दिन (UTC) से N से M दिनों में, दोनों सिरों पर समावेशी

daysahead ऑपरेटर उदाहरण

daysahead एक [from, to] अंतराल लेता है (आज के UTC मध्यरात्रि से दिन, दोनों सिरे समावेशी)। daysago के विपरीत, इसका कोई उप-ऑपरेटर नहीं है — केवल अंतराल रूप।

• AT("XXXXX-XXXXX", "Date tag", daysahead, [0, 0]) - वर्तमान दिन 00:00 से 23:59:59 तक
• AT("XXXXX-XXXXX", "Date tag", daysahead, [1, 1]) - अगला दिन 00:00 से 23:59:59 तक
• AT("XXXXX-XXXXX", "Date tag", daysahead, [2, 5]) - अब से 2 दिनों की शुरुआत से लेकर अब से 5 दिनों के अंत तक का कोई भी क्षण

डेट ऑपरेटर उदाहरण

• AT("XXXXX-XXXXX", "Date tag", eq, "2022-12-05 00:00:00")

बूलियन टैग ऑपरेटर

• eq - एक निर्दिष्ट मान के बराबर
• noteq - एक निर्दिष्ट मान के बराबर नहीं
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

बूलियन टैग सिंटैक्स उदाहरण

AT("XXXXX-XXXXX", "bool", eq, true)

प्राइस टैग ऑपरेटर

• eq - एक निर्दिष्ट मान के बराबर
• noteq - एक निर्दिष्ट मान के बराबर नहीं
• lte - एक निर्दिष्ट मान से कम या बराबर
• gte - एक निर्दिष्ट मान से अधिक या बराबर
• in - निर्दिष्ट मानों में से किसी के बराबर
• notin - निर्दिष्ट मानों में से किसी के बराबर नहीं
• between - एक निर्दिष्ट सीमा में
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

प्राइस टैग सिंटैक्स उदाहरण

AT("XXXXX-XXXXX", "price", between, ["4.2", "6.9"])

वर्शन टैग ऑपरेटर

• eq - एक निर्दिष्ट मान के बराबर
• noteq - एक निर्दिष्ट मान के बराबर नहीं
• lte - एक निर्दिष्ट मान से कम या बराबर
• gte - एक निर्दिष्ट मान से अधिक या बराबर
• in - निर्दिष्ट मानों में से किसी के बराबर
• notin - निर्दिष्ट मानों में से किसी के बराबर नहीं
• between - एक निर्दिष्ट सीमा में
• any - टैग के लिए कोई भी मान सेट किए हुए डिवाइस
• notset - टैग के लिए कोई मान सेट नहीं किए हुए डिवाइस

वर्शन टैग सिंटैक्स उदाहरण

AT("XXXXX-XXXXX", "version", lte, "4.2")

ईवेंट शर्तों के ऑपरेटर

नोट

कृपया ध्यान रखें कि ईवेंट की शर्तें ऐप-विशिष्ट हैं इसलिए आपके फ़िल्टर एक्सप्रेशन में ऐप कोड को ईवेंट नाम के साथ निर्दिष्ट किया जाना चाहिए।

ईवेंट गणना

• count gte - डिवाइसों ने ईवेंट को n बार से अधिक या ठीक n बार ट्रिगर किया
• count lte - डिवाइसों ने ईवेंट को n बार से कम या ठीक n बार ट्रिगर किया
• count eq - डिवाइसों ने ईवेंट को ठीक n बार ट्रिगर किया
• count noteq - डिवाइसों ने ईवेंट को किसी भी बार ट्रिगर किया लेकिन n के बराबर नहीं

ईवेंट गणना सिंटैक्स उदाहरण

Event("11111-11111", "Level reached", count gte 10) // 11111-11111 एक ऐप कोड है

ईवेंट तिथि

• date gte - डिवाइसों ने ईवेंट को निर्दिष्ट तिथि के बाद या ठीक उसी पर ट्रिगर किया
• date lte - डिवाइसों ने ईवेंट को निर्दिष्ट तिथि से पहले या ठीक उसी पर ट्रिगर किया
• date eq - डिवाइसों ने ईवेंट को ठीक निर्दिष्ट तिथि पर ट्रिगर किया
• date noteq - डिवाइसों ने ईवेंट को कभी भी ट्रिगर किया लेकिन निर्दिष्ट तिथि पर नहीं
• date in - डिवाइसों ने ईवेंट को निर्दिष्ट तिथियों में से किसी पर भी ट्रिगर किया
• date notin - डिवाइसों ने ईवेंट को कभी भी ट्रिगर किया लेकिन निर्दिष्ट तिथियों में से किसी पर भी नहीं
• date between - डिवाइसों ने ईवेंट को एक निर्दिष्ट अवधि के भीतर ट्रिगर किया
• date daysago eq - ईवेंट ट्रिगर तिथि वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों के बराबर है
• date daysago noteq - ईवेंट ट्रिगर तिथि वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों के बराबर नहीं है
• date daysago lte - ईवेंट ट्रिगर तिथि वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों से कम या बराबर है
• date daysago gte - ईवेंट ट्रिगर तिथि वर्तमान दिन से पहले एक निर्दिष्ट संख्या के दिनों से अधिक या बराबर है
• date daysago between - ईवेंट ट्रिगर तिथि दिनों की निर्दिष्ट संख्याओं के बीच है
• date daysahead - ईवेंट ट्रिगर तिथि वर्तमान दिन से एक निर्दिष्ट संख्या के दिनों में है (अंतराल दोनों सिरों पर समावेशी है, पूर्ण सिमेंटिक्स के लिए ऊपर डेट टैग ऑपरेटर देखें)
• date minutesago lte - ईवेंट ट्रिगर तिथि वर्तमान क्षण से पहले निर्दिष्ट संख्या के मिनटों से कम या बराबर है
• date minutesago gte - ईवेंट ट्रिगर तिथि वर्तमान क्षण से पहले निर्दिष्ट संख्या के मिनटों से अधिक या बराबर है

ईवेंट तिथि सिंटैक्स उदाहरण

• Event("11111-11111", "Level reached", date gte "2022-01-01 01:02:03")
• Event("11111-11111", "Level reached", date in ["2022-01-01 01:02:03", "2022-01-01 02:03:04"])
• Event("11111-11111", "Level reached", date between "2022-01-01 01:02:03" "2022-01-01 02:03:04")
• Event("11111-11111", "Level reached", date daysahead 0 7) - अगले 7 दिनों के भीतर ट्रिगर तिथि वाले ईवेंट
• Event("11111-11111", "Level reached", date minutesago lte 30) - पिछले 30 मिनट के भीतर के ईवेंट
• Event("11111-11111", "Level reached", date minutesago gte 60) - 60+ मिनट पहले के ईवेंट

ईवेंट प्लेटफॉर्म

ईवेंट को उस प्लेटफॉर्म के अनुसार फ़िल्टर करें जहाँ वे ट्रिगर हुए थे।

• platforms - प्लेटफॉर्म की सूची (जैसे, [“ios”, “android”])

ईवेंट प्लेटफॉर्म सिंटैक्स उदाहरण

Event("11111-11111", "Level reached", platforms ["android", "ios"], count gte 5)

ईवेंट विशेषताएँ

ईवेंट की शर्तें ईवेंट विशेषता मानों के आधार पर फ़िल्टर कर सकती हैं। विशेषताएँ अपने संबंधित ऑपरेटरों के साथ विभिन्न डेटा प्रकारों का समर्थन करती हैं।

इंटीजर ईवेंट विशेषताएँ

• attribute “name” eq - विशेषता एक निर्दिष्ट मान के बराबर है
• attribute “name” noteq - विशेषता एक निर्दिष्ट मान के बराबर नहीं है
• attribute “name” gte - विशेषता एक निर्दिष्ट मान से अधिक या बराबर है
• attribute “name” lte - विशेषता एक निर्दिष्ट मान से कम या बराबर है
• attribute “name” between - विशेषता एक निर्दिष्ट सीमा में है
• attribute “name” in - विशेषता निर्दिष्ट मानों में से किसी के बराबर है
• attribute “name” notin - विशेषता निर्दिष्ट मानों में से किसी के बराबर नहीं है
• attribute “name” any - विशेषता के लिए कोई भी मान सेट है
• attribute “name” notset - विशेषता के लिए कोई मान सेट नहीं है

इंटीजर विशेषता सिंटैक्स उदाहरण

• Event("11111-11111", "Purchase", attribute "amount" eq 42)
• Event("11111-11111", "Purchase", attribute "amount" between 10 100)
• Event("11111-11111", "Purchase", attribute "amount" in [10, 20, 30])

स्ट्रिंग ईवेंट विशेषताएँ

• attribute “name” eq - विशेषता एक निर्दिष्ट मान के बराबर है
• attribute “name” noteq - विशेषता एक निर्दिष्ट मान के बराबर नहीं है
• attribute “name” startswith - विशेषता एक निर्दिष्ट उपसर्ग से शुरू होती है
• attribute “name” endswith - विशेषता एक निर्दिष्ट प्रत्यय के साथ समाप्त होती है
• attribute “name” contains - विशेषता एक निर्दिष्ट सबस्ट्रिंग शामिल करती है
• attribute “name” in - विशेषता निर्दिष्ट मानों में से किसी के बराबर है
• attribute “name” notin - विशेषता निर्दिष्ट मानों में से किसी के बराबर नहीं है
• attribute “name” any - विशेषता के लिए कोई भी मान सेट है
• attribute “name” notset - विशेषता के लिए कोई मान सेट नहीं है

स्ट्रिंग विशेषता सिंटैक्स उदाहरण

• Event("11111-11111", "Page View", attribute "url" startswith "https://example.com")
• Event("11111-11111", "Page View", attribute "url" endswith ".html")
• Event("11111-11111", "Page View", attribute "url" contains "/products/")
• Event("11111-11111", "Button Click", attribute "button_name" in ["submit", "cancel"])

बूलियन ईवेंट विशेषताएँ

• attribute “name” eq - विशेषता true या false के बराबर है
• attribute “name” noteq - विशेषता true या false के बराबर नहीं है

बूलियन विशेषता सिंटैक्स उदाहरण

Event("11111-11111", "Feature Toggle", attribute "enabled" eq true)

डेट ईवेंट विशेषताएँ

• attribute “name” eq - विशेषता एक निर्दिष्ट तिथि के बराबर है
• attribute “name” noteq - विशेषता एक निर्दिष्ट तिथि के बराबर नहीं है
• attribute “name” gte - विशेषता एक निर्दिष्ट तिथि के बाद या उस पर है
• attribute “name” lte - विशेषता एक निर्दिष्ट तिथि से पहले या उस पर है
• attribute “name” between - विशेषता एक निर्दिष्ट तिथि सीमा के भीतर है
• attribute “name” in - विशेषता निर्दिष्ट तिथियों में से किसी के बराबर है
• attribute “name” notin - विशेषता निर्दिष्ट तिथियों में से किसी के बराबर नहीं है
• attribute “name” daysago eq/noteq/gte/lte/between - विशेषता दिनों पहले के सापेक्ष
• attribute “name” daysahead from to - विशेषता वर्तमान दिन से दिनों के एक निर्दिष्ट अंतराल में (अंतराल दोनों सिरों पर समावेशी है, पूर्ण सिमेंटिक्स के लिए ऊपर डेट टैग ऑपरेटर देखें)
• attribute “name” minutesago gte/lte - विशेषता मिनटों पहले के सापेक्ष
• attribute “name” any - विशेषता के लिए कोई भी मान सेट है
• attribute “name” notset - विशेषता के लिए कोई मान सेट नहीं है

डेट विशेषता सिंटैक्स उदाहरण

• Event("11111-11111", "Subscription", attribute "start_date" eq "2022-01-01 01:02:03")
• Event("11111-11111", "Subscription", attribute "start_date" between "2022-01-01 00:00:00" "2022-12-31 23:59:59")
• Event("11111-11111", "Subscription", attribute "start_date" daysago lte 30) - पिछले 30 दिनों के भीतर
• Event("11111-11111", "Subscription", attribute "renewal_at" daysahead 0 30) - अगले 30 दिनों में नवीनीकरण
• Event("11111-11111", "Subscription", attribute "start_date" minutesago gte 60) - 60+ मिनट पहले

प्राइस ईवेंट विशेषताएँ

• attribute “name” eq - विशेषता एक निर्दिष्ट मूल्य मान के बराबर है
• attribute “name” noteq - विशेषता एक निर्दिष्ट मूल्य मान के बराबर नहीं है
• attribute “name” gte - विशेषता एक निर्दिष्ट मूल्य से अधिक या बराबर है
• attribute “name” lte - विशेषता एक निर्दिष्ट मूल्य से कम या बराबर है
• attribute “name” between - विशेषता एक निर्दिष्ट मूल्य सीमा में है
• attribute “name” in - विशेषता निर्दिष्ट मूल्यों में से किसी के बराबर है
• attribute “name” notin - विशेषता निर्दिष्ट मूल्यों में से किसी के बराबर नहीं है
• attribute “name” any - विशेषता के लिए कोई भी मान सेट है
• attribute “name” notset - विशेषता के लिए कोई मान सेट नहीं है

प्राइस विशेषता सिंटैक्स उदाहरण

Event("11111-11111", "Purchase", attribute "total_price" between 10.00 50.00)

लिस्ट ईवेंट विशेषताएँ

• attribute “name” in - विशेषता में निर्दिष्ट मानों में से कोई भी शामिल है
• attribute “name” notin - विशेषता में निर्दिष्ट मानों में से कोई भी शामिल नहीं है
• attribute “name” any - विशेषता के लिए कोई भी मान सेट है
• attribute “name” notset - विशेषता के लिए कोई मान सेट नहीं है

लिस्ट विशेषता सिंटैक्स उदाहरण

Event("11111-11111", "Cart Update", attribute "product_ids" in ["prod-123", "prod-456"])

ईवेंट विशेषता योग

योग विकल्प उसी Event(...) शर्त के अन्य विकल्पों (गणना, तिथि, प्लेटफॉर्म और विशेषता शर्तें) को पास करने वाले सभी ईवेंट में किसी इंटीजर या प्राइस विशेषता के कुल योग की तुलना करता है।

• sum “name” eq - योग एक निर्दिष्ट मान के बराबर है
• sum “name” noteq - योग एक निर्दिष्ट मान के बराबर नहीं है
• sum “name” gte - योग एक निर्दिष्ट मान से अधिक या बराबर है
• sum “name” lte - योग एक निर्दिष्ट मान से कम या बराबर है
• sum “name” between - योग एक निर्दिष्ट सीमा में है, दोनों सिरों सहित

नियम:

• विशेषता इंटीजर या प्राइस प्रकार की होनी चाहिए। किसी भी अन्य प्रकार से एक्सप्रेशन अमान्य हो जाता है।
• इंटीजर विशेषता के लिए मान पूर्ण संख्या होना चाहिए। sum "qty" gte 1.5 अमान्य है।
• between के लिए पहला मान दूसरे मान से कम या उसके बराबर होना चाहिए।
• मान ऋणात्मक हो सकते हैं। ऋणात्मक विशेषता मान, जैसे रिफ़ंड, योग में से घटा दिया जाता है।
• जिस ईवेंट में विशेषता नहीं है, वह योग में 0 जोड़ता है।
• जिस डिवाइस का कोई ईवेंट अन्य विकल्पों को पास नहीं करता, वह योग के मान की परवाह किए बिना शर्त से मेल नहीं खाता।
• count eq 0 के साथ, शर्त उन डिवाइसों को छोड़कर सभी डिवाइसों से मेल खाती है जिनके ईवेंट अन्य विकल्पों और योगों को पास करते हैं।
• एक शर्त में कई योग विकल्प AND से जोड़े जाते हैं। Event(...) के भीतर विकल्पों का क्रम मायने नहीं रखता।

ईवेंट विशेषता योग सिंटैक्स उदाहरण

• Event("11111-11111", "Purchased", sum "amount" gte 100) - कुल मिलाकर 100 या अधिक खर्च किए
• Event("11111-11111", "Purchased", sum "amount" between 0.5 99.99)
• Event("11111-11111", "Purchased", sum "amount" lte -1) - रिफ़ंड खरीदारी से अधिक हैं
• Event("11111-11111", "Purchased", date daysago lte 90, count gte 2, attribute "currency" eq "USD", sum "amount" gte 100, sum "qty" lte 10)

अतिरिक्त शर्त प्रकार

जियो शर्त

एक निर्दिष्ट दायरे के भीतर भौगोलिक स्थान के आधार पर डिवाइसों को लक्षित करें।

सिंटैक्स: Geo("<app-code>", <latitude>, <longitude>, <range-in-km>)

जियो सिंटैक्स उदाहरण

Geo("11111-11111", 53.2734, -7.77832031, 100.05) - निर्देशांकों के 100.05 किमी के भीतर डिवाइस

BTTS शर्त

डिवाइसों को उनके सूचनाएं भेजने के लिए सबसे अच्छे समय (दिन का घंटा, 0-23) के अनुसार लक्षित करें।

ऑपरेटर:

• any - भेजने के लिए कोई भी सबसे अच्छा समय मान सेट है
• eq - सटीक घंटे का मिलान
• noteq - घंटे के बराबर नहीं
• gte - घंटा इससे अधिक या बराबर
• lte - घंटा इससे कम या बराबर

BTTS सिंटैक्स उदाहरण

• BTTS("11111-11111", eq 10) - 10:00 बजे सबसे अच्छे समय वाले डिवाइस
• BTTS("11111-11111", gte 18) - 18:00 बजे से आगे सबसे अच्छे समय वाले डिवाइस
• BTTS("11111-11111", any) - किसी भी सबसे अच्छे समय मान वाले डिवाइस

अपडेटेड शर्त

डिवाइसों को उनके अंतिम अपडेट टाइमस्टैम्प के अनुसार फ़िल्टर करें।

ऑपरेटर:

• gte - निर्दिष्ट तिथि के बाद या उस पर अपडेट किया गया
• lte - निर्दिष्ट तिथि से पहले या उस पर अपडेट किया गया
• between - तिथि सीमा के भीतर अपडेट किया गया

अपडेटेड सिंटैक्स उदाहरण

• Updated("11111-11111", gte "2022-01-01 00:00:00") - 1 जनवरी, 2022 के बाद अपडेट किए गए डिवाइस
• Updated("11111-11111", lte "2022-12-31 23:59:59") - 31 दिसंबर, 2022 से पहले अपडेट किए गए डिवाइस
• Updated("11111-11111", between "2022-01-01 00:00:00" "2022-12-31 23:59:59") - 2022 में अपडेट किए गए डिवाइस

सेगमेंट शर्त

किसी अन्य फ़िल्टर/सेगमेंट को उसके कोड द्वारा संदर्भित करें।

सेगमेंट सिंटैक्स उदाहरण

Segment("11111-11111", "22222-22222") - कोड “22222-22222” वाले फ़िल्टर का संदर्भ लें

फ़ीचर फ़्लैग शर्त

डिवाइसों को SDK से मिले फ़ीचर फ़्लैग के परिणाम के अनुसार लक्षित करें।

सिंटैक्स: FeatureFlag("<app-code>", "<flag-key>", "<state>")

स्थिति इनमें से एक मान लेती है:

• enabled - वे डिवाइस जिन्हें फ़्लैग ऑन मिला
• disabled - वे डिवाइस जिन्हें फ़्लैग ऑफ़ मिला
• rule:<rule_id> - वे डिवाइस जो इस नियम के सेगमेंट से मेल खाते हैं, चाहे इसके रोलआउट ने उनके लिए फ़्लैग ऑन किया हो या नहीं। फ़ीचर फ़्लैग API से rule_id का उपयोग करें।

FeatureFlag सिंटैक्स उदाहरण

• FeatureFlag("11111-11111", "new_checkout", "enabled") - वे डिवाइस जिनके लिए फ़्लैग new_checkout ऑन है
• FeatureFlag("11111-11111", "new_checkout", "disabled") - वे डिवाइस जिनके लिए फ़्लैग ऑफ़ है
• FeatureFlag("11111-11111", "new_checkout", "rule:r_1a2b3c4d") - वे डिवाइस जो नियम r_1a2b3c4d से मेल खाते हैं

जिस डिवाइस ने कभी फ़्लैग का अनुरोध नहीं किया, वह किसी भी स्थिति से मेल नहीं खाता। जब फ़्लैग को Kill switch से बंद या आर्काइव किया जाता है, तो लगभग 10 सेकंड के भीतर enabled और rule: किसी भी डिवाइस से मेल नहीं खाते, और disabled हर उस डिवाइस से मेल खाता है जिसे कभी भी फ़्लैग मिला हो।

फ़्लैग और नियम एप्लिकेशन में मौजूद होने चाहिए, और अकाउंट के प्लान में फ़ीचर फ़्लैग शामिल होने चाहिए। अन्यथा सेगमेंट सेव नहीं होता, और त्रुटि में गायब फ़्लैग या नियम का नाम होता है या Your plan does not include feature flags लिखा होता है। जहाँ API कारण कोड लौटाता है, वह FILTER_EXPRESSION_FEATURE_FLAG_NOT_FOUND है। High Speed Delivery सेगमेंट में केवल टैग शर्तें हो सकती हैं, इसलिए उसमें यह शर्त नहीं हो सकती।

एप्लिकेशन शर्त डिवाइस उपस्थिति फ़्लैग

एप्लिकेशन की शर्तें डिवाइस और टोकन फ़िल्टरिंग को नियंत्रित करने के लिए अतिरिक्त फ़्लैग का समर्थन करती हैं:

• with_tokens - पुश नोटिफिकेशन टोकन वाले डिवाइस
• without_tokens - पुश नोटिफिकेशन टोकन के बिना डिवाइस
• with_devices - पंजीकृत डिवाइस वाले उपयोगकर्ता
• without_devices - पंजीकृत डिवाइस के बिना उपयोगकर्ता/प्रोफाइल

एप्लिकेशन फ़्लैग सिंटैक्स उदाहरण

• A("11111-11111", ["ios", "android"], [with_tokens]) - पुश टोकन वाले डिवाइस
• A("11111-11111", ["ios", "android"], [without_tokens]) - पुश टोकन के बिना डिवाइस
• A("11111-11111", [], [with_devices]) - डिवाइस रिकॉर्ड वाले सभी डिवाइस
• A("11111-11111", ["ios", "android"], [without_tokens, with_devices]) - टोकन के बिना लेकिन डिवाइस रिकॉर्ड वाले डिवाइस

फ़िल्टर एक्सप्रेशन उदाहरण

नोट

JSON क्वेरी लिखते समय, कोट्स (") और बैकस्लैश (\) को एक बैकस्लैश (\) के साथ एस्केप करना सुनिश्चित करें। एक उदाहरण अनुरोध के लिए, /exportSegment देखें।

बुनियादी उदाहरण

1. ऐप इंस्टॉल किए हुए और पुश टोकन वाले iOS और Android डिवाइस:

A("11111-11111", ["ios","android"], [with_tokens])

2. ऐप इंस्टॉल किए हुए लेकिन पुश टोकन के बिना iOS और Android डिवाइस:

A("11111-11111", ["ios","android"], [without_tokens])

3. ऐप इंस्टॉल किए हुए iOS और Android डिवाइस, चाहे उनके पास पुश टोकन हों या नहीं:

A("11111-11111", ["ios","android"], [with_tokens, without_tokens])

4. सभी ऐप ग्राहक जिन्होंने ऐप में कुछ खरीदा है:

AT("11111-11111", "In-App Purchase", gte, 1)

उन्नत उदाहरण

5. टोक्यो में उपयोगकर्ता जिन्होंने पिछले 7 दिनों में ऐप खोला है:

AT("11111-11111", "City", eq, "Tokyo") * Event("11111-11111", "App Open", date daysago lte 7)

6. वे उपयोगकर्ता जिन्होंने पिछले 30 दिनों में $50 से अधिक की खरीदारी की है:

Event("11111-11111", "Purchase", attribute "total_price" gte 50.00, date daysago lte 30)

7. वे उपयोगकर्ता जिनके नाम “J” से शुरू होते हैं या “e” पर समाप्त होते हैं:

AT("11111-11111", "Name", startswith, "J") + AT("11111-11111", "Name", endswith, "e")

8. न्यूयॉर्क के 100 किमी के भीतर सक्रिय iOS उपयोगकर्ता जिन्होंने हाल ही में खरीदारी नहीं की है:

A("11111-11111", ["ios"], [with_tokens]) * Geo("11111-11111", 40.7128, -74.0060, 100) \ Event("11111-11111", "Purchase", date daysago lte 30)

9. सुबह 9 बजे से शाम 5 बजे के बीच भेजने के लिए सबसे अच्छे समय वाले उपयोगकर्ता:

BTTS("11111-11111", gte 9) * BTTS("11111-11111", lte 17)

10. वे उपयोगकर्ता जिन्होंने पिछले घंटे में Android या iOS पर एक विशिष्ट ईवेंट ट्रिगर किया है:

Event("11111-11111", "Button Click", platforms ["android", "ios"], date minutesago lte 60)

11. पिछले 3 महीनों में अपडेट किए गए डिवाइस जिनका ऐप वर्शन 4.2 या उच्चतर है:

Updated("11111-11111", gte "2024-07-01 00:00:00") * AT("11111-11111", "App Version", gte, "4.2")