टैग्स

टैग्स Pushwoosh द्वारा प्रदान किए जाने वाले सबसे उपयोगी उपकरणों में से एक हैं, जो कई परिष्कृत कार्यात्मकताओं को सक्षम करते हैं। टैग्स का उपयोग करके, आप अपने दर्शकों को विभाजित कर सकते हैं और उनके गुणों के आधार पर विशिष्ट उपयोगकर्ताओं को लक्षित पुश सूचनाएं भेज सकते हैं।

टैग्स में किसी विशेष उपयोगकर्ता या डिवाइस से जुड़ा कोई भी मनमाना डेटा हो सकता है। इस डेटा में उपयोगकर्ता नाम, आईडी, शहर, पसंदीदा फुटबॉल टीमें, पसंदीदा समाचार श्रेणियां, या आपके उपयोगकर्ताओं के बारे में कोई अन्य प्रासंगिक जानकारी शामिल हो सकती है।

यह तय करना कि कौन से टैग्स का उपयोग करें

अपनी व्यावसायिक आवश्यकताओं की पहचान करके और यह निर्धारित करके शुरू करें कि आप अपने दर्शकों को कैसे विभाजित करना चाहते हैं। उपयोगकर्ताओं को लक्षित करने के लिए आयु, स्थान, इन-ऐप खरीदारी इतिहास, या किसी अन्य प्रासंगिक मानदंड जैसे कारकों पर विचार करें।

टैग मान

टैग मान आपके पुश अभियानों को और स्मार्ट बनाने में मदद कर सकते हैं। प्रत्येक टैग लगभग असीमित संख्या में मान संग्रहीत करने में सक्षम है। मूल रूप से, इसका मतलब है कि आपके डेटाबेस में प्रत्येक अंतिम-उपयोगकर्ता के बारे में एक विशिष्ट प्रकार की जानकारी रिकॉर्ड करने के लिए एक टैग पर्याप्त होगा।

प्रत्येक खाते के लिए केवल कुछ ही टैग उपलब्ध हैं, लेकिन प्रत्येक टैग के लिए लगभग-अनंत स्थान को ध्यान में रखते हुए, केवल कुछ टैग ही आपके उपयोगकर्ताओं के बारे में भारी मात्रा में जानकारी इकट्ठा करने और बहुत जटिल लक्ष्यीकरण पैटर्न स्थापित करने के लिए पर्याप्त हैं।

टैग्स के प्रकार

Integer — पूर्णांक डेटा के लिए उपयोग किया जाता है (इन-गेम कैश की राशि, प्राप्त स्तर, आयु)।
String — स्ट्रिंग मानों के लिए उपयोग किया जाता है (उपयोगकर्ता नाम, ई-मेल, पहचानकर्ता)।
List — स्ट्रिंग प्रकार के समान, लेकिन प्रत्येक उपयोगकर्ता के पास एक साथ कई मान सेट हो सकते हैं (संगीत वरीयताएँ, समाचार श्रेणियाँ, भोजन वरीयताएँ)।
Boolean — सही / गलत प्रकार का टैग।
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	सर्वर	एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
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 Control Panel में एक नया टैग जोड़ सकते हैं या /addTag विधि का उपयोग कर सकते हैं।

addTag

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

आपके खाते में एक टैग बनाता है।

रिक्वेस्ट बॉडी

नाम	प्रकार	विवरण
auth*	string	Pushwoosh Control Panel से 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 के माध्यम से टैग सेट करना

जबकि अधिकांश मामलों (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 टैग का उपयोग करते समय कृपया सावधान रहें: सुनिश्चित करें कि आप उचित मानों का चयन करते हैं।

उदाहरण के लिए, यदि आप म्यूनिख के उपयोगकर्ताओं को लक्षित करने जा रहे हैं, तो आपको इसे कई City टैग मानों के साथ कवर करना होगा, जिसमें “Munich” स्वयं (सभी संबंधित मानों के साथ, जैसे वर्तनी के विभिन्न प्रकार जो GeoIP द्वारा लौटाए जा सकते हैं और टैग मानों के रूप में सहेजे जा सकते हैं) और कई आस-पास के क्षेत्र शामिल हैं।