टैग 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	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	हाल ही में खोले गए ईमेल का संदेश कोड (प्रारूप `XXXX-XXXXXXXX-XXXXXXXX`)। प्रत्येक `PW_EmailOpen` इवेंट पर अपडेट किया जाता है। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने इसे खोला
Last Email Click	Date	Server	वह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल लिंक क्लिक पंजीकृत किया था
Last Email Click Message Code	String	Server	हाल के ईमेल में संदेश कोड जिसमें एक लिंक पर क्लिक किया गया था (प्रारूप `XXXX-XXXXXXXX-XXXXXXXX`)। प्रत्येक `PW_EmailLinkClicked` इवेंट पर अपडेट किया जाता है। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने क्लिक किया
Last Email Confirm	Date	Server	डिवाइस के ईमेल पते के लिए सबसे हाल के डबल ऑप्ट-इन सदस्यता पुष्टिकरण की तारीख
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 कंट्रोल पैनल में एक नया टैग जोड़ सकते हैं या /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. 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 द्वारा लौटाए जा सकते हैं और टैग मानों के रूप में सहेजे जा सकते हैं) और कई आस-पास के क्षेत्र शामिल हैं।