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

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

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

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

ট্যাগের মান

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

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

Integer — পূর্ণসংখ্যার ডেটার জন্য ব্যবহৃত হয় (গেমে অর্জিত অর্থের পরিমাণ, অর্জিত লেভেল, বয়স)।
String — স্ট্রিং মানের জন্য ব্যবহৃত হয় (ব্যবহারকারীর নাম, ই-মেইল, শনাক্তকারী)।
List — String প্রকারের মতোই, কিন্তু প্রতিটি ব্যবহারকারী একই সাথে একাধিক মান সেট করতে পারে (সংগীতের পছন্দ, খবরের বিভাগ, খাবারের পছন্দ)।
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

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

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

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

উদাহরণ

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

{
   "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	Server	একটি ডিভাইসের সর্বশেষ নিবন্ধিত ভৌগোলিক অবস্থান
Country	String	Server	একটি ডিভাইসের সর্বশেষ নিবন্ধিত ভৌগোলিক অবস্থান
Device Model	String	SDK	অ্যাপটি যে ডিভাইস মডেলে ইনস্টল করা আছে তা নির্দেশ করে
First Install	Date	Server	একটি ডিভাইস প্রথমবার বিজ্ঞপ্তির জন্য নিবন্ধিত হওয়ার সময় নির্দেশ করে
In-App Product	List	SDK	অ্যাপের একজন ব্যবহারকারীর দ্বারা কেনা ইন-অ্যাপ পণ্য
Last In-App Purchase Date	Date	SDK	একটি ডিভাইসে করা সর্বশেষ ইন-অ্যাপ কেনাকাটার তারিখ
Language	String	SDK	ISO-639-1 অনুযায়ী একটি ডিভাইসের লোকালের দুই-অক্ষরের ছোট হাতের সংক্ষিপ্ত রূপ; ডিভাইসের সেটিংস থেকে নেওয়া
Last Application Open	Date	Server	একটি ডিভাইসে সবচেয়ে সাম্প্রতিক অ্যাপ লঞ্চের সময়
Last Email Open	Date	Server	ডিভাইসের ইমেল ঠিকানা সবচেয়ে সম্প্রতি একটি ইমেল খোলার ইভেন্ট নিবন্ধিত করার তারিখ
Last Email Open Message Code	String	Server	সবচেয়ে সম্প্রতি খোলা ইমেলের মেসেজ কোড (ফরম্যাট `XXXX-XXXXXXXX-XXXXXXXX`)। প্রতিটি `PW_EmailOpen` ইভেন্টে আপডেট করা হয়। এটি ব্যবহার করে একটি নির্দিষ্ট ইমেল ক্যাম্পেইনের প্রাপকদের মধ্যে যারা এটি খুলেছে তাদের সেগমেন্ট করুন
Last Email Click	Date	Server	ডিভাইসের ইমেল ঠিকানা সবচেয়ে সম্প্রতি একটি ইমেল লিঙ্ক ক্লিকের ইভেন্ট নিবন্ধিত করার তারিখ
Last Email Click Message Code	String	Server	সবচেয়ে সাম্প্রতিক ইমেল যেখানে একটি লিঙ্ক ক্লিক করা হয়েছিল তার মেসেজ কোড (ফরম্যাট `XXXX-XXXXXXXX-XXXXXXXX`)। প্রতিটি `PW_EmailLinkClicked` ইভেন্টে আপডেট করা হয়। এটি ব্যবহার করে একটি নির্দিষ্ট ইমেল ক্যাম্পেইনের প্রাপকদের মধ্যে যারা ক্লিক করেছে তাদের সেগমেন্ট করুন
Last Email Confirm	Date	Server	ডিভাইসের ইমেল ঠিকানার জন্য সবচেয়ে সাম্প্রতিক ডাবল অপ্ট-ইন সাবস্ক্রিপশন নিশ্চিতকরণের তারিখ
Bounced Email	Date	Server	এই ইমেল ঠিকানার জন্য একটি হার্ড বাউন্স ঘটার তারিখ। সময়-ভিত্তিক সেগমেন্টেশন সক্ষম করার জন্য তারিখ হিসাবে সংরক্ষিত, উদাহরণস্বরূপ, সাম্প্রতিক বাউন্স সহ ব্যবহারকারীদের বাদ দিতে
Unsubscribed Emails	Boolean	SDK	একজন ব্যবহারকারী আপনার অ্যাপ থেকে ইমেল গ্রহণ থেকে আনসাবস্ক্রাইব করেছেন কিনা তা নির্দেশ করে
OS Version	Version	SDK	একটি ডিভাইসে চলমান অপারেটিং সিস্টেমের সংস্করণ
Platform	String	SDK	ব্যবহারকারী যে প্ল্যাটফর্মে আপনার প্রকল্প ব্যবহার করছেন।
Push Alerts Enabled	Boolean	SDK	ডিভাইস সেটিংসে পুশ সতর্কতা অনুমোদিত কিনা তা নির্দেশ করে
SDK Version	Version	SDK	একটি ডিভাইসে বাস্তবায়িত Pushwoosh SDK-এর সংস্করণ

কাস্টম ট্যাগ

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

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

আগে থেকে একটি ট্যাগ তৈরি করা ঐচ্ছিক। setTags এর মাধ্যমে একটি নতুন ট্যাগের নাম পাঠালে এটি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়, এবং মান থেকে এর প্রকার অনুমান করা হয়। একটি পূর্ণসংখ্যা Integer হয়ে যায়, দশমিক বিন্দুসহ একটি সংখ্যা Price হয়ে যায়, একটি স্ট্রিং String হয়ে যায় (অথবা Date, যদি 2024-10-02 22:11-এর মতো স্বীকৃত তারিখ-সময় বিন্যাস হয়), একটি অ্যারে List হয়ে যায়, এবং একটি বুলিয়ান Boolean হয়ে যায়। একটি Version ট্যাগের জন্য, বা একটি ব্যবহারকারী-নির্দিষ্ট ট্যাগের জন্য, ট্যাগটি প্রথমে কন্ট্রোল প্যানেল বা /addTag এর মাধ্যমে স্পষ্টভাবে যোগ করুন, কারণ স্বয়ংক্রিয়-শনাক্তকরণ এটি অনুমান করতে পারে না। ট্যাগ স্বয়ংক্রিয়-তৈরি ডিফল্টরূপে বেশিরভাগ অ্যাকাউন্টের জন্য সক্রিয় থাকে। যদি setTags প্রত্যাশিতভাবে একটি নতুন ট্যাগ তৈরি না করে, তবে এটি আপনার অ্যাকাউন্টের জন্য বন্ধ করা হয়েছে কিনা তা পরীক্ষা করতে Pushwoosh সাপোর্ট এর সাথে যোগাযোগ করুন।

আপনি 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, API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME",    // required
      "type": 1,             // required, see possible values below
      "user_specific": false // optional. true = user-level; false = device-level (default)
    }
  }
}

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

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. Ex: 19.95
7 - Version. Ex: “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 application code
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, hardware device ID used in /registerDevice API
      "tags": { // required
           "StringTag": "string value", // Example of a string tag
           "IntegerTag": 42, // Example of an integer tag
           "ListTag": ["string1", "string2"], // Example of a list tag
           "DateTag": "2024-10-02 22:11", // Note: time must be in UTC
           "BooleanTag": true // Valid values: true, false
      }
   }
}

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

একটি ট্যাগের নাম যা এখনও বিদ্যমান নেই তা setTags প্রথমবার পাঠানোর সময় স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়, এবং মান থেকে এর প্রকার অনুমান করা হয়: একটি পূর্ণসংখ্যা Integer হয়ে যায়, দশমিক বিন্দুসহ একটি সংখ্যা Price হয়ে যায়, একটি স্ট্রিং String হয়ে যায় (অথবা Date, যদি 2024-10-02 22:11-এর মতো স্বীকৃত তারিখ-সময় বিন্যাস হয়), একটি অ্যারে List হয়ে যায়, এবং একটি বুলিয়ান Boolean হয়ে যায়। একটি Version ট্যাগ স্পষ্টভাবে প্রথমে তৈরি করুন, কন্ট্রোল প্যানেল বা /addTag এর মাধ্যমে, কারণ স্বয়ংক্রিয়-তৈরি এটি অনুমান করতে পারে না। ট্যাগ স্বয়ংক্রিয়-তৈরি ডিফল্টরূপে বেশিরভাগ অ্যাকাউন্টের জন্য সক্রিয় থাকে। যদি setTags প্রত্যাশিতভাবে একটি নতুন ট্যাগ তৈরি না করে, তবে এটি আপনার অ্যাকাউন্টের জন্য বন্ধ করা হয়েছে কিনা তা পরীক্ষা করতে Pushwoosh সাপোর্ট এর সাথে যোগাযোগ করুন।

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

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

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

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