सामग्री पर जाएं

टैग्स

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

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

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

Anchor link to

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

टैग मान

Anchor link to

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

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

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

टैग ऑपरेटर

Anchor link to

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

  • पूर्णांक टैग ऑपरेटर: 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

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

Anchor link to

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

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

उदाहरण

Anchor link to

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

उदाहरण: UserID के माध्यम से एक उपयोगकर्ता-विशिष्ट टैग सेट करें
{
"request":{
"application": "XXXXX-XXXXX",
"userId": "the id of a specific user",
"tags": {
"subscription_tier": "premium",
"loyalty_points": 350
}
}
}

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

Anchor link to

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

नामप्रकारकहाँ सेट होता हैविवरण
एप्लिकेशन संस्करणसंस्करणSDKएक डिवाइस पर स्थापित ऐप का वर्तमान संस्करण
ब्राउज़र प्रकारस्ट्रिंगSDKजब कोई डिवाइस आपके वेब प्रोजेक्ट के लिए पंजीकृत होता है, तो उसका प्रकार - मोबाइल या डेस्कटॉप - स्वचालित रूप से ट्रैक किया जाता है
शहरस्ट्रिंगसर्वरएक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
देशस्ट्रिंगसर्वरएक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
डिवाइस मॉडलस्ट्रिंगSDKउस डिवाइस मॉडल को इंगित करता है जिस पर ऐप इंस्टॉल है
पहली स्थापनादिनांकसर्वरउस समय को इंगित करता है जब किसी डिवाइस को पहली बार सूचनाओं के लिए पंजीकृत किया गया था
इन-ऐप उत्पादसूचीSDKऐप के उपयोगकर्ता द्वारा खरीदे गए इन-ऐप उत्पाद
अंतिम इन-ऐप खरीद की तारीखदिनांकSDKकिसी डिवाइस पर की गई नवीनतम इन-ऐप खरीद की तारीख
भाषास्ट्रिंगSDKISO-639-1 के अनुसार डिवाइस के लोकेल का दो-अक्षर का लोअरकेस संक्षिप्त नाम; डिवाइस सेटिंग्स से लिया गया
अंतिम एप्लिकेशन खोलने का समयदिनांकसर्वरकिसी डिवाइस पर सबसे हालिया ऐप लॉन्च का समय
अंतिम ईमेल खोलने की तारीखदिनांकसर्वरवह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल खोलने की घटना दर्ज की
अंतिम ईमेल खोलने का संदेश कोडस्ट्रिंगसर्वरहाल ही में खोले गए ईमेल का संदेश कोड (प्रारूप XXXX-XXXXXXXX-XXXXXXXX)। प्रत्येक PW_EmailOpen घटना पर अपडेट किया गया। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने इसे खोला
अंतिम ईमेल क्लिक की तारीखदिनांकसर्वरवह तारीख जब डिवाइस के ईमेल पते ने हाल ही में एक ईमेल लिंक क्लिक दर्ज किया
अंतिम ईमेल क्लिक का संदेश कोडस्ट्रिंगसर्वरसबसे हालिया ईमेल का संदेश कोड जिसमें एक लिंक पर क्लिक किया गया था (प्रारूप XXXX-XXXXXXXX-XXXXXXXX)। प्रत्येक PW_EmailLinkClicked घटना पर अपडेट किया गया। इसका उपयोग किसी विशिष्ट ईमेल अभियान के प्राप्तकर्ताओं को विभाजित करने के लिए करें कि किसने क्लिक किया
अंतिम ईमेल पुष्टि की तारीखदिनांकसर्वरडिवाइस के ईमेल पते के लिए सबसे हालिया डबल ऑप्ट-इन सदस्यता पुष्टि की तारीख
बाउंस हुआ ईमेलदिनांकसर्वरवह तारीख जब इस ईमेल पते के लिए एक हार्ड बाउंस हुआ। समय-आधारित विभाजन को सक्षम करने के लिए दिनांक के रूप में संग्रहीत, उदाहरण के लिए, हाल के बाउंस वाले उपयोगकर्ताओं को बाहर करने के लिए
अनसब्सक्राइब किए गए ईमेलबूलियनSDKइंगित करता है कि क्या किसी उपयोगकर्ता ने आपके ऐप से ईमेल प्राप्त करने से अनसब्सक्राइब किया है
SMS Marketing Consentबूलियनसर्वर, setTagsक्या SMS सब्सक्राइबर ने मार्केटिंग SMS के लिए सहमति दी है: true सहमति दी, false ऑप्ट आउट किया, कोई मान नहीं तो अज्ञात। और जानें
Viber Marketing Consentबूलियनसर्वर, setTagsक्या Viber सब्सक्राइबर ने Viber पर मार्केटिंग संदेशों के लिए सहमति दी है: true सहमति दी, false ऑप्ट आउट किया, कोई मान नहीं तो अज्ञात। और जानें
ओएस संस्करणसंस्करणSDKकिसी डिवाइस पर चल रहे ऑपरेटिंग सिस्टम का संस्करण
प्लेटफॉर्मस्ट्रिंगSDKवह प्लेटफॉर्म जिस पर उपयोगकर्ता आपके प्रोजेक्ट का उपयोग कर रहा है।
पुश अलर्ट सक्षमबूलियनSDKइंगित करता है कि क्या डिवाइस सेटिंग्स में पुश अलर्ट की अनुमति है
SDK संस्करणसंस्करणSDKकिसी डिवाइस पर लागू Pushwoosh SDK का संस्करण
Live Activity IDसूचीSDKडिवाइस के साथ Live Activity ID को जोड़कर लाइव एक्टिविटीज़ को प्रबंधित करने के लिए उपयोग किया जाता है। 12 घंटे के बाद स्वचालित रूप से साफ़ हो जाता है। आरक्षित: आप इस नाम से कस्टम टैग नहीं बना सकते।
WhatsApp Session Expires Atदिनांकसर्वरग्राहक के अंतिम इनबाउंड WhatsApp संदेश द्वारा खोली गई वर्तमान 24-घंटे की ग्राहक सेवा विंडो को रखता है। प्रत्येक इनबाउंड संदेश पर स्वचालित रूप से सेट होता है। आरक्षित: आप इस नाम से कस्टम टैग नहीं बना सकते। केवल वर्तमान विंडो संग्रहीत करता है, कोई इतिहास नहीं।
WhatsApp Ad Click IDस्ट्रिंगसर्वरकिसी इनबाउंड WhatsApp संदेश के referral से Click-to-WhatsApp विज्ञापन क्लिक ID (ctwa_clid)। Meta इसे एक बार भेजता है, उस संदेश पर जो बातचीत शुरू करता है। एक नया क्लिक इसे WhatsApp Ad Click Date के साथ ओवरराइट कर देता है। दोबारा भेजा गया या क्रम से बाहर आया webhook इसे वापस नहीं बदलता।
WhatsApp Ad Click Dateदिनांकसर्वरWhatsApp Ad Click ID में दर्ज क्लिक का समय। इसके साथ ही अपडेट होता है: एक नया क्लिक पिछली तारीख को ओवरराइट कर देता है।

कस्टम टैग्स

Anchor link to

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

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

Anchor link to

पहले से टैग बनाना वैकल्पिक है। setTags के माध्यम से एक नया टैग नाम भेजने से यह स्वचालित रूप से बन जाता है, और इसका प्रकार मान से अनुमान लगाया जाता है:

  • एक पूर्ण संख्या Integer बन जाती है।
  • भिन्नात्मक भाग वाली संख्या, जैसे 4.99, Price बन जाती है। 5.0 जैसी संख्या Integer बन जाती है।
  • एक स्ट्रिंग String बन जाती है, या 2024-10-02 22:11 जैसे मान्यता प्राप्त दिनांक-समय प्रारूप के लिए Date।
  • एक स्ट्रिंग जिसमें कोई संख्या, true या false, या JSON ऐरे हो, उसका प्रकार उसकी सामग्री से तय होता है, इसलिए "42" String नहीं, बल्कि Integer बन जाता है।
  • एक ऐरे List बन जाता है।
  • एक बूलियन Boolean बन जाता है।

इवेंट एट्रिब्यूट्स किसी स्ट्रिंग को उसकी सामग्री के आधार पर नहीं पढ़ते, इसलिए किसी इवेंट में भेजा गया "42" String बन जाता है। स्वचालित रूप से बनाए गए इवेंट्स देखें।

स्वचालित रूप से बनाया गया टैग हमेशा User-specific (user_specific: true) होता है। Version टैग के लिए, जिसे स्वचालित निर्माण अनुमान नहीं लगा सकता, या General टैग के लिए, टैग को पहले कंट्रोल पैनल या /addTag के माध्यम से स्पष्ट रूप से जोड़ें।

अधिकांश खातों के लिए टैग का स्वचालित निर्माण डिफ़ॉल्ट रूप से सक्षम है। यदि setTags अपेक्षा के अनुसार नया टैग नहीं बनाता है, तो यह जांचने के लिए कि क्या यह आपके खाते के लिए बंद कर दिया गया है, Pushwoosh सपोर्ट से संपर्क करें।

आप Pushwoosh कंट्रोल पैनल में एक नया टैग जोड़ सकते हैं या /addTag विधि का उपयोग कर सकते हैं।

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

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

अनुरोध बॉडी

Anchor link to
नामप्रकारविवरण
auth*stringPushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
tag*objectटैग पैरामीटर।
tag.name*stringटैग का नाम।
tag.type*integerटैग का प्रकार। नीचे संभावित मान देखें।
tag.user_specificbooleanजब 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”

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

Anchor link to

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

  1. प्रासंगिक एकीकरण गाइड का पालन करके अपने प्रोजेक्ट में Pushwoosh SDK को एकीकृत करें।
  2. टैग्स असाइन करने और उपयोगकर्ता डेटा एकत्र करने के लिए 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];

प्रलेखन

Unity

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

public virtual void SetIntTag(string tagName, int tagValue)
SetStringTag
Anchor link to

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

public virtual void SetStringTag(string tagName, string tagValue)
SetListTag
Anchor link to

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

public virtual void SetListTag(string tagName, List<object> tagValues)

प्रलेखन

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

Anchor link to

हालांकि अधिकांश मामलों (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 टैग का उपयोग करना

Anchor link to

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

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

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