कैटेगरी

आप जो भी ईमेल भेजते हैं उसमें एक कैटेगरी होती है जो बताती है कि आप उसे क्यों भेज रहे हैं, जो POST /v1/email/messages पर category फ़ील्ड से सेट होती है। यह दो में से एक वैल्यू लेती है, marketing या transactional, और इसका एक ही प्रभाव है: यह तय करती है कि कौन से सप्रेशन रिकॉर्ड और अनसब्सक्राइब प्राथमिकताएँ संदेश को ब्लॉक कर सकती हैं।

न्यूज़लेटर अनसब्सक्राइब मार्केटिंग मेल के बारे में कुछ कहता है, पासवर्ड रीसेट के बारे में कुछ नहीं। कैटेगरी इन दोनों इरादों को अलग करने का तरीका है।

दो कैटेगरी

marketing: वह मेल जिसे प्राप्तकर्ता ने पाने का चुनाव किया और बंद करने का चुनाव कर सकता है। कैंपेन, न्यूज़लेटर, प्रोडक्ट अनाउंसमेंट, प्रमोशनल ऑफ़र। कोई भी चीज़ जहाँ "I don't want this anymore" एक ऐसा जवाब है जिसका सम्मान करना ज़रूरी है।
transactional: वह मेल जो प्राप्तकर्ता की अपनी कार्रवाई के लिए ज़रूरी है। पासवर्ड रीसेट, ईमेल सत्यापन, वन-टाइम कोड, ऑर्डर रसीदें, सुरक्षा और अकाउंट अलर्ट। प्राप्तकर्ता की मार्केटिंग प्राथमिकताएँ चाहे जो हों, इन्हें पहुँचना ज़रूरी है।

सोचिए कि अगर संदेश कभी न पहुँचे तो क्या होगा। अगर प्राप्तकर्ता द्वारा शुरू किया गया कोई फ़्लो टूटता है, तो वह ट्रांज़ैक्शनल है। अगर बातचीत आपने शुरू की, तो वह मार्केटिंग है।

ये दोनों पूरा सेट हैं: कोई भी API कैटेगरी नहीं बनाता या कॉन्फ़िगर नहीं करता, और फ़ील्ड इन्हीं वैल्यू के विरुद्ध वैलिडेट होती है। इससे बारीक सेगमेंटेशन के लिए कैटेगरी के साथ टैग इस्तेमाल करें।

कैटेगरी सप्रेशन पॉलिसी कैसे तय करती है

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

यह असमानता हर कारण के अर्थ से आती है। हार्ड बाउंस का मतलब है कि पता मौजूद नहीं है, इसलिए कैटेगरी चाहे जो हो भेजना व्यर्थ है। मैनुअल सप्रेशन आपकी टीम का अपना फ़ैसला है, जिस पर हम कभी सवाल नहीं उठाते। शिकायतें और अनसब्सक्राइब अनचाही मेल के बारे में प्राथमिकताएँ हैं: ये आपके marketing भेजने को रोकती हैं, जबकि जिस प्राप्तकर्ता ने आपके न्यूज़लेटर को स्पैम रिपोर्ट किया उसे अपना पासवर्ड रीसेट फिर भी मिलता है। यह अपवाद भी जानबूझकर है: opt-out केवल मार्केटिंग के बजाय सभी संदेशों के लिए रिकॉर्ड किया जा सकता है (Record preference डायलॉग का Messages to stop विकल्प, या POST /v1/preferences पर coverage: all), और यह प्राप्तकर्ता का पूर्ण चुप्पी का अनुरोध है, इसलिए यह ट्रांज़ैक्शनल मेल को भी ब्लॉक करता है।

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

डिफ़ॉल्ट, और ट्रांज़ैक्शनल भेजने को ऑप्ट आउट क्यों करना चाहिए

category छोड़ दें तो भेजा गया मेल marketing होता है। यह सुरक्षित दिशा में विफल होता है: बिना स्पष्ट कैटेगरी के भेजा गया मेल अनसब्सक्राइब और शिकायतों का सम्मान करता है और उसमें एक अनसब्सक्राइब लिंक होता है, इसलिए कैंपेन बिना अतिरिक्त काम के अनुपालन में रहता है।

दो भेजने के रास्ते अपनी कैटेगरी कहीं और से लेते हैं। जो भेजना एक स्टोर किए गए टेम्पलेट का उपयोग करता है और category छोड़ देता है, वह टेम्पलेट की अपनी वर्गीकरण लेता है, इसलिए transactional के रूप में बनाया गया टेम्पलेट ट्रांज़ैक्शनल के रूप में भेजता है। एक संदेश को अलग तरह से वर्गीकृत करने के लिए भेजने पर category सेट करें, और भेजने की वैल्यू जीतती है। SMTP के ज़रिए सबमिट किया गया मेल अपनी कैटेगरी API key के SMTP कॉन्फ़िगरेशन से लेता है, जो बिना कॉन्फ़िगर की गई key के लिए transactional होता है।

इसलिए ऑपरेशनल मेल को ऑप्ट आउट करना ज़रूरी है। बिना कैटेगरी भेजा गया पासवर्ड रीसेट मार्केटिंग माना जाता है: उसमें एक अनसब्सक्राइब लिंक होता है जो नहीं होना चाहिए, और न्यूज़लेटर अनसब्सक्राइब उसे ब्लॉक कर देता है भले ही प्राप्तकर्ता ने उसे माँगा हो। रसीदों, रीसेट, सत्यापन कोड और अकाउंट अलर्ट पर category: "transactional" सेट करें:

कोड उदाहरण

{
  "from": "no-reply@yourdomain.com",
  "to": ["delivered@messagebird.dev"],
  "subject": "Reset your password",
  "html": "<p>Click the link below to reset your password...</p>",
  "category": "transactional"
}

एनालिटिक्स डाइमेंशन के रूप में कैटेगरी

कैटेगरी संदेश पर बनी रहती है और जहाँ भी संदेश दिखता है वापस आती है, इसलिए यह आपकी डिलीवरी, बाउंस, और एंगेजमेंट संख्याओं को हर भेजने पर टैग किए बिना मार्केटिंग और ऑपरेशनल ट्रैफ़िक में विभाजित करती है। संदेश सूची कैटेगरी से फ़िल्टर करती है, stats API मेट्रिक्स को इसके आधार पर विभाजित करता है, और डैशबोर्ड ईमेल लॉग वही फ़िल्टर प्रदान करता है।

अगले कदम

ईमेल भेजना: पूरा POST /v1/email/messages पेलोड, category सहित
सप्रेशन: सप्रेशन सूची, तीन कारण, और पूरा कैटेगरी मैट्रिक्स
अनसब्सक्राइब लिंक: marketing भेजने में शामिल opt-out विवरण
API संदर्भ: पूरे रिक्वेस्ट और रिस्पॉन्स स्कीमा