टैग्स

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

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

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

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

टिप

इस प्रक्रिया में मार्केटिंग टीम को शामिल करने की आवश्यकता हो सकती है ताकि यह तय करने में मदद मिल सके कि कौन से टैग आपके मार्केटिंग लक्ष्यों और दर्शक विभाजन रणनीतियों के साथ सबसे अच्छे से मेल खाते हैं।

टैग मान

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

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

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

• इंटीजर — इंटीजर डेटा (इन-गेम कैश की अर्जित राशि, प्राप्त स्तर, आयु) के लिए उपयोग किया जाता है।
• स्ट्रिंग — स्ट्रिंग मानों (उपयोगकर्ता नाम, ई-मेल, पहचानकर्ता) के लिए उपयोग किया जाता है।
• लिस्ट — स्ट्रिंग प्रकार के समान, लेकिन प्रत्येक उपयोगकर्ता के पास एक साथ कई मान सेट हो सकते हैं (संगीत वरीयताएँ, समाचार श्रेणियां, भोजन वरीयताएँ)।
• बूलियन — ट्रू / फाल्स प्रकार का टैग।
• डेट — कैलेंडर तिथियों के लिए उपयोग किया जाता है। मूल रूप से, यह एक इंटीजर प्रकार का टैग है जो यूनिक्स एपोक टाइमस्टैम्प संग्रहीत करता है (स्वचालित रूप से ग्रेगोरियन तिथि से/में परिवर्तित)।
• प्राइस — “*.XX” प्रारूप में निर्दिष्ट मुद्रा के अनुसार मान सेट करने की अनुमति देता है और जानें।
• वर्जन — वर्जनिंग के लिए उपयोग किया जाता है। अनुमत प्रारूप का उदाहरण w.x.y.z (मेजर.माइनर.पैच.बिल्ड) है। प्रत्येक संस्करण भाग के लिए अधिकतम मान 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

नोट

“Not set” और “any” ऑपरेटर्स सभी प्रकार के टैग्स के लिए उपलब्ध हैं।

टैग स्कोप: सामान्य बनाम उपयोगकर्ता-विशिष्ट

टैग बनाते समय, आप चुनते हैं कि उसके मान कैसे संग्रहीत किए जाते हैं:

• सामान्य (डिफ़ॉल्ट, user_specific: false): टैग मान प्रति डिवाइस (HWID) संग्रहीत किया जाता है। एक ही उपयोगकर्ता के प्रत्येक डिवाइस में स्वतंत्र रूप से एक अलग मान हो सकता है।
• उपयोगकर्ता-विशिष्ट (user_specific: true): टैग मान प्रति उपयोगकर्ता (UserID) संग्रहीत किया जाता है। जब UserID के माध्यम से सेट किया जाता है, तो मान उपयोगकर्ता के सभी डिवाइस पर एक साथ लागू होता है। उन विशेषताओं के लिए उपयोगी है जो व्यक्ति से संबंधित हैं, न कि किसी विशेष डिवाइस से: सदस्यता स्तर, लॉयल्टी पॉइंट्स, पसंदीदा भाषा।

उदाहरण

एक उपयोगकर्ता के पास आपके ऐप के iOS और Android दोनों संस्करण इंस्टॉल हैं। उनके UserID के माध्यम से एक subscription_tier टैग को "premium" पर सेट करने से यह दोनों डिवाइस पर तुरंत लागू हो जाता है। एक सामान्य टैग के साथ आपको इसे प्रति डिवाइस अलग से सेट करना होगा।

उदाहरण: UserID के माध्यम से एक उपयोगकर्ता-विशिष्ट टैग सेट करें

{
   "request":{
      "application": "XXXXX-XXXXX",
      "userId": "the id of a specific user",
      "tags": {
           "subscription_tier": "premium",
           "loyalty_points": 350
      }
   }
}

डिफ़ॉल्ट टैग्स

ये टैग्स Pushwoosh द्वारा आउट-ऑफ-द-बॉक्स उपलब्ध कराए जाते हैं, इसलिए आपको उन्हें मैन्युअल रूप से सेट करने की आवश्यकता नहीं है (और, वास्तव में, नहीं करनी चाहिए)। उनमें से अधिकांश एप्लिकेशन से सेट किए जाते हैं और हमारे सर्वर पर registerDevice और अन्य API कॉल्स के माध्यम से भेजे जाते हैं, और कुछ सर्वर द्वारा ही सेट किए जाते हैं।

नाम	प्रकार	कहाँ सेट किया गया है	विवरण
Application Version	वर्जन	SDK	एक डिवाइस पर इंस्टॉल किए गए ऐप का वर्तमान संस्करण।
Browser Type	स्ट्रिंग	SDK	जब कोई डिवाइस आपके वेब प्रोजेक्ट के लिए पंजीकृत होता है, तो उसका प्रकार - मोबाइल या डेस्कटॉप - स्वचालित रूप से ट्रैक किया जाता है।
City	स्ट्रिंग	सर्वर	एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान।
Country	स्ट्रिंग	सर्वर	एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान।
Device Model	स्ट्रिंग	SDK	उस डिवाइस मॉडल को इंगित करता है जिस पर ऐप इंस्टॉल है।
First Install	डेट	सर्वर	उस समय को इंगित करता है जब किसी डिवाइस को पहली बार सूचनाओं के लिए पंजीकृत किया गया था।
In-App Product	लिस्ट	SDK	ऐप के उपयोगकर्ता द्वारा खरीदे गए इन-ऐप उत्पाद।
Last In-App Purchase Date	डेट	SDK	किसी डिवाइस पर की गई नवीनतम इन-ऐप खरीदारी की तारीख।
Language	स्ट्रिंग	SDK	ISO-639-1 के अनुसार डिवाइस के लोकेल का दो-अक्षर का लोअरकेस संक्षिप्त नाम; डिवाइस सेटिंग्स से लिया गया।
Last Application Open	डेट	सर्वर	किसी डिवाइस पर सबसे हाल के ऐप लॉन्च का समय।
Last Email Open	डेट	सर्वर	वह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल ओपन इवेंट पंजीकृत किया था।
Last Email Open Message Code	स्ट्रिंग	सर्वर	सबसे हाल ही में खोले गए ईमेल का संदेश कोड (प्रारूप XXXX-XXXXXXXX-XXXXXXXX)। प्रत्येक PW_EmailOpen इवेंट पर अपडेट किया जाता है। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने इसे खोला।
Last Email Click	डेट	सर्वर	वह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल लिंक क्लिक पंजीकृत किया था।
Last Email Click Message Code	स्ट्रिंग	सर्वर	सबसे हाल के ईमेल में संदेश कोड जिसमें एक लिंक पर क्लिक किया गया था (प्रारूप XXXX-XXXXXXXX-XXXXXXXX)। प्रत्येक PW_EmailLinkClicked इवेंट पर अपडेट किया जाता है। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने क्लिक किया।
Last Email Confirm	डेट	सर्वर	डिवाइस के ईमेल पते के लिए सबसे हाल के डबल ऑप्ट-इन सदस्यता पुष्टि की तारीख।
Bounced Email	डेट	सर्वर	वह तारीख जब इस ईमेल पते के लिए एक हार्ड बाउंस हुआ। समय-आधारित विभाजन को सक्षम करने के लिए दिनांक के रूप में संग्रहीत, उदाहरण के लिए, हाल के बाउंस वाले उपयोगकर्ताओं को बाहर करने के लिए।
Unsubscribed Emails	बूलियन	SDK	यह इंगित करता है कि क्या किसी उपयोगकर्ता ने आपके ऐप से ईमेल प्राप्त करने से सदस्यता समाप्त कर दी है।
OS Version	वर्जन	SDK	किसी डिवाइस पर चल रहे ऑपरेटिंग सिस्टम का संस्करण।
Platform	स्ट्रिंग	SDK	वह प्लेटफ़ॉर्म जिस पर उपयोगकर्ता आपके प्रोजेक्ट का उपयोग कर रहा है।
Push Alerts Enabled	बूलियन	SDK	यह इंगित करता है कि डिवाइस सेटिंग्स में पुश अलर्ट की अनुमति है या नहीं।
SDK 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 सेट किया जाता है।

200

{
    "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”

उपयोगकर्ताओं से जानकारी कैसे एकत्र करें

एक बार जब आप एक टैग जोड़ और कॉन्फ़िगर कर लेते हैं, तो यह आपके उपयोगकर्ताओं से जानकारी एकत्र करना शुरू करने के लिए तैयार है। इसे लागू करने के लिए इन चरणों का पालन करें:

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

डिवाइस के लिए एक इंटीजर टैग सेट करता है।

public virtual void SetIntTag(string tagName, int tagValue)

SetStringTag

डिवाइस के लिए एक स्ट्रिंग टैग सेट करता है।

public virtual void SetStringTag(string tagName, string tagValue)

SetListTag

डिवाइस के लिए एक लिस्ट टैग सेट करता है।

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

इनपुट पैरामीटर टैग्स – 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 प्रलेखन देखें

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

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

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

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

टिप

API के माध्यम से एक सेगमेंट बनाने से पहले, /getTagStats अनुरोध के माध्यम से अपने उपयोगकर्ताओं के डिवाइस पर मौजूद मानों की जांच करें।