टैग्स 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, /addTag के लिए डिफ़ॉल्ट): टैग मान प्रति डिवाइस (HWID) संग्रहीत किया जाता है। एक ही उपयोगकर्ता के प्रत्येक डिवाइस में स्वतंत्र रूप से एक अलग मान हो सकता है।
User-specific (user_specific: true, कंट्रोल पैनल फ़ॉर्म में और setTags द्वारा स्वचालित रूप से बनाए गए टैग्स के लिए डिफ़ॉल्ट): टैग मान प्रति उपयोगकर्ता (UserID) संग्रहीत किया जाता है। जब UserID के माध्यम से सेट किया जाता है, तो मान उपयोगकर्ता के सभी डिवाइस पर एक साथ लागू होता है। उन विशेषताओं के लिए उपयोगी है जो व्यक्ति से संबंधित हैं, न कि किसी विशेष डिवाइस से: सदस्यता स्तर, लॉयल्टी अंक, पसंदीदा भाषा।
एक उपयोगकर्ता के पास आपके ऐप के iOS और Android दोनों संस्करण स्थापित हैं। उनके UserID के माध्यम से subscription_tier टैग को "premium" पर सेट करने से यह दोनों डिवाइस पर तुरंत लागू हो जाता है। एक General टैग के साथ आपको इसे प्रति डिवाइस अलग से सेट करना होगा।
उदाहरण: UserID के माध्यम से एक उपयोगकर्ता-विशिष्ट टैग सेट करें
ये टैग्स Pushwoosh द्वारा पहले से ही उपलब्ध हैं, इसलिए आपको उन्हें मैन्युअल रूप से सेट करने की आवश्यकता नहीं है (और, वास्तव में, नहीं करनी चाहिए)। उनमें से अधिकांश एप्लिकेशन से सेट किए जाते हैं और हमारे सर्वर पर registerDevice और अन्य API कॉल्स के माध्यम से भेजे जाते हैं, और कुछ सर्वर द्वारा ही सेट किए जाते हैं। SMS Marketing Consent और Viber Marketing Consent इसके अपवाद हैं। जब कोई व्यक्ति मार्केटिंग संदेशों के लिए सहमति देता है या उन्हें अस्वीकार करता है, तो आपके डेवलपर्स उन्हें setTags के साथ सेट करते हैं।
नाम
प्रकार
कहाँ सेट होता है
विवरण
एप्लिकेशन संस्करण
संस्करण
SDK
एक डिवाइस पर स्थापित ऐप का वर्तमान संस्करण
ब्राउज़र प्रकार
स्ट्रिंग
SDK
जब कोई डिवाइस आपके वेब प्रोजेक्ट के लिए पंजीकृत होता है, तो उसका प्रकार - मोबाइल या डेस्कटॉप - स्वचालित रूप से ट्रैक किया जाता है
शहर
स्ट्रिंग
सर्वर
एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
देश
स्ट्रिंग
सर्वर
एक डिवाइस का नवीनतम पंजीकृत भौगोलिक स्थान
डिवाइस मॉडल
स्ट्रिंग
SDK
उस डिवाइस मॉडल को इंगित करता है जिस पर ऐप इंस्टॉल है
पहली स्थापना
दिनांक
सर्वर
उस समय को इंगित करता है जब किसी डिवाइस को पहली बार सूचनाओं के लिए पंजीकृत किया गया था
इन-ऐप उत्पाद
सूची
SDK
ऐप के उपयोगकर्ता द्वारा खरीदे गए इन-ऐप उत्पाद
अंतिम इन-ऐप खरीद की तारीख
दिनांक
SDK
किसी डिवाइस पर की गई नवीनतम इन-ऐप खरीद की तारीख
भाषा
स्ट्रिंग
SDK
ISO-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 में दर्ज क्लिक का समय। इसके साथ ही अपडेट होता है: एक नया क्लिक पिछली तारीख को ओवरराइट कर देता है।
यह वह जगह है जहाँ आपकी रचनात्मकता आपके विशिष्ट व्यावसायिक लक्ष्यों को प्राप्त करने के लिए काम आती है। कस्टम टैग्स विभाजन तर्क या लक्ष्यीकरण पैटर्न के आधार पर बनाए जा सकते हैं जो आपकी अनूठी व्यावसायिक आवश्यकताओं के लिए उपयुक्त है। अपने अभियानों के लिए आवश्यक अतिरिक्त कस्टम टैग्स को परिभाषित करने के लिए अपनी मार्केटिंग टीम के साथ सहयोग करें।
पहले से टैग बनाना वैकल्पिक है। 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 सपोर्ट से संपर्क करें।
जब true होता है, तो टैग मान उपयोगकर्ता स्तर पर संग्रहीत होता है और UserID द्वारा सेट किए जाने पर उपयोगकर्ता के सभी डिवाइसों में साझा किया जाता है। जब false (डिफ़ॉल्ट) होता है, तो टैग डिवाइस-स्तरीय होता है और प्रति HWID सेट किया जाता है।
एक बार जब आप एक टैग जोड़ और कॉन्फ़िगर कर लेते हैं, तो यह आपके उपयोगकर्ताओं से जानकारी एकत्र करना शुरू करने के लिए तैयार है। इसे लागू करने के लिए इन चरणों का पालन करें:
प्रासंगिक एकीकरण गाइड का पालन करके अपने प्रोजेक्ट में Pushwoosh SDK को एकीकृत करें।
टैग्स असाइन करने और उपयोगकर्ता डेटा एकत्र करने के लिए setTags फ़ंक्शन का उपयोग करें।
नीचे setTags फ़ंक्शन का उपयोग करके विभिन्न फ्रेमवर्क के लिए कार्यान्वयन उदाहरण दिए गए हैं।
हालांकि अधिकांश मामलों (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 में होना चाहिए
डिवाइस का स्थान उसके IP पते के आधार पर निर्धारित किया जाता है, जब आपके ऐप को उस डिवाइस पर आखिरी बार लॉन्च किया गया था। GeoIP स्थान डेटा Pushwoosh को सबमिट करता है, और Pushwoosh GeoIP से प्राप्त स्थान को एक विशेष डिवाइस के लिए City टैग मान के रूप में सहेजता है।
कुछ मामलों में, GeoIP द्वारा सबमिट किया गया स्थान शहर के नाम से भिन्न होता है - उदाहरण के लिए, जब यह किसी शहर के क्षेत्र या अन्य प्रशासनिक इकाई को संदर्भित करता है। विभाजन उद्देश्यों के लिए डिफ़ॉल्ट City टैग का उपयोग करते समय कृपया सावधान रहें: सुनिश्चित करें कि आप उचित मानों का चयन करते हैं।
उदाहरण के लिए, यदि आप म्यूनिख के उपयोगकर्ताओं को लक्षित करने जा रहे हैं, तो आपको इसे कई City टैग मानों के साथ कवर करना होगा, जिसमें “Munich” स्वयं (सभी संबंधित मानों के साथ, जैसे वर्तनी के विभिन्न प्रकार जो GeoIP द्वारा लौटाए जा सकते हैं और टैग मानों के रूप में सहेजे जा सकते हैं) और कई आस-पास के क्षेत्र शामिल हैं।