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

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

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

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

ট্যাগের মান

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

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

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

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

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

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"-এ সেট করলে তা উভয় ডিভাইসে অবিলম্বে প্রয়োগ হয়। একটি সাধারণ ট্যাগের ক্ষেত্রে আপনাকে এটি প্রতি ডিভাইসে আলাদাভাবে সেট করতে হতো।

{
   "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	সবচেয়ে সম্প্রতি খোলা ইমেলের Message code (ফরম্যাট `XXXX-XXXXXXXX-XXXXXXXX`)। প্রতিটি `PW_EmailOpen` ইভেন্টে আপডেট করা হয়। এটি একটি নির্দিষ্ট ইমেল প্রচারাভিযানের প্রাপকদের মধ্যে কারা এটি খুলেছে তা দ্বারা ভাগ করতে ব্যবহার করুন
Last Email Click	Date	Server	যে তারিখে ডিভাইসের ইমেল ঠিকানাটি সবচেয়ে সম্প্রতি একটি ইমেল লিঙ্ক ক্লিকের নিবন্ধন করেছে
Last Email Click Message Code	String	Server	সবচেয়ে সাম্প্রতিক ইমেলের Message code যেখানে একটি লিঙ্কে ক্লিক করা হয়েছিল (ফরম্যাট `XXXX-XXXXXXXX-XXXXXXXX`)। প্রতিটি `PW_EmailLinkClicked` ইভেন্টে আপডেট করা হয়। এটি একটি নির্দিষ্ট ইমেল প্রচারাভিযানের প্রাপকদের মধ্যে কারা ক্লিক করেছে তা দ্বারা ভাগ করতে ব্যবহার করুন
Last Email Confirm	Date	Server	ডিভাইসের ইমেল ঠিকানার জন্য সবচেয়ে সাম্প্রতিক Double Opt-In সাবস্ক্রিপশন নিশ্চিতকরণের তারিখ
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-এর সংস্করণ

কাস্টম ট্যাগ

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

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

আপনি Pushwoosh Control Panel-এ একটি নতুন ট্যাগ যোগ করতে পারেন অথবা /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. যেমন: 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-এর মাধ্যমে ট্যাগ সেট করা

যদিও বেশিরভাগ ক্ষেত্রে (99%), ট্যাগগুলি অ্যাপ্লিকেশন থেকে সেট করা হয়, আপনি 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 ডকুমেন্টেশন দেখুন

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

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

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

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