टैग

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

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

किन टैग का उपयोग करना है, यह तय करना

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

टिप

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

टैग मान

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

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

टैग के प्रकार

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

नोट

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

एप्लिकेशन विशिष्ट / गैर-विशिष्ट टैग

यह पैरामीटर एक ही खाते में विभिन्न ऐप्स के संबंध में टैग के व्यवहार का वर्णन करता है। एप्लिकेशन विशिष्ट टैग में एक ही खाते पर प्रत्येक ऐप के लिए मानों का एक अलग सेट हो सकता है। इसके विपरीत, एप्लिकेशन गैर-विशिष्ट टैग, इस टैग का उपयोग करने वाले सभी ऐप्स के लिए समान मान संग्रहीत करते हैं।

उदाहरण

मान लीजिए आपके पास दो ऐप हैं, एक समाचार ऐप और एक गेम, और आप केवल उन उपयोगकर्ताओं को लक्षित करना चाहते हैं जो आपसे पुश प्राप्त करने के लिए स्पष्ट रूप से सहमत हुए हैं। तो, आप “Subscribed” नामक एक बूलियन टैग बनाते हैं और उन उपयोगकर्ताओं के लिए "true" मान सेट करते हैं जो आपसे पुश प्राप्त करना चाहते हैं, और उन लोगों के लिए "false" जो अधिसूचित नहीं होना चाहते हैं।

आपके एक उपयोगकर्ता, अन्ना, ने आपके दोनों ऐप इंस्टॉल किए हैं। वह कुछ ब्रेकिंग न्यूज के बारे में अधिसूचित होने से ठीक है, लेकिन गेम ऐप से किसी भी पुश से बाहर निकल गई है।

यदि “Subscribed” टैग एप्लिकेशन विशिष्ट है, तो सब कुछ योजना के अनुसार होगा। हालांकि, यदि यह टैग एप्लिकेशन गैर-विशिष्ट था, तो आपका प्रत्येक ऐप दूसरे ऐप द्वारा सेट किए गए मान को ओवरराइट कर देगा, जो आपके लक्ष्यीकरण को बर्बाद कर सकता है और निराशा का कारण बन सकता है।

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

उपयोगकर्ता-विशिष्ट टैग

Pushwoosh में सभी टैग डिज़ाइन के अनुसार उपयोगकर्ता-विशिष्ट होते हैं और HWID के बजाय UserID द्वारा सेट किए जाने पर उपयोगकर्ता के सभी उपकरणों के लिए असाइन किए जाते हैं।

उदाहरण

{
   "request":{
      "application": "XXXXX-XXXXX", // Pushwoosh application code
      "userId": "the id of a specific user",
      "tags": {
           "UserSpecificStringTag": "string value",
           "UserSpecificIntegerTag": 42
      }
   }
}

डिफ़ॉल्ट टैग

ये टैग 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 कंट्रोल पैनल में एक नया टैग जोड़ सकते हैं या /addTag विधि का उपयोग कर सकते हैं।

addTag

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

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

अनुरोध बॉडी

नाम	प्रकार	विवरण
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", // required, API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME", // required
      "type": 1, // required, see possible values below
      "application_specific": true, // or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps
      "user_specific": true // or 'false', optional, used for application_specific tags
    }
  }
}

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

• 1 - Integer
• 2 - String
• 3 - List
• 4 - Date
• 5 - Boolean
• 6 - Decimal. Ex: 19.95
• 7 - Version. Ex: “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 के माध्यम से टैग सेट करना

जबकि अधिकांश मामलों (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 द्वारा लौटाए जा सकते हैं और टैग मानों के रूप में सहेजे जा सकते हैं) और कई आस-पास के क्षेत्र शामिल हैं।

टिप

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