Tracking domain

Tracking domain आपके sending domain पर एक ब्रांडेड hostname है जो ओपन और क्लिक ट्रैकिंग को सर्व करता है। रीरिटन लिंक किसी शेयर्ड डोमेन के बजाय HTTPS पर इस hostname का उपयोग करते हैं। Bounce domain के विपरीत, यह वैकल्पिक है और कभी भी भेजने को नहीं रोकता।

रिकॉर्ड

Tracking domain आपके sending domain के अंतर्गत एक CNAME है जो आपके रीजन में हमारे ट्रैकिंग इंफ़्रास्ट्रक्चर पर रिज़ॉल्व होता है:

Type	Host	Value
CNAME	links.example.com	<region>.links.bird.com

Value रीजन-विशिष्ट है: us1.links.bird.com या eu1.links.bird.com। इसे Email > Domains या domain resource से कॉपी करें। Host डिफ़ॉल्ट रूप से आपके sending domain के अंतर्गत links. होता है।

Hostname कस्टमाइज़ करना

डोमेन रजिस्टर करते समय tracking.name पास करके लेबल चुनें; हम पूरा hostname बनाते हैं:

const domain = await bird.domains.create({
  domain: "mail.acme.com",
  tracking: { name: "click" },
});

domain = client.domains.create(
    domain="mail.acme.com",
    tracking={"name": "click"},
)

domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
	Domain:   "mail.acme.com",
	Tracking: &bird.DomainTrackingConfig{Name: "click"},
})

$domain = $bird->domains->create(
    (new DomainCreate())
        ->setDomain('mail.acme.com')
        ->setTracking((new DomainTrackingConfig())->setName('click')),
);

bird email domains create mail.acme.com --body-file - <<'JSON'
{
  "domain": "mail.acme.com",
  "tracking": {
    "name": "click"
  }
}
JSON

curl -s https://us1.platform.bird.com/v1/email/domains \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "mail.acme.com",
    "tracking": { "name": "click" }
  }'

यह डिफ़ॉल्ट links.mail.acme.com के बजाय click.mail.acme.com को tracking host के रूप में रजिस्टर करता है। Return-path की तरह, यह आपके वर्कस्पेस के domain कॉन्फ़िगरेशन का हिस्सा है।

यह भेजने को नहीं रोकता

वेरिफ़ाइड DKIM, return-path, और DMARC वाला डोमेन बिना किसी tracking रिकॉर्ड के भी भेज सकता है; capabilities.tracking को capabilities.sending से अलग रिपोर्ट किया जाता है। जब तक tracking CNAME वेरिफ़ाई नहीं होता, ओपन और क्लिक आपके ब्रांडेड host के ज़रिए ट्रैक नहीं होते, और डिलीवरी में कुछ नहीं बदलता।

ट्रैकिंग तीन चीज़ों का AND है, इसलिए अकेला वेरिफ़ाइड tracking domain ट्रैकिंग चालू नहीं करता:

प्रति-भेजाव फ़्लैग: मैसेज पर track_opens / track_clicks (दोनों डिफ़ॉल्ट true)।
डोमेन सेटिंग: settings.open_tracking / settings.click_tracking (दोनों डिफ़ॉल्ट off; बिना tracking domain कॉन्फ़िगर किए किसी एक को चालू करने पर 409 लौटता है)। आप CNAME वेरिफ़ाई होने से पहले इन्हें चालू कर सकते हैं; वेरिफ़ाई होने पर ये प्रभावी होते हैं।
एक वेरिफ़ाइड tracking CNAME।

इसलिए ओपन और क्लिक तभी आने शुरू होते हैं जब आपने tracking domain कॉन्फ़िगर और वेरिफ़ाई किया हो और डोमेन सेटिंग चालू की हो। हर फ़्लैग मैसेज पर क्या करता है, यह जानने के लिए Email metrics देखें।

बाद में बदलना

Tracking-hostname में बदलाव उसी तरह स्टेज किए जाते हैं जैसे return-path में: पहले से वेरिफ़ाइड hostname को कभी किसी अनवेरिफ़ाइड hostname से नहीं बदला जाता। हम नए tracking CNAME को सक्रिय CNAME के साथ वेरिफ़ाई करते हैं और नया रिकॉर्ड पास होने पर ही उसे प्रमोट करते हैं, ताकि बदलाव के बीच ब्रांडेड ट्रैकिंग कभी न टूटे। स्वैप के बाद, पुराने रिकॉर्ड deprecated के रूप में रिपोर्ट किए जाते हैं, और पहले भेजे गए ईमेल में ट्रैक किए गए लिंक रिज़ॉल्व होते रहते हैं।

हटाना

इसे हटाने के दो तरीके हैं, जिनका प्रभाव अलग-अलग है:

tracking: null के साथ अपडेट करके डोमेन से ट्रैकिंग हटाएँ। पहले दोनों ट्रैकिंग सेटिंग off होनी चाहिए; अन्यथा अपडेट 409 लौटाता है। भेजने पर कोई प्रभाव नहीं पड़ता, नए भेजाव ब्रांडेड ट्रैकिंग का उपयोग बंद कर देते हैं, और पहले भेजे गए ईमेल में लिंक रिज़ॉल्व होते रहते हैं जबकि पुराने रिकॉर्ड deprecated के रूप में रिपोर्ट किए जाते हैं।
जब आप hostname को पुन: उपयोग के लिए मुक्त करना चाहें तो release endpoint से hostname रिलीज़ करें। एक tracking hostname प्रति रीजन एक ऑर्गनाइज़ेशन द्वारा क्लेम किया जाता है, इसलिए जब तक आप इसे होल्ड करते हैं कोई अन्य ऑर्गनाइज़ेशन इसे रजिस्टर नहीं कर सकता। रिलीज़ करने से tracking कॉन्फ़िगरेशन हटता है, दोनों ट्रैकिंग सेटिंग off होती हैं, और आपका क्लेम समाप्त होता है। यह हार्ड रिमूवल है: पहले डिलीवर किए गए मैसेज में ट्रैक किए गए लिंक तब रिज़ॉल्व होना बंद कर देते हैं जब आपकी ऑर्गनाइज़ेशन में कोई अन्य डोमेन उसी hostname का उपयोग नहीं करता।

अगर आप नए hostname पर माइग्रेट कर रहे हैं, तो रिलीज़ करने के बजाय बदलाव स्टेज करें: अपडेट से स्वैप करें, नया CNAME वेरिफ़ाई होने दें, और पुराने लिंक काम करते रहेंगे।

अगले कदम

Email metrics: ओपन और क्लिक ट्रैकिंग क्या रिकॉर्ड करती है, और प्रति-भेजाव फ़्लैग
Sending domains: डोमेन रजिस्टर करना और वेरिफ़िकेशन लाइफ़साइकल
Bounce domain: आवश्यक return-path hostname
DKIM, SPF & DMARC: डोमेन पर हर रिकॉर्ड और वह क्या प्रमाणित करता है