ग्रो करें

डीप लिंक

डीप लिंक आपके इंस्टॉल किए गए ऐप के अंदर कोई खास स्क्रीन खोलता है, जैसे कोई चैलेंज, रेफ़रल इनवाइट या प्रोडक्ट पेज। अगर ऐप इंस्टॉल नहीं है, तो विज़िटर इसके बजाय स्टोर पर जाता है, ठीक आपके स्मार्ट लिंक की तरह। डीप लिंक Pro, Studio और आजीवन प्लान पर उपलब्ध हैं। यूनिवर्सल लिंक और Android ऐप लिंक के लिए कस्टम डोमेन भी चाहिए, जो Studio का हिस्सा है।

डीप लिंक कैसे काम करता है

अपने स्मार्ट लिंक में /open/ और ऐप के अंदर का पाथ जोड़ें। क्वेरी स्ट्रिंग भी साथ में आगे भेजी जाती है:

https://mapps.one/habitly/open/challenges/30-days?ref=newsletter

विज़िटर	क्या होता है
iPhone या iPad, जब iOS URL स्कीम सेट हो	एक छोटा पेज `habitly://challenges/30-days?ref=newsletter` खोलने की कोशिश करता है। अगर ऐप इंस्टॉल नहीं है, तो विज़िटर आगे App Store पर पहुंच जाता है।
Android या Huawei, जब पैकेज नेम सेट हो	एक छोटा पेज उसी पाथ के लिए Android इंटेंट खोलता है, जो सिर्फ़ आपके पैकेज तक सीमित होता है। ऐप इंस्टॉल होने पर Chrome उसे खोल देता है, वरना फ़ॉलबैक के ज़रिए Google Play पर ले जाता है।
फ़ोन या टैबलेट, जब उसके प्लेटफ़ॉर्म के लिए कोई डीप लिंक सेटिंग न हो	सीधे फ़ॉलबैक पर रीडायरेक्ट किया जाता है।
डेस्कटॉप कंप्यूटर और बॉट	क्वेरी स्ट्रिंग बनाए रखते हुए स्मार्ट लिंक पर रीडायरेक्ट किया जाता है।

फ़ॉलबैक वही जगह है जहां आपका स्मार्ट लिंक उस डिवाइस को आपके रीडायरेक्ट नियमों के मुताबिक भेजता, और इसमें UTM टैग भी आगे भेजे जाते हैं। अगर उस प्लेटफ़ॉर्म के लिए कोई स्टोर लिंक नहीं है, तो फ़ॉलबैक लैंडिंग पेज होता है। अगर डीप लिंक बिल्कुल सेट नहीं हैं, या प्लान में शामिल नहीं हैं, तो हर विज़िटर को स्मार्ट लिंक पर रीडायरेक्ट किया जाता है।

पाथ में अक्षर, अंक और / _ - . ~ % कैरेक्टर हो सकते हैं। दूसरे कैरेक्टर हटा दिए जाते हैं, इसलिए बाकी सब कुछ परसेंट-एनकोड करें, जैसे स्पेस (%20)।

सेट अप करें

ऐप का डीप लिंक टैब खोलें और जिन प्लेटफ़ॉर्म को आप सपोर्ट करते हैं उनके फ़ील्ड भरें:

फ़ील्ड	उदाहरण	किसलिए इस्तेमाल होता है
iOS URL स्कीम	`habitly://`	iPhone और iPad पर रीडायरेक्ट पेज से ऐप खोलना
Apple Team ID	`A1B2C3D4E5`	यूनिवर्सल लिंक। आपके Apple Developer अकाउंट के Membership details में मौजूद 10 कैरेक्टर की ID।
iOS Bundle ID	`com.habitly.app`	यूनिवर्सल लिंक
Android पैकेज नेम	`com.habitly.app`	Android और Huawei डिवाइस पर ऐप खोलना
Android स्कीम	`habitly`	वह स्कीम जिसे आपका इंटेंट फ़िल्टर हैंडल करता है
SHA-256 सर्टिफ़िकेट फ़िंगरप्रिंट	`14:6D:E9:83:...:44:E5`	Android ऐप लिंक। एक या ज़्यादा फ़िंगरप्रिंट जोड़ें, जिन्हें कॉमा, स्पेस या नई लाइन से अलग किया गया हो।

Android स्कीम: इसे उस कस्टम स्कीम पर सेट करें जिसे आपका ऐप रजिस्टर करता है, जैसे habitly। अगर आप इसे खाली छोड़ते हैं, तो https इस्तेमाल होता है और पाथ का पहला हिस्सा होस्ट बन जाता है (https://challenges/30-days)। यह तभी काम करता है जब आपका इंटेंट फ़िल्टर ऐसा ही URL मानकर चलता हो।

अपने ऐप में स्कीम रजिस्टर करें

iOS, Info.plist में:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>habitly</string>
    </array>
  </dict>
</array>

Android, AndroidManifest.xml में:

<activity android:name=".MainActivity" android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="habitly" />
  </intent-filter>
</activity>

अपने ऐप में आने वाला URL पढ़ें, उससे मेल खाती स्क्रीन पर ले जाएं और ज़रूरत के क्वेरी पैरामीटर पढ़ें। अनजान पाथ को होम स्क्रीन पर भेजें, क्योंकि लोग URL एडिट करते हैं।

यूनिवर्सल लिंक और Android ऐप लिंक

स्कीम लिंक पहले एक छोटा रीडायरेक्ट पेज दिखाते हैं, और iOS विज़िटर से पुष्टि करने को कह सकता है। वेरिफ़ाइड लिंक यह चरण छोड़ देते हैं: ऐप इंस्टॉल होने पर सिस्टम उसे सीधे खोल देता है। वेरिफ़िकेशन के लिए ऐसा डोमेन चाहिए जो सिर्फ़ आपके ऐप का हो, इसलिए यह आपके कस्टम डोमेन पर काम करता है। get.habitly.app जुड़ जाने के बाद, mapps.one आपके लिए एसोसिएशन फ़ाइलें सर्व करता है:

फ़ाइल	किस जानकारी से बनती है
`https://get.habitly.app/.well-known/apple-app-site-association` (`/apple-app-site-association` पर भी)	Apple Team ID और Bundle ID
`https://get.habitly.app/.well-known/assetlinks.json`	Android पैकेज नेम और SHA-256 फ़िंगरप्रिंट

Apple फ़ाइल /open/ के तहत आने वाले हर पाथ को कवर करती है:

{
  "applinks": {
    "details": [
      {
        "appIDs": ["A1B2C3D4E5.com.habitly.app"],
        "components": [
          { "/": "/open/*", "comment": "Deep links created with mapps.one" }
        ]
      }
    ]
  },
  "webcredentials": { "apps": ["A1B2C3D4E5.com.habitly.app"] }
}

Android फ़ाइल:

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.habitly.app",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
      ]
    }
  }
]

हर फ़ाइल तब तक "404 Not Found" लौटाती है जब तक उसके फ़ील्ड मान्य न हों: Apple के लिए 10 कैरेक्टर की Team ID और एक Bundle ID, और Android के लिए एक पैकेज नेम के साथ AA:BB:... फ़ॉर्मेट (32 जोड़े) में कम से कम एक फ़िंगरप्रिंट। Play Console → App integrity से Play App Signing कुंजी का फ़िंगरप्रिंट इस्तेमाल करें, और अगर आप लोकली साइन किए गए बिल्ड टेस्ट करते हैं तो अपनी अपलोड कुंजी का फ़िंगरप्रिंट भी जोड़ें। फ़ाइलें एक घंटे के लिए कैश की जाती हैं। Apple भी इन्हें अपने सर्वर पर कैश करता है, इसलिए बदलाव टेस्ट करने के लिए ऐप को दोबारा इंस्टॉल करें।

अपना ऐप कॉन्फ़िगर करें

iOS: applinks:get.habitly.app के साथ Associated Domains कैपेबिलिटी जोड़ें।

Android: अपने डोमेन के लिए एक वेरिफ़ाइड इंटेंट फ़िल्टर जोड़ें:

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="get.habitly.app" android:pathPrefix="/open/" />
</intent-filter>

फिर अपने कैंपेन में https://get.habitly.app/open/challenges/30-days जैसे लिंक इस्तेमाल करें। ऐप इंस्टॉल न होने पर ब्राउज़र पेज लोड करता है और वही फ़ॉलबैक प्रक्रिया चलती है।

वेरिफ़ाइड लिंक में अपना डोमेन इस्तेमाल करें। एसोसिएशन फ़ाइलें सिर्फ़ कस्टम डोमेन पर सर्व की जाती हैं, क्योंकि mapps.one को बहुत सारे ऐप शेयर करते हैं। mapps.one/habitly/open/ वाले लिंक रीडायरेक्ट पेज के ज़रिए काम करते रहते हैं। डैशबोर्ड और API में दिखाए गए डीप लिंक URL में mapps.one होता है, इसलिए वेरिफ़ाइड लिंक चाहिए हों तो होस्ट को अपने डोमेन से बदल दें।

एनालिटिक्स

जब कोई फ़ोन या टैबलेट /open/ URL लोड करता है और mapps.one ऐप खोलने की कोशिश करता है, तब डीप लिंक ओपन में एक ओपन गिना जाता है। स्टोर पर होने वाले फ़ॉलबैक को दोबारा नहीं गिना जाता। ऐप को सीधे खोलने वाले वेरिफ़ाइड लिंक कभी mapps.one तक नहीं पहुंचते, इसलिए उन्हें गिना नहीं जाता। उनके लिए अपने ऐप के एनालिटिक्स इस्तेमाल करें।