बेसिक्स

स्मार्ट लिंक और रीडायरेक्ट

आपका स्मार्ट लिंक, mapps.one/habitly, हर विज़िटर का डिवाइस देखता है और कुछ ही मिलीसेकंड में तय करता है कि उसे कहां भेजना है। यह पेज बताता है कि डिफ़ॉल्ट नियम क्या हैं, उन्हें कैसे बदलें, लिंक प्रीव्यू बॉट को क्या दिखता है और कैंपेन टैग स्टोर तक कैसे पहुंचते हैं।

डिफ़ॉल्ट रूटिंग

विज़िटर	कहां जाता है	अगर वह लिंक मौजूद नहीं है
iPhone, iPad, iPod	App Store	लैंडिंग पेज
Android	Google Play	लैंडिंग पेज
Huawei और Honor डिवाइस, HarmonyOS	AppGallery	Google Play, फिर लैंडिंग पेज
Windows	Microsoft Store	लैंडिंग पेज
macOS	App Store	लैंडिंग पेज
न पहचाने गए डिवाइस ("अन्य")	लैंडिंग पेज	—
Linux और ChromeOS	लैंडिंग पेज	—

डिवाइस की पहचान ब्राउज़र के यूज़र एजेंट से होती है। टैबलेट पर वही नियम लागू होते हैं जो उसी सिस्टम वाले फ़ोन पर। डेस्कटॉप साइट मांगने वाले iPad खुद को Mac के रूप में पहचानते हैं, फिर भी वे App Store पर ही पहुंचते हैं, क्योंकि macOS डिफ़ॉल्ट रूप से वहीं जाता है।

रीडायरेक्ट नियम

इन प्लेटफ़ॉर्म में से हर एक के लिए डेस्टिनेशन चुनने के लिए ऐप का लिंक टैब खोलें: iOS, Android, Huawei, Windows, macOS और अन्य। विकल्प ये हैं:

App Store, Google Play, AppGallery या Microsoft Store: उस स्टोर लिस्टिंग पर रीडायरेक्ट करें,
वेब URL: ऐप में सेव किए गए वेब पते पर रीडायरेक्ट करें, जैसे वेब वर्शन या वेटलिस्ट,
लैंडिंग पेज: स्मार्ट लिंक वाले पते पर ही लैंडिंग पेज दिखाएं।

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

उदाहरण: Habitly का कोई Mac ऐप नहीं है। macOS को लैंडिंग पेज पर सेट करें, ताकि Mac विज़िटर को Mac App Store में iPhone लिस्टिंग के बजाय स्क्रीनशॉट और दोनों स्टोर बैज दिखें।

रीडायरेक्ट Cache-Control: no-store के साथ HTTP 302 इस्तेमाल करते हैं, इसलिए ब्राउज़र और प्रॉक्सी उन्हें कैश नहीं करते और नियमों में किए गए बदलाव अगली विज़िट से ही लागू हो जाते हैं।

लिंक प्रीव्यू और बॉट

जब कोई आपका लिंक किसी चैट या पोस्ट में पेस्ट करता है, तो वह ऐप प्रीव्यू बनाने के लिए पेज फ़ेच करता है। इन क्रॉलर को हमेशा लैंडिंग पेज मिलता है, कभी रीडायरेक्ट नहीं, इसलिए प्रीव्यू में पेज के Open Graph टैग से आपके ऐप का नाम, टैगलाइन और इमेज दिखती है। यह Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom और Microsoft Teams जैसे कई प्लेटफ़ॉर्म पर लागू होता है।

सर्च इंजन क्रॉलर, SEO टूल, अपटाइम मॉनिटर, AI क्रॉलर और curl, wget या python-requests जैसे कमांड-लाइन क्लाइंट को भी बॉट माना जाता है। बॉट को लैंडिंग पेज मिलता है और उन्हें एनालिटिक्स में कभी नहीं गिना जाता।

इन-ऐप ब्राउज़र

Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit और Threads के अंदर खोले गए लिंक पहचाने जाते हैं। विज़िटर को किसी भी दूसरी विज़िट की तरह डिवाइस के हिसाब से रूट किया जाता है। एनालिटिक्स में, वह जिस ऐप से आया उसे ट्रैफ़िक सोर्स के रूप में दर्ज किया जाता है, भले ही ये ब्राउज़र आम तौर पर कोई रेफ़रर नहीं भेजते।

कैंपेन टैग

चैनलों की तुलना करने के लिए अपने स्मार्ट लिंक में स्टैंडर्ड UTM टैग जोड़ें:

https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launch

mapps.one आपके एनालिटिक्स में हमेशा utm_source, utm_medium और utm_campaign दर्ज करता है। स्टोर को कैंपेन पैरामीटर भेजें चालू होने पर (डिफ़ॉल्ट), टैग डेस्टिनेशन तक भी उसी फ़ॉर्मेट में भेजे जाते हैं जिसे वह समझता है:

डेस्टिनेशन	हम क्या जोड़ते हैं
Google Play	URL-एनकोड किए गए UTM टैग वाला एक `referrer` पैरामीटर, जिसे आपका ऐप Play Install Referrer API से पढ़ सकता है। `https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch`
App Store	एक `ct` कैंपेन टोकन: `utm_campaign` की वैल्यू, या कैंपेन न होने पर `utm_source` की, 40 कैरेक्टर तक। `https://apps.apple.com/app/id1612345678?ct=launch`
वेब URL	खुद UTM टैग। `https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch`
AppGallery, Microsoft Store	कुछ नहीं। लिस्टिंग बिना किसी अतिरिक्त पैरामीटर के खुलती है।

पांचों टैग आगे भेजे जाते हैं: utm_source, utm_medium, utm_campaign, utm_term और utm_content। हर वैल्यू को 100 कैरेक्टर तक छोटा कर दिया जाता है।

App Store कैंपेन के बारे में: App Store Connect किसी ct टोकन का श्रेय किसी कैंपेन को तभी देता है, जब लिंक में आपका प्रोवाइडर टोकन (pt) भी हो। स्टोर लिंक कैनोनिकल रूप में सेव किए जाते हैं, इसलिए आपके App Store लिंक में पेस्ट किया गया pt नहीं रखा जाता। चैनलों की तुलना करने के लिए mapps.one एनालिटिक्स में कैंपेन ब्रेकडाउन इस्तेमाल करें।

स्टोर बैज लिंक

लैंडिंग पेज पर मौजूद स्टोर बैज एक ट्रैक किए जाने वाले रीडायरेक्ट, mapps.one/habitly/go/{store}, की ओर इशारा करते हैं। क्लिक को स्टोर क्लिक के रूप में गिना जाता है, फिर विज़िटर को लिस्टिंग पर भेजा जाता है। अगर ऐप में उस स्टोर का कोई लिंक नहीं है, तो विज़िटर को वापस लैंडिंग पेज पर भेज दिया जाता है।

जब आपको डिवाइस चाहे जो भी हो, कोई खास स्टोर ही चाहिए, जैसे सिर्फ़ Android वाले कैंपेन में, तो आप ये URL खुद भी इस्तेमाल कर सकते हैं। किसी /go/ URL में जोड़े गए UTM टैग उसी तरह आगे भेजे जाते हैं जैसे स्मार्ट लिंक पर।

स्टोर कुंजी	URL
`app_store`	`mapps.one/habitly/go/app_store`
`google_play`	`mapps.one/habitly/go/google_play`
`app_gallery`	`mapps.one/habitly/go/app_gallery`
`microsoft_store`	`mapps.one/habitly/go/microsoft_store`
`web`	`mapps.one/habitly/go/web`

URL रेफ़रेंस

URL	उद्देश्य
`/habitly`	स्मार्ट लिंक: डिवाइस के हिसाब से रीडायरेक्ट, या लैंडिंग पेज
`/habitly/page`	हर डिवाइस पर लैंडिंग पेज
`/habitly/go/{store}`	किसी एक स्टोर पर ट्रैक किया जाने वाला रीडायरेक्ट
`/habitly/open/{path}`	इंस्टॉल किए गए ऐप में डीप लिंक
`/habitly/privacy`, `/habitly/privacy/{language}`	गोपनीयता नीति
`/habitly/terms`, `/habitly/terms/{language}`	सेवा की शर्तें
`/habitly/press`, `/habitly/press.zip`	प्रेस किट पेज और डाउनलोड
`/habitly/qr.svg`, `/habitly/qr.png`	स्मार्ट लिंक का QR कोड

जब कोई लिंक काम न करे

404 Not Found: कोई भी ऐप यह स्लग इस्तेमाल नहीं करता। स्पेलिंग जांचें, या देखें कि कहीं स्लग बदला तो नहीं गया।
410 Gone, "पॉज़ है": ऐप डैशबोर्ड में पॉज़ किया गया है। उसे फिर से चालू करें।
410 Gone, "अब उपलब्ध नहीं": ट्रस्ट एंड सेफ़्टी टीम ने ऐप को निलंबित कर दिया है। सपोर्ट से संपर्क करें।
हमेशा लैंडिंग पेज: उस प्लेटफ़ॉर्म के डेस्टिनेशन के लिए कोई लिंक सेव नहीं है, नियम लैंडिंग पेज पर सेट है, या आप किसी बॉट जैसे क्लाइंट से टेस्ट कर रहे हैं।