टैग्स

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

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

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

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

टैग मान

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

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

पूर्णांक (Integer) — पूर्णांक डेटा के लिए उपयोग किया जाता है (इन-गेम कैश की राशि, प्राप्त स्तर, आयु)।
स्ट्रिंग (String) — स्ट्रिंग मानों के लिए उपयोग किया जाता है (उपयोगकर्ता नाम, ई-मेल, पहचानकर्ता)।
सूची (List) — स्ट्रिंग प्रकार के समान, लेकिन प्रत्येक उपयोगकर्ता के पास एक साथ कई मान सेट हो सकते हैं (संगीत प्राथमिकताएं, समाचार श्रेणियां, भोजन प्राथमिकताएं)।
बूलियन (Boolean) — सही / गलत प्रकार का टैग।
दिनांक (Date) — कैलेंडर तिथियों के लिए उपयोग किया जाता है। मूल रूप से, यह एक पूर्णांक प्रकार का टैग है जो यूनिक्स एपोक टाइमस्टैम्प संग्रहीत करता है (स्वचालित रूप से ग्रेगोरियन तिथि से/में परिवर्तित)।
मूल्य (Price) — “*.XX” प्रारूप में निर्दिष्ट मुद्रा के अनुसार मान सेट करने की अनुमति देता है और जानें।
संस्करण (Version) — संस्करण के लिए उपयोग किया जाता है। अनुमत प्रारूप का उदाहरण w.x.y.z (Major.Minor.Patch.Build) है। प्रत्येक संस्करण भाग के लिए अधिकतम मान 9999 है, इसलिए अधिकतम संस्करण संख्या 9999.9999.9999.9999 से अधिक नहीं हो सकती है।

टैग ऑपरेटर

प्रत्येक टैग प्रकार में लागू होने वाले ऑपरेटरों का एक विशिष्ट सेट होता है। टैग ऑपरेटर विभाजन उद्देश्यों के लिए टैग और उसके मानों के बीच संबंध को परिभाषित करते हैं।

पूर्णांक टैग ऑपरेटर: is, is not, are, not in, not set, any
स्ट्रिंग टैग ऑपरेटर: is, is not, are, not in, not set, any
सूची टैग ऑपरेटर: in, not in, not set, any
बूलियन टैग ऑपरेटर: is (सही/गलत), not set, any
दिनांक टैग ऑपरेटर: exactly on, on or after, on or before, between, not set, any
मूल्य टैग ऑपरेटर: is, is not, greater or equals, less or equals, between, in, not in, not set, any
संस्करण टैग ऑपरेटर: 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 कॉल्स के माध्यम से भेजे जाते हैं, और कुछ सर्वर द्वारा ही सेट किए जाते हैं।

नाम	प्रकार	कहाँ सेट होता है	विवरण
एप्लिकेशन संस्करण	संस्करण	SDK	एक डिवाइस पर स्थापित ऐप का वर्तमान संस्करण
ब्राउज़र प्रकार	स्ट्रिंग	SDK	जब कोई डिवाइस आपके वेब प्रोजेक्ट के लिए पंजीकृत होता है, तो उसका प्रकार - मोबाइल या डेस्कटॉप - स्वचालित रूप से ट्रैक किया जाता है
शहर	स्ट्रिंग	सर्वर	एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
देश	स्ट्रिंग	सर्वर	एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
डिवाइस मॉडल	स्ट्रिंग	SDK	उस डिवाइस मॉडल को इंगित करता है जिस पर ऐप इंस्टॉल है
पहली स्थापना	दिनांक	सर्वर	उस समय को इंगित करता है जब किसी डिवाइस को पहली बार सूचनाओं के लिए पंजीकृत किया गया था
इन-ऐप उत्पाद	सूची	SDK	ऐप के उपयोगकर्ता द्वारा खरीदे गए इन-ऐप उत्पाद
अंतिम इन-ऐप खरीद की तारीख	दिनांक	SDK	किसी डिवाइस पर की गई नवीनतम इन-ऐप खरीद की तारीख
भाषा	स्ट्रिंग	SDK	ISO-639-1 के अनुसार डिवाइस के लोकेल का दो-अक्षर का लोअरकेस संक्षिप्त नाम; डिवाइस सेटिंग्स से लिया गया
अंतिम एप्लिकेशन खोलने का समय	दिनांक	सर्वर	किसी डिवाइस पर सबसे हालिया ऐप लॉन्च का समय
अंतिम ईमेल खोलने की तारीख	दिनांक	सर्वर	वह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल खोलने की घटना दर्ज की
अंतिम ईमेल खोलने का संदेश कोड	स्ट्रिंग	सर्वर	हाल ही में खोले गए ईमेल का संदेश कोड (प्रारूप `XXXX-XXXXXXXX-XXXXXXXX`)। प्रत्येक `PW_EmailOpen` घटना पर अपडेट किया गया। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने इसे खोला
अंतिम ईमेल क्लिक की तारीख	दिनांक	सर्वर	वह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल लिंक क्लिक दर्ज किया
अंतिम ईमेल क्लिक का संदेश कोड	स्ट्रिंग	सर्वर	सबसे हालिया ईमेल का संदेश कोड जिसमें एक लिंक पर क्लिक किया गया था (प्रारूप `XXXX-XXXXXXXX-XXXXXXXX`)। प्रत्येक `PW_EmailLinkClicked` घटना पर अपडेट किया गया। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने क्लिक किया
अंतिम ईमेल पुष्टि की तारीख	दिनांक	सर्वर	डिवाइस के ईमेल पते के लिए सबसे हालिया डबल ऑप्ट-इन सदस्यता पुष्टि की तारीख
बाउंस हुआ ईमेल	दिनांक	सर्वर	वह तारीख जब इस ईमेल पते के लिए एक हार्ड बाउंस हुआ। समय-आधारित विभाजन को सक्षम करने के लिए दिनांक के रूप में संग्रहीत, उदाहरण के लिए, हाल के बाउंस वाले उपयोगकर्ताओं को बाहर करने के लिए
अनसब्सक्राइब किए गए ईमेल	बूलियन	SDK	इंगित करता है कि क्या किसी उपयोगकर्ता ने आपके ऐप से ईमेल प्राप्त करने से अनसब्सक्राइब किया है
ओएस संस्करण	संस्करण	SDK	किसी डिवाइस पर चल रहे ऑपरेटिंग सिस्टम का संस्करण
प्लेटफॉर्म	स्ट्रिंग	SDK	वह प्लेटफॉर्म जिस पर उपयोगकर्ता आपके प्रोजेक्ट का उपयोग कर रहा है।
पुश अलर्ट सक्षम	बूलियन	SDK	इंगित करता है कि क्या डिवाइस सेटिंग्स में पुश अलर्ट की अनुमति है
SDK संस्करण	संस्करण	SDK	किसी डिवाइस पर लागू Pushwoosh SDK का संस्करण

कस्टम टैग्स

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

कस्टम टैग कैसे सेट करें

पहले से टैग बनाना वैकल्पिक है। setTags के माध्यम से एक नया टैग नाम भेजने से यह स्वचालित रूप से बन जाता है, और इसका प्रकार मान से अनुमान लगाया जाता है। एक पूर्ण संख्या Integer बन जाती है, दशमलव बिंदु वाली संख्या Price बन जाती है, एक स्ट्रिंग String बन जाती है (या Date, एक मान्यता प्राप्त दिनांक-समय प्रारूप जैसे 2024-10-02 22:11 के लिए), एक ऐरे List बन जाता है, और एक बूलियन Boolean बन जाता है। एक Version टैग के लिए, या एक उपयोगकर्ता-विशिष्ट टैग के लिए, टैग को पहले कंट्रोल पैनल या /addTag के माध्यम से स्पष्ट रूप से जोड़ें, क्योंकि ऑटो-डिटेक्शन इसका अनुमान नहीं लगा सकता है। टैग ऑटो-क्रिएशन अधिकांश खातों के लिए डिफ़ॉल्ट रूप से सक्षम है। यदि setTags अपेक्षा के अनुरूप एक नया टैग नहीं बनाता है, तो यह जांचने के लिए Pushwoosh Support से संपर्क करें कि क्या यह आपके खाते के लिए बंद कर दिया गया है।

आप 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", // आवश्यक, Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "tag": {
      "name": "TAG_NAME",    // आवश्यक
      "type": 1,             // आवश्यक, नीचे संभावित मान देखें
      "user_specific": false // वैकल्पिक। true = उपयोगकर्ता-स्तरीय; false = डिवाइस-स्तरीय (डिफ़ॉल्ट)
    }
  }
}

संभावित टैग मान प्रकार:

1 - पूर्णांक
2 - स्ट्रिंग
3 - सूची
4 - दिनांक
5 - बूलियन
6 - दशमलव। उदाहरण: 19.95
7 - संस्करण। उदाहरण: “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

इनपुट पैरामीटर टैग्स – TagName और TagValue युक्त टैग रिकॉर्ड की एक सूची।

TagName हमेशा टेक्स्ट प्रकार का होना चाहिए।
TagValue टेक्स्ट, पूर्णांक, बूलियन, दिनांक, आदि हो सकता है।

और जानें

API के माध्यम से टैग्स सेट करना

हालांकि अधिकांश मामलों (99%) में, टैग्स एप्लिकेशन से सेट किए जाते हैं, आप 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 प्रलेखन देखें

एक टैग नाम जो अभी तक मौजूद नहीं है, पहली बार setTags भेजने पर स्वचालित रूप से बन जाता है, और इसका प्रकार मान से अनुमान लगाया जाता है: एक पूर्ण संख्या Integer बन जाती है, दशमलव बिंदु वाली संख्या Price बन जाती है, एक स्ट्रिंग String बन जाती है (या Date, एक मान्यता प्राप्त दिनांक-समय प्रारूप जैसे 2024-10-02 22:11 के लिए), एक ऐरे List बन जाता है, और एक बूलियन Boolean बन जाता है। एक Version टैग को पहले स्पष्ट रूप से बनाएं, कंट्रोल पैनल या /addTag के माध्यम से, क्योंकि ऑटो-क्रिएशन इसका अनुमान नहीं लगा सकता है। टैग ऑटो-क्रिएशन अधिकांश खातों के लिए डिफ़ॉल्ट रूप से सक्षम है। यदि setTags अपेक्षा के अनुरूप एक नया टैग नहीं बनाता है, तो यह जांचने के लिए Pushwoosh Support से संपर्क करें कि क्या यह आपके खाते के लिए बंद कर दिया गया है।

डिफ़ॉल्ट City टैग का उपयोग करना

डिवाइस का स्थान उसके IP पते के आधार पर निर्धारित किया जाता है, जब आपके ऐप को उस डिवाइस पर आखिरी बार लॉन्च किया गया था। GeoIP स्थान डेटा Pushwoosh को सबमिट करता है, और Pushwoosh GeoIP से प्राप्त स्थान को एक विशेष डिवाइस के लिए City टैग मान के रूप में सहेजता है।

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

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