সেগমেন্টেশন ভাষা

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": "T(\"City\", eq, \"Tokyo\") * T(\"Age\", gte, 18)",
      "payload": {
        "content": {
          "localized_content": {
            "en": { "ios": { "body": "Hello, Tokyo!" } }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" }
    }
  }'

নোট

ইনলাইন এক্সপ্রেশন পাঠানোর সময় মূল্যায়ন করা হয় এবং প্রি-কম্পাইলেশন এড়িয়ে যায় — এগুলি হাই-স্পিড ডেলিভারি এর সাথে কাজ করে না, যার জন্য code দ্বারা উল্লেখিত একটি সংরক্ষিত সেগমেন্ট প্রয়োজন।

মৌলিক বিষয়

আপনার ব্যবহারকারী বেসের প্রতিটি ডিভাইসের সাথে নির্দিষ্ট বৈশিষ্ট্য ট্যাগ মানের মাধ্যমে যুক্ত থাকে।

উদাহরণস্বরূপ, ধরা যাক জেন নামের একজন ব্যবহারকারী টোকিওতে থাকেন এবং তার বয়স ২৮। সেই ব্যবহারকারীর ডিভাইসের জন্য নিম্নলিখিত ট্যাগগুলি সেট করা থাকবে:

• Name: Jane
• City: Tokyo
• Age: 28

জেনকে লক্ষ্য করতে, আপনাকে নিম্নলিখিতভাবে একটি সেগমেন্ট বর্ণনা করতে হবে:

T("Name", eq, "Jane") * T("Age", eq, 28) * T("City", eq, "Tokyo")

শর্তগুলির এই সংমিশ্রণটি একটি ফিল্টার এক্সপ্রেশন যা সেগমেন্টেশন ভাষায় ব্যবহারকারীদের গ্রুপ অর্থাৎ দর্শক সেগমেন্ট বর্ণনা করার জন্য ব্যবহৃত হয়।

ফিল্টার এক্সপ্রেশন

ফিল্টার এক্সপ্রেশন হলো একটি স্ট্রিং যা আপনার প্রয়োজনীয় সেগমেন্ট বর্ণনা করার জন্য একটি শর্ত বা শর্তের সংমিশ্রণ ধারণ করে।

শর্তাবলী

প্রতিটি শর্ত ডিভাইসের একটি সেগমেন্ট বর্ণনা করে যা সেই শর্তে নির্দিষ্ট মানদণ্ডের সাথে মেলে।

উদাহরণস্বরূপ, নিম্নলিখিত শর্তটি টোকিওতে বসবাসকারী ব্যবহারকারীদের একটি সেগমেন্ট তৈরি করে:

T("City", e, "Tokyo")

যেখানে

• T হলো একটি ট্যাগ (শর্তের প্রকার);
• eq হলো প্রয়োগ করার জন্য একটি অপারেটর;
• “Tokyo” হলো একটি ট্যাগ মান যা ব্যবহারকারীদের ডিভাইসের সাথে যুক্ত আছে।

শর্তের প্রকারভেদ

সেগমেন্টেশনের জন্য নিম্নলিখিত শর্তের প্রকারভেদ উপলব্ধ:

• A (Application) – একটি নির্দিষ্ট অ্যাপ ইনস্টল করা ডিভাইসের একটি সেগমেন্ট বর্ণনা করে। উপনাম: App, Application;
• T (Tag) – নির্দিষ্ট ট্যাগ মান সহ ডিভাইসের একটি সেগমেন্ট বর্ণনা করে;
• AT (App-scoped tag) – একটি নির্দিষ্ট অ্যাপ্লিকেশনের মধ্যে একটি ট্যাগ মান খোঁজে; প্রথম আর্গুমেন্ট হিসাবে অ্যাপ কোড প্রয়োজন। উপনাম: Tag;
• Event – একটি নির্দিষ্ট Pushwoosh ইভেন্ট ট্রিগার করা ডিভাইসের একটি সেগমেন্ট বর্ণনা করে;
• Geo – একটি নির্দিষ্ট ভৌগলিক ব্যাসার্ধের মধ্যে ডিভাইসের একটি সেগমেন্ট বর্ণনা করে;
• BTTS – তাদের পাঠানোর সেরা সময়ের উপর ভিত্তি করে ডিভাইসের একটি সেগমেন্ট বর্ণনা করে;
• Updated – তাদের শেষ আপডেট টাইমস্ট্যাম্পের উপর ভিত্তি করে ডিভাইসের একটি সেগমেন্ট বর্ণনা করে;
• Segment – তার কোড দ্বারা অন্য ফিল্টার/সেগমেন্টকে উল্লেখ করে;

শর্তাবলী নিয়ে অপারেশন

জটিল সেগমেন্ট তৈরির জন্য, ফিল্টার এক্সপ্রেশনের মধ্যে শর্তাবলীতে নিম্নলিখিত অপারেশনগুলি প্রয়োগ করা যেতে পারে:

ইউনিয়ন (+)

সেগমেন্টগুলিকে যুক্ত করে, অর্থাৎ, এমন ব্যবহারকারীদের একটি নতুন সেগমেন্ট তৈরি করে যারা নির্দিষ্ট শর্তগুলির মধ্যে অন্তত একটির সাথে মেলে।

উদাহরণস্বরূপ, টোকিও বা ওসাকাতে বসবাসকারী ব্যবহারকারীদের লক্ষ্য করতে, আপনাকে নিম্নলিখিত শর্তাবলী দিয়ে সেগমেন্টটি বর্ণনা করতে হবে:

T("City", eq, "Tokyo") + T("City", eq, "Osaka")

নোট

যৌক্তিক disjunction (OR) এর সমতুল্য। or অপারেটর হিসাবেও লেখা যেতে পারে।

ইন্টারসেকশন (*)

শর্তাবলী দ্বারা বর্ণিত উভয় সেগমেন্টের অন্তর্গত ব্যবহারকারীদের একটি সেগমেন্ট তৈরি করে। সুতরাং, শুধুমাত্র সেই ব্যবহারকারীরা অন্তর্ভুক্ত হবে যারা আপনার নির্দিষ্ট করা প্রতিটি শর্ত মেনে চলে।

নিম্নলিখিত এক্সপ্রেশনটি এমন ব্যবহারকারীদের একটি সেগমেন্ট বর্ণনা করে যারা টোকিওতে বসবাস করে এবং তাদের নাম নির্দিষ্ট করেছে:

T("City", eq, "Tokyo") * T("Name", any)

নোট

যৌক্তিক conjunction (AND) এর অনুরূপ। and অপারেটর হিসাবেও লেখা যেতে পারে।

পার্থক্য (\)

এমন ব্যবহারকারীদের একটি সেগমেন্ট তৈরি করে যারা বর্ণিত সেগমেন্টগুলির একটির অন্তর্গত এবং অন্যটির অন্তর্গত নয়।

যে ব্যবহারকারীরা টোকিওতে বসবাস করে কিন্তু তাদের নাম দেয়নি, তাদের নিম্নলিখিতভাবে বর্ণনা করা হবে:

T("City", eq, "Tokyo") \ T("Name", any)

নোট

যৌক্তিক negation (NOT) এর সমতুল্য। not অপারেটর হিসাবেও লেখা যেতে পারে।

বন্ধনী

আপনার ফিল্টার এক্সপ্রেশনে শর্তাবলী নিয়ে অপারেশন করার ক্রম নির্ধারণ করে।

উদাহরণস্বরূপ, নিম্নলিখিত ফিল্টার এক্সপ্রেশনটি প্রথমে 12345-67890 গ্রাহকদের একটি সেগমেন্ট পাবে যাদের বয়স 18 এবং তারপর সেই সেগমেন্ট থেকে সমস্ত পুরুষদের বাদ দেবে:

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

ট্যাগ শর্তের অপারেটর

প্রতিটি ট্যাগ প্রকারের জন্য, তাদের নিজস্ব অপারেটর প্রয়োগ করা হয়।

Integer ট্যাগ অপারেটর

• eq - একটি নির্দিষ্ট মানের সমান
• noteq - একটি নির্দিষ্ট মানের সমান নয়
• lte - একটি নির্দিষ্ট মানের চেয়ে কম বা সমান
• gte - একটি নির্দিষ্ট মানের চেয়ে বেশি বা সমান
• in - নির্দিষ্ট মানগুলির যেকোনো একটি
• notin - নির্দিষ্ট মানগুলির কোনোটির সমান নয়
• between - একটি নির্দিষ্ট পরিসরের মধ্যে
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

Integer ট্যাগ সিনট্যাক্স উদাহরণ

T("int", eq, 42)

String ট্যাগ অপারেটর

• eq - একটি নির্দিষ্ট মানের সমান
• noteq - একটি নির্দিষ্ট মানের সমান নয়
• startswith - একটি নির্দিষ্ট উপসর্গ দিয়ে শুরু হয়
• endswith - একটি নির্দিষ্ট প্রত্যয় দিয়ে শেষ হয়
• contains - একটি নির্দিষ্ট সাবস্ট্রিং ধারণ করে
• in - নির্দিষ্ট মানগুলির যেকোনো একটির সমান
• notin - নির্দিষ্ট মানগুলির কোনোটির সমান নয়
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

String ট্যাগ সিনট্যাক্স উদাহরণ

• T("str", eq, "kangaroo") - সঠিক মিল
• T("str", startswith, "kang") - “kang” দিয়ে শুরু
• T("str", endswith, "roo") - “roo” দিয়ে শেষ
• T("str", contains, "nga") - স্ট্রিংয়ের যেকোনো জায়গায় “nga” ধারণ করে

List ট্যাগ অপারেটর

• in - নির্দিষ্ট ট্যাগ মানগুলির যেকোনো একটি সহ ডিভাইস
• notin - ডিভাইসের সাথে যুক্ত নির্দিষ্ট ট্যাগ মানগুলির কোনোটিই নয়
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

List ট্যাগ সিনট্যাক্স উদাহরণ

T("list", notin, ["kangaroo", "raccoon"])

Date ট্যাগ অপারেটর

• eq - নির্দিষ্ট তারিখের সমান
• noteq - নির্দিষ্ট তারিখের সমান নয়
• lte - নির্দিষ্ট তারিখের আগে বা সেই তারিখে
• gte - নির্দিষ্ট তারিখের পরে বা সেই তারিখে
• in - নির্দিষ্ট তারিখগুলির যেকোনো একটির সমান
• notin - নির্দিষ্ট তারিখগুলির কোনোটির সমান নয়
• between - একটি নির্দিষ্ট পরিসরের মধ্যে
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস
• match - বছরের একটি নির্দিষ্ট মাস এবং মাসের একটি নির্দিষ্ট দিনের সাথে মেলে।

match অপারেটরের উদাহরণ

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - যে ডিভাইসগুলির “Date tag” যেকোনো বছরের ১লা এপ্রিলে সেট করা আছে।
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - যে ডিভাইসগুলির “Date tag” বর্তমান মাসের ১৩ তারিখে সেট করা আছে।
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - যে ডিভাইসগুলির “Date tag” আগামী পরশুতে সেট করা আছে। সাধারণ ব্যবহার: জন্মদিনের শুভেচ্ছা।

বার্ষিকী এবং জন্মদিনের সেগমেন্টের জন্য Match অপারেটরের উদাহরণ

আপনি পুনরাবৃত্ত ক্যালেন্ডার তারিখের উপর ভিত্তি করে ব্যবহারকারীদের সেগমেন্ট করতে পারেন, যেমন জন্মদিন বা বার্ষিকী। এই ক্ষেত্রে, শুধুমাত্র মাস এবং দিন বিবেচনা করা হয়, যখন বছর উপেক্ষা করা হয়।

• 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-তম দিনে, বছর নির্বিশেষে, তাদের লক্ষ্য করে। নির্দিষ্ট তারিখের সাথে যুক্ত নির্দিষ্ট মাসিক প্রচারণার পরিকল্পনা করার সময় এটি ব্যবহার করুন (যেমন, প্রতি মাসের ১০ তারিখে মাসিক আনুগত্য পুরস্কার)।

• daysago eq - বর্তমান দিনের আগে একটি নির্দিষ্ট সংখ্যক দিনের সমান
• daysago noteq - বর্তমান দিনের আগে একটি নির্দিষ্ট সংখ্যক দিনের সমান নয়
• daysago lte - বর্তমান দিনের আগে একটি নির্দিষ্ট সংখ্যক দিনের চেয়ে কম বা সমান
• daysago gte - বর্তমান দিনের আগে একটি নির্দিষ্ট সংখ্যক দিনের চেয়ে বেশি বা সমান
• daysago between - নির্দিষ্ট সংখ্যক দিনের মধ্যে

daysago অপারেটরের উদাহরণ

• T("Date tag", daysago, eq, 0) - বর্তমান দিন ০০:০০ থেকে বর্তমান মুহূর্ত পর্যন্ত
• T("Date tag", daysago, eq, 1) - আগের দিনের ০০:০০ থেকে বর্তমান দিনের ০০:০০ পর্যন্ত
• T("Date tag", daysago, gte, 1) - বর্তমান দিনের ০০:০০ পর্যন্ত সমস্ত সময়
• T("Date tag", daysago, lte, 7) - ৬ দিন আগের দিনের ০০:০০ থেকে বর্তমান মুহূর্ত পর্যন্ত
• T("Date tag", daysago, between, [2,7]) - ৭ থেকে ২ দিন আগে।

• minutesago lte - বর্তমান মুহূর্তের আগে একটি নির্দিষ্ট সংখ্যক মিনিটের চেয়ে কম বা সমান
• minutesago gte - বর্তমান মুহূর্তের আগে একটি নির্দিষ্ট সংখ্যক মিনিটের চেয়ে বেশি বা সমান

minutesago অপারেটরের উদাহরণ

• T("Date tag", minutesago, lte, 30) - শেষ ৩০ মিনিট;
• T("Date tag", minutesago, gte, 60) - ৬০ বা তার বেশি মিনিট আগে;
• T("Date tag", minutesago, lte, 1) - শেষ মিনিটের মধ্যে।

• daysahead - বর্তমান দিন (UTC) থেকে N থেকে M দিনের মধ্যে, উভয় প্রান্ত অন্তর্ভুক্ত

daysahead অপারেটরের উদাহরণ

daysahead একটি [from, to] ব্যবধান নেয় (আজকের UTC মধ্যরাত থেকে দিন, উভয় প্রান্ত অন্তর্ভুক্ত)। daysago এর মতো, এর কোনো উপ-অপারেটর নেই — শুধুমাত্র ব্যবধান ফর্ম।

• T("Date tag", daysahead, [0, 0]) - বর্তমান দিন ০০:০০ থেকে ২৩:৫৯:৫৯ পর্যন্ত
• T("Date tag", daysahead, [1, 1]) - পরের দিন ০০:০০ থেকে ২৩:৫৯:৫৯ পর্যন্ত
• T("Date tag", daysahead, [2, 5]) - এখন থেকে ২ দিন পর শুরু থেকে এখন থেকে ৫ দিন পর শেষ পর্যন্ত যেকোনো মুহূর্ত

date অপারেটরের উদাহরণ

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

Boolean ট্যাগ অপারেটর

• eq - একটি নির্দিষ্ট মানের সমান
• noteq - একটি নির্দিষ্ট মানের সমান নয়
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

Boolean ট্যাগ সিনট্যাক্স উদাহরণ

T("bool", eq, true)

Price ট্যাগ অপারেটর

• eq - একটি নির্দিষ্ট মানের সমান
• noteq - একটি নির্দিষ্ট মানের সমান নয়
• lte - একটি নির্দিষ্ট মানের চেয়ে কম বা সমান
• gte - একটি নির্দিষ্ট মানের চেয়ে বেশি বা সমান
• in - নির্দিষ্ট মানগুলির যেকোনো একটির সমান
• notin - নির্দিষ্ট মানগুলির কোনোটির সমান নয়
• between - একটি নির্দিষ্ট পরিসরের মধ্যে
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

Price ট্যাগ সিনট্যাক্স উদাহরণ

T("price", between, ["4.2", "6.9"])

Version ট্যাগ অপারেটর

• eq - একটি নির্দিষ্ট মানের সমান
• noteq - একটি নির্দিষ্ট মানের সমান নয়
• lte - একটি নির্দিষ্ট মানের চেয়ে কম বা সমান
• gte - একটি নির্দিষ্ট মানের চেয়ে বেশি বা সমান
• in - নির্দিষ্ট মানগুলির যেকোনো একটির সমান
• notin - নির্দিষ্ট মানগুলির কোনোটির সমান নয়
• between - একটি নির্দিষ্ট পরিসরের মধ্যে
• any - ট্যাগের জন্য যেকোনো মান সেট করা ডিভাইস
• notset - ট্যাগের জন্য কোনো মান সেট করা নেই এমন ডিভাইস

Version ট্যাগ সিনট্যাক্স উদাহরণ

T("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) - আগামী ৭ দিনের মধ্যে ট্রিগার তারিখ সহ ইভেন্ট
• Event("11111-11111", "Level reached", date minutesago lte 30) - শেষ ৩০ মিনিটের মধ্যে ইভেন্ট
• Event("11111-11111", "Level reached", date minutesago gte 60) - ৬০+ মিনিট আগে ইভেন্ট

ইভেন্ট প্ল্যাটফর্ম

যে প্ল্যাটফর্মে ইভেন্টগুলি ট্রিগার হয়েছিল সেই প্ল্যাটফর্ম দ্বারা ইভেন্টগুলি ফিল্টার করুন।

• platforms - প্ল্যাটফর্মের তালিকা (যেমন, [“ios”, “android”])

ইভেন্ট প্ল্যাটফর্ম সিনট্যাক্স উদাহরণ

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

ইভেন্ট অ্যাট্রিবিউট

ইভেন্ট শর্তগুলি ইভেন্ট অ্যাট্রিবিউট মানের উপর ভিত্তি করে ফিল্টার করতে পারে। অ্যাট্রিবিউটগুলি তাদের সংশ্লিষ্ট অপারেটরগুলির সাথে বিভিন্ন ডেটা প্রকার সমর্থন করে।

Integer ইভেন্ট অ্যাট্রিবিউট

• 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 - অ্যাট্রিবিউটের জন্য কোনো মান সেট করা নেই

Integer অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

• 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])

String ইভেন্ট অ্যাট্রিবিউট

• 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 - অ্যাট্রিবিউটের জন্য কোনো মান সেট করা নেই

String অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

• 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"])

Boolean ইভেন্ট অ্যাট্রিবিউট

• attribute “name” eq - অ্যাট্রিবিউট true বা false এর সমান
• attribute “name” noteq - অ্যাট্রিবিউট true বা false এর সমান নয়

Boolean অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

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

Date ইভেন্ট অ্যাট্রিবিউট

• 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 - অ্যাট্রিবিউটের জন্য কোনো মান সেট করা নেই

Date অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

• 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) - শেষ ৩০ দিনের মধ্যে
• Event("11111-11111", "Subscription", attribute "renewal_at" daysahead 0 30) - আগামী ৩০ দিনের মধ্যে নবায়ন
• Event("11111-11111", "Subscription", attribute "start_date" minutesago gte 60) - ৬০+ মিনিট আগে

Price ইভেন্ট অ্যাট্রিবিউট

• 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 - অ্যাট্রিবিউটের জন্য কোনো মান সেট করা নেই

Price অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

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

List ইভেন্ট অ্যাট্রিবিউট

• attribute “name” in - অ্যাট্রিবিউট নির্দিষ্ট মানগুলির যেকোনো একটি ধারণ করে
• attribute “name” notin - অ্যাট্রিবিউট নির্দিষ্ট মানগুলির কোনোটি ধারণ করে না
• attribute “name” any - অ্যাট্রিবিউটের জন্য যেকোনো মান সেট করা আছে
• attribute “name” notset - অ্যাট্রিবিউটের জন্য কোনো মান সেট করা নেই

List অ্যাট্রিবিউট সিনট্যাক্স উদাহরণ

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

অতিরিক্ত শর্তের প্রকারভেদ

Geo শর্ত

একটি নির্দিষ্ট ব্যাসার্ধের মধ্যে ভৌগলিক অবস্থানের উপর ভিত্তি করে ডিভাইসগুলিকে লক্ষ্য করুন।

সিনট্যাক্স: Geo("<app-code>", <latitude>, <longitude>, <range-in-km>)

Geo সিনট্যাক্স উদাহরণ

Geo("11111-11111", 53.2734, -7.77832031, 100.05) - স্থানাঙ্কের ১০০.০৫ কিমি এর মধ্যে ডিভাইস

BTTS শর্ত

বিজ্ঞপ্তি পাঠানোর সেরা সময় (দিনের ঘন্টা, ০-২৩) দ্বারা ডিভাইসগুলিকে লক্ষ্য করুন।

অপারেটর:

• any - পাঠানোর সেরা সময়ের যেকোনো মান সেট করা আছে
• eq - সঠিক ঘন্টা মিল
• noteq - ঘন্টার সমান নয়
• gte - ঘন্টা এর চেয়ে বেশি বা সমান
• lte - ঘন্টা এর চেয়ে কম বা সমান

BTTS সিনট্যাক্স উদাহরণ

• BTTS("11111-11111", eq 10) - ১০:০০ টায় সেরা সময় সহ ডিভাইস
• BTTS("11111-11111", gte 18) - ১৮:০০ টা থেকে সেরা সময় সহ ডিভাইস
• BTTS("11111-11111", any) - যেকোনো সেরা সময় মান সহ ডিভাইস

Updated শর্ত

তাদের শেষ আপডেট টাইমস্ট্যাম্প দ্বারা ডিভাইসগুলি ফিল্টার করুন।

অপারেটর:

• gte - নির্দিষ্ট তারিখের পরে বা সেই তারিখে আপডেট হয়েছে
• lte - নির্দিষ্ট তারিখের আগে বা সেই তারিখে আপডেট হয়েছে
• between - তারিখ পরিসরের মধ্যে আপডেট হয়েছে

Updated সিনট্যাক্স উদাহরণ

• Updated("11111-11111", gte "2022-01-01 00:00:00") - ১ জানুয়ারী, ২০২২ এর পরে আপডেট হওয়া ডিভাইস
• Updated("11111-11111", lte "2022-12-31 23:59:59") - ৩১ ডিসেম্বর, ২০২২ এর আগে আপডেট হওয়া ডিভাইস
• Updated("11111-11111", between "2022-01-01 00:00:00" "2022-12-31 23:59:59") - ২০২২ সালে আপডেট হওয়া ডিভাইস

Segment শর্ত

তার কোড দ্বারা অন্য ফিল্টার/সেগমেন্টকে উল্লেখ করুন।

Segment সিনট্যাক্স উদাহরণ

Segment("11111-11111", "22222-22222") - “22222-22222” কোড সহ ফিল্টার উল্লেখ করুন

অ্যাপ্লিকেশন শর্তের ডিভাইস উপস্থিতি ফ্ল্যাগ

অ্যাপ্লিকেশন শর্তগুলি ডিভাইস এবং টোকেন ফিল্টারিং নিয়ন্ত্রণ করতে অতিরিক্ত ফ্ল্যাগ সমর্থন করে:

• 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. টোকিওতে থাকা ব্যবহারকারীরা যারা গত ৭ দিনে অ্যাপটি খুলেছেন:

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

6. যে ব্যবহারকারীরা গত ৩০ দিনে $৫০ এর বেশি কেনাকাটা করেছেন:

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

7. যে ব্যবহারকারীদের নাম “J” দিয়ে শুরু হয় বা “e” দিয়ে শেষ হয়:

T("Name", startswith, "J") + T("Name", endswith, "e")

8. নিউ ইয়র্কের ১০০ কিমি এর মধ্যে সক্রিয় iOS ব্যবহারকারীরা যারা সম্প্রতি কেনাকাটা করেননি:

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

9. সকাল ৯টা থেকে বিকেল ৫টার মধ্যে পাঠানোর সেরা সময় সহ ব্যবহারকারীরা:

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. গত ৩ মাসে আপডেট হওয়া ডিভাইসগুলি যাদের অ্যাপ সংস্করণ ৪.২ বা তার বেশি:

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