ট্যাগ

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

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

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

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

টিপ

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

ট্যাগের মান

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

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

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

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

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

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

• পূর্ণসংখ্যা (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-এর সমস্ত ট্যাগ ডিজাইনগতভাবে ব্যবহারকারী-নির্দিষ্ট এবং UserID দ্বারা সেট করা হলে ব্যবহারকারীর সমস্ত ডিভাইসের জন্য নির্ধারিত হয়, HWID-এর পরিবর্তে।

উদাহরণ

{
   "request":{
      "application": "XXXXX-XXXXX", // Pushwoosh অ্যাপ্লিকেশন কোড
      "userId": "the id of a specific user",
      "tags": {
           "UserSpecificStringTag": "string value",
           "UserSpecificIntegerTag": 42
      }
   }
}

ডিফল্ট ট্যাগ

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

Name	Type	Where it’s set	বিবরণ
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

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

রিকোয়েস্ট বডি

Name	Type	বিবরণ
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", // আবশ্যক, Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
    "tag": {
      "name": "TAG_NAME", // আবশ্যক
      "type": 1, // আবশ্যক, নিচে সম্ভাব্য মানগুলো দেখুন
      "application_specific": true, // অথবা 'false', ঐচ্ছিক। ট্যাগের মান একাধিক অ্যাপের জন্য ভিন্ন হবে নাকি একই থাকবে তা নির্ধারণ করে
      "user_specific": true // অথবা 'false', ঐচ্ছিক, application_specific ট্যাগের জন্য ব্যবহৃত
    }
  }
}

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

• ১ - পূর্ণসংখ্যা (Integer)
• ২ - স্ট্রিং (String)
• ৩ - তালিকা (List)
• ৪ - তারিখ (Date)
• ৫ - বুলিয়ান (Boolean)
• ৬ - দশমিক (Decimal)। যেমন: ১৯.৯৫
• ৭ - সংস্করণ (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", // আবশ্যক, Pushwoosh অ্যাপ্লিকেশন কোড
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // আবশ্যক, /registerDevice API-তে ব্যবহৃত হার্ডওয়্যার ডিভাইস আইডি
      "tags": { // আবশ্যক
           "StringTag": "string value", // একটি স্ট্রিং ট্যাগের উদাহরণ
           "IntegerTag": 42, // একটি পূর্ণসংখ্যা ট্যাগের উদাহরণ
           "ListTag": ["string1", "string2"], // একটি তালিকা ট্যাগের উদাহরণ
           "DateTag": "2024-10-02 22:11", // দ্রষ্টব্য: সময় অবশ্যই UTC-তে হতে হবে
           "BooleanTag": true // বৈধ মান: true, false
      }
   }
}

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

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

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

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

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

টিপ

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