Sign inGet Started

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

आपके मार्केटिंग ईमेल का प्राप्तकर्ता दो तरीकों से ऑप्ट-आउट कर सकता है: उसका मेलबॉक्स प्रदाता जो अनसब्सक्राइब बटन दिखाता है, उससे, और ईमेल के मुख्य भाग में दिए गए लिंक से। हम हर 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 टैब पर और संपर्क के विवरण पेज पर दिखता है। इसका असर केवल उसी पते पर होता है, और रिकॉर्ड में दर्ज रहता है कि किसने और कब ऑप्ट-आउट किया।

वेबहुक इवेंट की मदद से आप ऑप्ट-आउट को अपने डेटाबेस में दर्ज कर सकते हैं, सब्सक्रिप्शन फ़्लैग बदल सकते हैं या उसे लॉग कर सकते हैं। दोनों इवेंट में हर ईमेल इवेंट के पहचान वाले फ़ील्ड होते हैं: 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 की आवश्यकताएँ: बल्क सेंडर के लिए वन-क्लिक अनसब्सक्राइब कहाँ ज़रूरी है
  • वेबहुक: एंडपॉइंट को सब्सक्राइब करना, सिग्नेचर सत्यापन और फिर से प्रयास करना

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।