अनसब्सक्राइब लिंक

आपके मार्केटिंग मेल के प्राप्तकर्ता के पास ऑप्ट आउट करने के दो तरीके हैं: अनसब्सक्राइब बटन जो उनका मेलबॉक्स प्रोवाइडर दिखाता है, और मैसेज बॉडी में एक लिंक। हम हर marketing सेंड पर दोनों लगाते हैं, हर ऑप्ट-आउट को webhook इवेंट के रूप में रिपोर्ट करते हैं, और पते का ऑप्ट-आउट रिकॉर्ड करते हैं ताकि आपका अगला कैम्पेन उसे छोड़ दे। कैटेगरी सही सेट करना ही आपकी ज़िम्मेदारी है।

कैटेगरी सेट करें

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

इसके पीछे दो बाध्यताएँ हैं। बल्क सेंडर्स को मार्केटिंग मेल पर वन-क्लिक अनसब्सक्राइब देना Gmail और Yahoo द्वारा अनिवार्य है, और एक दिखने वाला इन-बॉडी लिंक अधिकांश बाज़ारों में कानूनन अलग से अनिवार्य है। marketing सेंड में दोनों होते हैं।

वन-क्लिक अनसब्सक्राइब बटन

यह वह अनसब्सक्राइब कंट्रोल है जो मेलबॉक्स प्रोवाइडर मैसेज हेडर में दिखाते हैं। यह दो हेडर्स, List-Unsubscribe और List-Unsubscribe-Post, से आता है, और प्रोवाइडर वन-टैप वर्शन तभी दिखाते हैं जब दोनों मौजूद हों और ऑप्ट-आउट एंडपॉइंट बिना ऑथेंटिकेशन के POST स्वीकार करे, बिना किसी कन्फ़र्मेशन स्टेप के। Gmail और Yahoo यही अनुबंध जाँचते हैं।

मार्केटिंग मेल उन हेडर्स के साथ पहले से जाता है, चाहे आप इसे कैसे भी भेजें: डैशबोर्ड से ब्रॉडकास्ट, या POST /v1/email/messages के ज़रिए marketing मैसेज। कुछ बनाने की ज़रूरत नहीं, कुछ होस्ट करने की ज़रूरत नहीं।

चूँकि मार्केटिंग मेल पर उस हेडर पेयर के मालिक हम हैं, marketing सेंड पर अपना List-Unsubscribe या List-Unsubscribe-Post सेट करना 422 के साथ रिजेक्ट होता है। transactional सेंड पर हम कोई अनसब्सक्राइब हेडर नहीं जोड़ते, और आप ज़रूरत हो तो headers फ़ील्ड के ज़रिए अपना सेट कर सकते हैं।

प्रोवाइडर का बटन इस्तेमाल करने वाला प्राप्तकर्ता एक email.list_unsubscribed इवेंट उत्पन्न करता है।

इन-बॉडी लिंक

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

डिफ़ॉल्ट रूप से लिंक बॉडी के अंत में एक छोटे फ़ुटर के रूप में आता है। जगह खुद चुनने के लिए, रिज़र्व्ड {{ bird.unsubscribe_url }} वेरिएबल वहाँ रखें जहाँ लिंक होना चाहिए:

कोड उदाहरण

<p>
  You received this because you subscribed to our newsletter. You can {{ bird.unsubscribe_url }} at
  any time.
</p>

फिर हम फ़ुटर जोड़ने के बजाय वहीं लिंक रेंडर करते हैं, एक ऐसे ऐंकर के रूप में जिसका टेक्स्ट "unsubscribe" पढ़ता है। आप इसे href वैल्यू (<a href="{{ bird.unsubscribe_url }}">Leave this list</a>) के रूप में भी इस्तेमाल कर सकते हैं ताकि अपनी वर्डिंग और स्टाइलिंग रख सकें।

यह प्रतिस्थापन केवल भेजी जाने वाली कॉपी पर होता है, इसलिए API के ज़रिए मैसेज वापस पढ़ने पर आपकी मूल सामग्री वेरिएबल सहित वैसी ही मिलती है।

Email > Unsubscribe page में डेस्टिनेशन पेज कस्टमाइज़ करें। इसका सेंडर नाम, बैकग्राउंड, टेक्स्ट और बटन रंग सेट करें। सेंडर नाम डिफ़ॉल्ट रूप से आपके ऑर्गनाइज़ेशन के नाम पर होता है। परिणाम का प्रीव्यू देखने के लिए उदाहरण लिंक का उपयोग करें।

इन-बॉडी लिंक इस्तेमाल करने वाला प्राप्तकर्ता एक email.unsubscribed इवेंट उत्पन्न करता है, जो email.list_unsubscribed से अलग है ताकि आप दोनों रास्तों में फ़र्क कर सकें।

ऑप्ट-आउट क्या करता है

हम प्राप्तकर्ता को मेल भेजना बंद कर देते हैं, आपको webhook पर कोई कार्रवाई करने की ज़रूरत नहीं। दोनों इवेंट प्राप्तकर्ता के पते को नॉन-ट्रांज़ैक्शनल मेल से अनसब्सक्राइब्ड के रूप में रिकॉर्ड करते हैं, जिसका मतलब है:

marketing सेंड उस पते पर email.rejected और rejection_reason: "recipient_suppressed" के साथ रिजेक्ट होते हैं। यह रीज़न किसी भी प्राप्तकर्ता-स्तरीय ब्लॉक की रिपोर्ट करता है, चाहे सप्रेशन हो या बताई गई प्राथमिकता, इसलिए किसी भी स्थिति में इसी पर मैच करें।
transactional सेंड फिर भी जाते हैं, क्योंकि अनसब्सक्राइब का मतलब है कि प्राप्तकर्ता को और कैम्पेन नहीं चाहिए। पता अपने आप में अभी भी काम करता है।

अनसब्सक्राइब एक बताई गई प्राथमिकता है, सप्रेशन नहीं: यह Email > Suppressions के Preferences टैब पर और कॉन्टैक्ट के डिटेल पेज पर दिखता है, न कि सप्रेशन लिस्ट में। केवल वह पता प्रभावित होता है, और रिकॉर्ड दिखाता है कि किसने और कब ऑप्ट आउट किया।

webhook इवेंट आपको ऑप्ट-आउट को अपने डेटाबेस में मिरर करने, सब्सक्रिप्शन फ़्लैग बदलने, या लॉग करने देते हैं। दोनों में हर ईमेल इवेंट के पहचान फ़ील्ड शामिल होते हैं: email_id, recipient_id, workspace_id, recipient पता, और इसका recipient_role। इनमें मूल सेंड के tags और metadata भी शामिल होते हैं, ताकि आप बिना अलग लुकअप के अपने रिकॉर्ड से मिलान कर सकें, और broadcast_id जो उस ब्रॉडकास्ट का नाम बताता है जिसके हिस्से के रूप में मेल गया, या null जब सेंड के पीछे कोई ब्रॉडकास्ट नहीं था। हमने यह फ़ील्ड जोड़ने से पहले भेजे गए मेल के अनसब्सक्राइब लिंक में कोई ब्रॉडकास्ट नाम नहीं होता, इसलिए ऐसे लिंक से ऑप्ट-आउट दोनों इवेंट पर null रिपोर्ट करता है, चाहे ब्रॉडकास्ट ने मेल भेजा हो या नहीं। इन्हें किसी भी अन्य ईमेल इवेंट की तरह ही सब्सक्राइब करें; इवेंट रेफ़रेंस में पूरे पेलोड हैं।

अनसब्सक्राइब प्राप्तकर्ता का अपना बयान है, इसलिए आप इसे सप्रेशन की तरह सप्रेशन API से हटा नहीं सकते। पते पर फिर से मेल भेजने के लिए, Contacts > Preferences पर ऑप्ट-इन रिकॉर्ड करें, या status: granted के साथ POST /v1/preferences कॉल करें। वह वर्कस्पेस-व्यापी पेज हर चैनल के बयान रिकॉर्ड करता है, जबकि Email > Suppressions का टैब ईमेल वाले दिखाता है। किसी भी तरह, उनके ऑप्ट-आउट पर ऑप्ट-इन दर्ज करने के लिए consented_at चाहिए, वह क्षण जब प्राप्तकर्ता ने सहमति दी, और ऑप्ट-इन तभी प्रभावी होता है जब वह क्षण उस ऑप्ट-आउट के बाद का हो जिसे यह पलटता है।

अगले कदम

कैटेगरी: marketing क्यों वह चीज़ है जो अनसब्सक्राइब को प्रभावी बनाती है
सप्रेशन: डिलीवरेबिलिटी-फ़ैक्ट लिस्ट, और यह बताई गई प्राथमिकता से कैसे अलग है
ईमेल इवेंट: पूरे email.unsubscribed और email.list_unsubscribed पेलोड
Gmail और Yahoo आवश्यकताएँ: जहाँ बल्क सेंडर्स के लिए वन-क्लिक अनसब्सक्राइब अनिवार्य है
Webhooks: एंडपॉइंट सब्सक्राइब करना, सिग्नेचर सत्यापन, और फिर से प्रयास