ট্যাগ

ট্যাগ হলো 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

নোট

“Not set” এবং “any” অপারেটরগুলো সব ধরনের ট্যাগের জন্য উপলব্ধ।

অ্যাপ্লিকেশন নির্দিষ্ট / অনির্দিষ্ট ট্যাগ

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

উদাহরণ

ধরুন আপনার দুটি অ্যাপ আছে, একটি নিউজ অ্যাপ এবং একটি গেম, এবং আপনি শুধুমাত্র সেই ব্যবহারকারীদের লক্ষ্য করতে চান যারা আপনার কাছ থেকে পুশ পেতে স্পষ্টভাবে সম্মত হয়েছেন। তাই, আপনি “Subscribed” নামে একটি বুলিয়ান ট্যাগ তৈরি করেছেন এবং যারা আপনার কাছ থেকে পুশ পেতে চান তাদের জন্য "true" মান সেট করেছেন, এবং যারা বিজ্ঞপ্তি পেতে চান না তাদের জন্য "false" সেট করেছেন।

আপনার একজন ব্যবহারকারী, আনা, আপনার দুটি অ্যাপই ইনস্টল করেছেন। তিনি কিছু ব্রেকিং নিউজ সম্পর্কে বিজ্ঞপ্তি পেতে রাজি, কিন্তু গেম অ্যাপ থেকে কোনো পুশ পেতে চান না।

যদি “Subscribed” ট্যাগটি অ্যাপ্লিকেশন নির্দিষ্ট হয়, তবে সবকিছু পরিকল্পনা অনুযায়ী চলবে। তবে, যদি এই ট্যাগটি অ্যাপ্লিকেশন অনির্দিষ্ট হতো, তবে আপনার প্রতিটি অ্যাপ অন্য অ্যাপ দ্বারা সেট করা মানটি ওভাররাইট করবে, যা আপনার টার্গেটিং নষ্ট করতে পারে এবং বিরক্তির কারণ হতে পারে।

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

ব্যবহারকারী-নির্দিষ্ট ট্যাগ

Pushwoosh-এর সমস্ত ট্যাগ ডিজাইনগতভাবে ব্যবহারকারী-নির্দিষ্ট এবং HWID-এর পরিবর্তে UserID দ্বারা সেট করা হলে ব্যবহারকারীর সমস্ত ডিভাইসের জন্য নির্ধারিত হয়।

উদাহরণ

{
   "request":{
      "application": "XXXXX-XXXXX", // Pushwoosh application code
      "userId": "the id of a specific user",
      "tags": {
           "UserSpecificStringTag": "string value",
           "UserSpecificIntegerTag": 42
      }
   }
}

ডিফল্ট ট্যাগ

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

নাম (Name)	প্রকার (Type)	কোথায় সেট করা হয় (Where it’s set)	বিবরণ (Description)
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	একটি ডিভাইসে সবচেয়ে সাম্প্রতিক অ্যাপ লঞ্চের সময়।
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

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

অনুরোধের অংশ (Request Body)

নাম (Name)	প্রকার (Type)	বিবরণ (Description)
auth*	string	Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
tag*	object	ট্যাগের প্যারামিটার।
tag.name*	string	ট্যাগের নাম।
tag.type*	integer	ট্যাগের প্রকার। নিচে সম্ভাব্য মান দেখুন।
tag.application_specific	boolean	ট্যাগ মান একাধিক অ্যাপের জন্য ভিন্ন হবে নাকি একাধিক অ্যাপ জুড়ে একই থাকবে তা নির্ধারণ করে।

200

{
    "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
      "application_specific": true, // or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps
      "user_specific": true // or 'false', optional, used for application_specific tags
    }
  }
}

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

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

ব্যবহারকারীদের কাছ থেকে কীভাবে তথ্য সংগ্রহ করবেন

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

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

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

iOS Native

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

Android Native

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

ডকুমেন্টেশন

Cordova

Cordova

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

ডকুমেন্টেশন

Flutter

Flutter

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

ডকুমেন্টেশন

React Native

React Native

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

ডকুমেন্টেশন

Unity

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

Unreal Engine

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

ডকুমেন্টেশন

Expo

Expo

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

ডকুমেন্টেশন

.NET MAUI

.NET MAUI

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

ডকুমেন্টেশন

Outsystems

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 ডকুমেন্টেশন দেখুন

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

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

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

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

টিপ

API-এর মাধ্যমে একটি সেগমেন্ট তৈরি করার আগে, /getTagStats অনুরোধের মাধ্যমে আপনার ব্যবহারকারীদের ডিভাইসে কী মান আছে তা পরীক্ষা করুন।