ট্যাগ হলো Pushwoosh-এর সবচেয়ে দরকারী টুলগুলির মধ্যে একটি, যা বিভিন্ন ধরণের উন্নত কার্যকারিতা সক্ষম করে। ট্যাগ ব্যবহার করে, আপনি আপনার দর্শকদের বিভাজন করতে পারেন এবং তাদের বৈশিষ্ট্যের উপর ভিত্তি করে নির্দিষ্ট ব্যবহারকারীদের কাছে লক্ষ্যযুক্ত পুশ নোটিফিকেশন পাঠাতে পারেন।

ট্যাগগুলিতে একটি নির্দিষ্ট ব্যবহারকারী বা ডিভাইসের সাথে সম্পর্কিত যেকোনো ডেটা থাকতে পারে। এই ডেটার মধ্যে ব্যবহারকারীর নাম, আইডি, শহর, প্রিয় ফুটবল দল, পছন্দের সংবাদ বিভাগ বা আপনার ব্যবহারকারীদের সম্পর্কে অন্য কোনো প্রাসঙ্গিক তথ্য অন্তর্ভুক্ত থাকতে পারে।

কোন ট্যাগ ব্যবহার করবেন তা নির্ধারণ করা

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

ট্যাগের মান

ট্যাগের মানগুলি আপনার পুশ ক্যাম্পেইনগুলিকে আরও স্মার্ট করতে সাহায্য করতে পারে। প্রতিটি ট্যাগ প্রায় সীমাহীন সংখ্যক মান সংরক্ষণ করতে পারে। মূলত, এর মানে হলো আপনার ডাটাবেসের প্রতিটি শেষ-ব্যবহারকারীর সম্পর্কে একটি নির্দিষ্ট ধরণের তথ্য রেকর্ড করার জন্য একটি ট্যাগই যথেষ্ট।

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

ট্যাগের প্রকারভেদ

Integer — পূর্ণসংখ্যার ডেটার জন্য ব্যবহৃত হয় (ইন-গেম ক্যাশের পরিমাণ, অর্জিত লেভেল, বয়স)।
String — স্ট্রিং মানের জন্য ব্যবহৃত হয় (ব্যবহারকারীর নাম, ই-মেইল, শনাক্তকারী)।
List — স্ট্রিং টাইপের মতোই, কিন্তু প্রতিটি ব্যবহারকারী একই সাথে একাধিক মান সেট করতে পারে (সংগীত পছন্দ, সংবাদ বিভাগ, খাবারের পছন্দ)।
Boolean — true / false ধরনের ট্যাগ।
Date — ক্যালেন্ডারের তারিখের জন্য ব্যবহৃত হয়। মূলত, এটি একটি পূর্ণসংখ্যা টাইপ ট্যাগ যা ইউনিক্স এপোক টাইমস্ট্যাম্প সংরক্ষণ করে (স্বয়ংক্রিয়ভাবে গ্রেগরিয়ান তারিখ থেকে/এ রূপান্তরিত হয়)।
Price — নির্দিষ্ট মুদ্রার অনুসারে “*.XX” ফরম্যাটে মান সেট করার অনুমতি দেয় আরও জানুন।
Version — ভার্সনিং-এর জন্য ব্যবহৃত হয়। অনুমোদিত বিন্যাসের উদাহরণ হলো w.x.y.z (Major.Minor.Patch.Build)। প্রতিটি সংস্করণ অংশের জন্য সর্বোচ্চ মান ৯৯৯৯, তাই সর্বোচ্চ সংস্করণ সংখ্যা ৯৯৯৯.৯৯৯৯.৯৯৯৯.৯৯৯৯ এর বেশি হতে পারে না।

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

প্রতিটি ট্যাগ প্রকারের জন্য নির্দিষ্ট কিছু অপারেটর প্রযোজ্য। ট্যাগ অপারেটরগুলি বিভাজনের উদ্দেশ্যে ট্যাগ এবং তার মানগুলির মধ্যে সম্পর্ক নির্ধারণ করে।

Integer ট্যাগ অপারেটর: is, is not, are, not in, not set, any
String ট্যাগ অপারেটর: is, is not, are, not in, not set, any
List ট্যাগ অপারেটর: in, not in, not set, any
Boolean ট্যাগ অপারেটর: is (true/false), not set, any
Date ট্যাগ অপারেটর: exactly on, on or after, on or before, between, not set, any
Price ট্যাগ অপারেটর: is, is not, greater or equals, less or equals, between, in, not in, not set, any
Version ট্যাগ অপারেটর: is, is not, greater or equals, less or equals, between, in, not in, not set, any

ট্যাগের পরিধি: সাধারণ বনাম ব্যবহারকারী-নির্দিষ্ট

একটি ট্যাগ তৈরি করার সময়, আপনি বেছে নেন এর মানগুলি কীভাবে সংরক্ষণ করা হবে:

General (ডিফল্ট, user_specific: false): ট্যাগের মান প্রতি ডিভাইস (HWID) অনুযায়ী সংরক্ষণ করা হয়। একই ব্যবহারকারীর প্রতিটি ডিভাইস স্বাধীনভাবে একটি ভিন্ন মান ধারণ করতে পারে।
User-specific (user_specific: true): ট্যাগের মান প্রতি ব্যবহারকারী (UserID) অনুযায়ী সংরক্ষণ করা হয়। UserID এর মাধ্যমে সেট করা হলে, মানটি ব্যবহারকারীর সমস্ত ডিভাইসে একবারে প্রয়োগ করা হয়। এটি সেইসব বৈশিষ্ট্যের জন্য উপযোগী যা ব্যক্তির সাথে সম্পর্কিত, কোনো নির্দিষ্ট ডিভাইসের সাথে নয়: সাবস্ক্রিপশন স্তর, লয়ালটি পয়েন্ট, পছন্দের ভাষা।

উদাহরণ

একজন ব্যবহারকারীর কাছে আপনার অ্যাপের iOS এবং Android উভয় সংস্করণই ইনস্টল করা আছে। তাদের UserID এর মাধ্যমে একটি subscription_tier ট্যাগকে "premium" এ সেট করলে তা উভয় ডিভাইসে অবিলম্বে প্রয়োগ হয়। একটি General ট্যাগের ক্ষেত্রে আপনাকে এটি প্রতি ডিভাইসে আলাদাভাবে সেট করতে হতো।

{
   "request":{
      "application": "XXXXX-XXXXX",
      "userId": "the id of a specific user",
      "tags": {
           "subscription_tier": "premium",
           "loyalty_points": 350
      }
   }
}

ডিফল্ট ট্যাগ

এই ট্যাগগুলি Pushwoosh দ্বারা আগে থেকেই উপলব্ধ, তাই আপনাকে এগুলি ম্যানুয়ালি সেট করতে হবে না (এবং, আসলে, করা উচিতও নয়)। এর বেশিরভাগই অ্যাপ্লিকেশন থেকে সেট করা হয় এবং আমাদের সার্ভারে registerDevice এবং অন্যান্য API কলের মাধ্যমে পাঠানো হয়, এবং কিছু সার্ভার নিজেই সেট করে।

নাম	প্রকার	কোথায় সেট হয়	বর্ণনা
Application Version	Version	SDK	একটি ডিভাইসে ইনস্টল করা অ্যাপের বর্তমান সংস্করণ
Browser Type	String	SDK	যখন একটি ডিভাইস আপনার ওয়েব প্রকল্পের জন্য নিবন্ধিত হয়, তখন তার প্রকার - মোবাইল বা ডেস্কটপ - স্বয়ংক্রিয়ভাবে ট্র্যাক করা হয়
City	String	সার্ভার	একটি ডিভাইসের সর্বশেষ নিবন্ধিত ভৌগোলিক অবস্থান
Country	String	সার্ভার	একটি ডিভাইসের সর্বশেষ নিবন্ধিত ভৌগোলিক অবস্থান
Device Model	String	SDK	অ্যাপটি যে ডিভাইস মডেলে ইনস্টল করা আছে তা নির্দেশ করে
First Install	Date	সার্ভার	একটি ডিভাইস প্রথমবারের জন্য নোটিফিকেশনের জন্য নিবন্ধিত হওয়ার সময় নির্দেশ করে
In-App Product	List	SDK	অ্যাপের একজন ব্যবহারকারীর দ্বারা কেনা ইন-অ্যাপ পণ্য
Last In-App Purchase Date	Date	SDK	একটি ডিভাইসে করা সর্বশেষ ইন-অ্যাপ কেনাকাটার তারিখ
Language	String	SDK	ISO-639-1 অনুযায়ী একটি ডিভাইসের লোকালের দুই-অক্ষরের ছোট হাতের সংক্ষিপ্ত রূপ; ডিভাইস সেটিংস থেকে নেওয়া
Last Application Open	Date	সার্ভার	একটি ডিভাইসে সবচেয়ে সাম্প্রতিক অ্যাপ লঞ্চের সময়
OS Version	Version	SDK	একটি ডিভাইসে চলমান অপারেটিং সিস্টেমের সংস্করণ
Platform	String	SDK	যে প্ল্যাটফর্মে ব্যবহারকারী আপনার প্রকল্পটি ব্যবহার করছেন।
Push Alerts Enabled	Boolean	SDK	ডিভাইস সেটিংসে পুশ সতর্কতা অনুমোদিত কিনা তা নির্দেশ করে
SDK Version	Version	SDK	একটি ডিভাইসে প্রয়োগ করা Pushwoosh SDK-এর সংস্করণ
Unsubscribed Emails	Boolean	SDK	একজন ব্যবহারকারী আপনার অ্যাপ থেকে ইমেল গ্রহণ থেকে আনসাবস্ক্রাইব করেছেন কিনা তা নির্দেশ করে

কাস্টম ট্যাগ

এখানে আপনার নির্দিষ্ট ব্যবসায়িক লক্ষ্য অর্জনের জন্য আপনার সৃজনশীলতা কাজে আসে। আপনার অনন্য ব্যবসায়িক প্রয়োজনের জন্য উপযুক্ত বিভাজন যুক্তি বা টার্গেটিং প্যাটার্নের উপর ভিত্তি করে কাস্টম ট্যাগ তৈরি করা যেতে পারে। আপনার প্রচারণার জন্য প্রয়োজনীয় অতিরিক্ত কাস্টম ট্যাগগুলি সংজ্ঞায়িত করতে আপনার বিপণন দলের সাথে সহযোগিতা করুন।

কীভাবে একটি কাস্টম ট্যাগ সেট আপ করবেন

আপনি Pushwoosh কন্ট্রোল প্যানেলে একটি নতুন ট্যাগ যোগ করতে পারেন অথবা /addTag পদ্ধতি ব্যবহার করতে পারেন।

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

আপনার অ্যাকাউন্টে একটি ট্যাগ তৈরি করে।

অনুরোধের বডি

নাম	প্রকার	বর্ণনা
auth*	string	Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
tag*	object	ট্যাগ প্যারামিটার।
tag.name*	string	ট্যাগের নাম।
tag.type*	integer	ট্যাগের প্রকার। নীচে সম্ভাব্য মানগুলি দেখুন।
tag.user_specific	boolean	যখন `true`, ট্যাগের মান ব্যবহারকারী স্তরে সংরক্ষণ করা হয় এবং UserID দ্বারা সেট করা হলে ব্যবহারকারীর সমস্ত ডিভাইসে শেয়ার করা হয়। যখন `false` (ডিফল্ট), ট্যাগটি ডিভাইস-স্তরের এবং প্রতি HWID সেট করা হয়।

{
    "status_code": 200,
    "status_message": "OK",
    "response": {
        "result": true
    }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required, Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
    "tag": {
      "name": "TAG_NAME",    // required
      "type": 1,             // required, নীচে সম্ভাব্য মানগুলি দেখুন
      "user_specific": false // optional. true = ব্যবহারকারী-স্তর; false = ডিভাইস-স্তর (ডিফল্ট)
    }
  }
}

সম্ভাব্য ট্যাগ মান প্রকার:

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. যেমন: 19.95
7 - Version. যেমন: “1.0.0.0”

ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ করার উপায়

একবার আপনি একটি ট্যাগ যোগ এবং কনফিগার করার পরে, এটি আপনার ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ শুরু করার জন্য প্রস্তুত। এটি বাস্তবায়ন করতে এই পদক্ষেপগুলি অনুসরণ করুন:

প্রাসঙ্গিক ইন্টিগ্রেশন গাইড অনুসরণ করে আপনার প্রকল্পে Pushwoosh SDK সংহত করুন।
ট্যাগ নির্ধারণ এবং ব্যবহারকারীর ডেটা সংগ্রহ করতে setTags ফাংশনটি ব্যবহার করুন।

নীচে setTags ফাংশন ব্যবহার করে বিভিন্ন ফ্রেমওয়ার্কের জন্য বাস্তবায়নের উদাহরণ দেওয়া হলো।

iOS Native

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};

[[PushNotificationManager pushManager] setTags:tags];

ডকুমেন্টেশন

Android Native

pushwoosh.setTags(Tags.intTag("intTag", 42));

ডকুমেন্টেশন

Cordova

PushNotification.prototype.setTags = function(  config, success, fail  )

ডকুমেন্টেশন

Flutter

Future<void> setTags(Map tags) async {
  await _channel.invokeMethod("setTags", {"tags" : tags});
}

ডকুমেন্টেশন

React Native

pushNotification.setTags({
    "string_tag" : "Hello world",
    "int_tag" : 42,
    "list_tag":["hello", "world"]
});

ডকুমেন্টেশন

Unity

SetIntTag

ডিভাইসের জন্য একটি Integer ট্যাগ সেট করে।

public virtual void SetIntTag(string tagName, int tagValue)

SetStringTag

ডিভাইসের জন্য একটি String ট্যাগ সেট করে।

public virtual void SetStringTag(string tagName, string tagValue)

SetListTag

ডিভাইসের জন্য একটি List ট্যাগ সেট করে।

public virtual void SetListTag(string tagName, List<object> tagValues)

ডকুমেন্টেশন

Unreal Engine

FPushwooshModule& pushwoosh = FPushwooshModule::Get();
pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");

ডকুমেন্টেশন

Expo

Pushwoosh.setTags({ "key": keyValue, "value": inputValue });

ডকুমেন্টেশন

.NET MAUI

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};
[[PushNotificationManager pushManager] setTags:tags];

ডকুমেন্টেশন

Outsystems

ইনপুট প্যারামিটার Tags – TagName এবং TagValue ধারণকারী ট্যাগ রেকর্ডের একটি তালিকা।

TagName অবশ্যই সর্বদা Text টাইপের হতে হবে।
TagValue হতে পারে Text, Integer, Boolean, Date, ইত্যাদি।

আরও জানুন

API এর মাধ্যমে ট্যাগ সেট করা

যদিও বেশিরভাগ ক্ষেত্রে (৯৯%), ট্যাগগুলি অ্যাপ্লিকেশন থেকে সেট করা হয়, আপনি Pushwoosh API এর মাধ্যমেও ট্যাগ সেট করতে পারেন। নীচে /setTags এন্ডপয়েন্টে একটি সাধারণ অনুরোধের উদাহরণ দেওয়া হলো:

POST https://api.pushwoosh.com/json/1.3/setTags

{
   "request": {
      "application": "XXXXX-XXXXX", // required, Pushwoosh অ্যাপ্লিকেশন কোড
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, /registerDevice API-তে ব্যবহৃত হার্ডওয়্যার ডিভাইস আইডি
      "tags": { // required
           "StringTag": "string value", // একটি স্ট্রিং ট্যাগের উদাহরণ
           "IntegerTag": 42, // একটি পূর্ণসংখ্যা ট্যাগের উদাহরণ
           "ListTag": ["string1", "string2"], // একটি তালিকা ট্যাগের উদাহরণ
           "DateTag": "2024-10-02 22:11", // দ্রষ্টব্য: সময় অবশ্যই UTC-তে হতে হবে
           "BooleanTag": true // বৈধ মান: true, false
      }
   }
}

আরও বিস্তারিত তথ্যের জন্য, setTags API ডকুমেন্টেশন দেখুন

ডিফল্ট City ট্যাগ ব্যবহার করা

ডিভাইসের অবস্থান তার IP ঠিকানার উপর ভিত্তি করে নির্ধারিত হয়, যখন আপনার অ্যাপটি সেই ডিভাইসে শেষবার চালু হয়েছিল। GeoIP অবস্থান ডেটা Pushwoosh-এ জমা দেয়, এবং Pushwoosh GeoIP থেকে প্রাপ্ত অবস্থানটি একটি নির্দিষ্ট ডিভাইসের জন্য City ট্যাগের মান হিসাবে সংরক্ষণ করে।

কিছু ক্ষেত্রে, GeoIP দ্বারা জমা দেওয়া অবস্থানটি শহরের নাম থেকে ভিন্ন হয় — উদাহরণস্বরূপ, যখন এটি একটি শহরের কোনো এলাকা বা অন্য কোনো প্রশাসনিক ইউনিটকে বোঝায়। বিভাজনের উদ্দেশ্যে ডিফল্ট City ট্যাগ ব্যবহার করার সময় দয়া করে সতর্ক থাকুন: নিশ্চিত করুন যে আপনি সঠিক মানগুলি নির্বাচন করেছেন।

উদাহরণস্বরূপ, যদি আপনি মিউনিখের ব্যবহারকারীদের লক্ষ্য করতে যাচ্ছেন, তবে আপনাকে এটি কয়েকটি City ট্যাগের মান দিয়ে কভার করতে হবে, যার মধ্যে “Munich” নিজেও অন্তর্ভুক্ত (এর সাথে সম্পর্কিত সমস্ত মান, যেমন বানানের বিভিন্ন রূপ যা GeoIP দ্বারা ফেরত দেওয়া হতে পারে এবং ট্যাগের মান হিসাবে সংরক্ষিত হতে পারে) এবং কাছাকাছি কয়েকটি এলাকা।