Firebase Dynamic Links: यह क्या है, लिंक बनाना और एकीकरण

Firebase Dynamic Links क्या हैं

Firebase Dynamic Links Google की एक तकनीक है जो एक एकल लिंक बनाती है जो मोबाइल ऐप या वेबसाइट में वांछित सामग्री तक ले जाती है, प्लेटफ़ॉर्म और इंस्टॉलेशन स्थिति के अनुसार व्यवहार को अनुकूलित करती है। लिंक जाँचता है कि ऐप डिवाइस पर इंस्टॉल है या नहीं: यदि हाँ — तो पैरामीटर पास करके ऐप खोलता है, यदि नहीं — तो इंस्टॉलेशन के लिए Google Play या App Store पर रीडायरेक्ट करता है, और इंस्टॉलेशन के बाद लक्ष्य स्क्रीन पर रीडायरेक्ट करता है।

मुख्य विशेषता: Deferred Deep Linking

सामान्य डीप लिंक की तुलना में Dynamic Links का मुख्य लाभ डिफर्ड डीप लिंक का समर्थन है। Deferred Deep Linking का अर्थ है कि ट्रांज़िशन कॉन्टेक्स्ट (लिंक पैरामीटर) संरक्षित रहता है भले ही ऐप अभी तक इंस्टॉल न हुआ हो। जब उपयोगकर्ता स्टोर से ऐप इंस्टॉल करता है, Dynamic Links SDK सहेजे गए कॉन्टेक्स्ट को पढ़ता है और वांछित स्क्रीन पर पास करता है। इस तकनीक के बिना, उपयोगकर्ता इंस्टॉलेशन के बाद केवल मुख्य स्क्रीन पर पहुँचता, प्रोमो कोड, निमंत्रण या किसी विशिष्ट ऑर्डर का लिंक खो देता।

उपयोग के मामले

Dynamic Links रेफरल प्रोग्राम में आमंत्रित करने वाले के खाते से जुड़े नए उपयोगकर्ताओं को आकर्षित करने के लिए उपयोग किए जाते हैं। मार्केटिंग अभियान ईमेल न्यूज़लेटर और सोशल नेटवर्क से ट्रांज़िशन के साथ सटीक रूपांतरण मापन के लिए Dynamic Links का उपयोग करते हैं। ऑनबोर्डिंग परिदृश्यों में, लिंक नए उपयोगकर्ता को वैयक्तिकृत सामग्री के साथ स्वागत स्क्रीन पर ले जाता है। ई-कॉमर्स में, उत्पाद लिंक कॉन्टेक्स्ट संरक्षित रखते हैं और इंस्टॉलेशन के बाद पहले लॉन्च पर भी उत्पाद कार्ड तक ले जाते हैं।

डायनामिक लिंक कैसे काम करते हैं

कार्य तंत्र Dynamic Links कई चरणों से मिलकर बना है, जिनमें से प्रत्येक ऐप स्थिति के अनुसार भिन्न हो सकता है। जब उपयोगकर्ता डायनामिक लिंक पर क्लिक करता है, ब्राउज़र Firebase सर्वर पर एक अनुरोध भेजता है। Firebase intent-filter या universal link जाँच के माध्यम से जाँचता है कि ऐप इंस्टॉल है या नहीं। यदि ऐप इंस्टॉल है, Firebase डीप लिंक पास करके उसे खोलता है। यदि नहीं — स्टोर पेज या वेब संस्करण पर रीडायरेक्ट करता है।

डायनामिक लिंक की संरचना

एक मानक Dynamic Link में बेस URL, लिंक पैरामीटर और वैकल्पिक मार्केटिंग टैग होते हैं। बेस URL — your-app.page.link जैसा डोमेन Firebase Console में पंजीकृत होता है। डीप लिंक पैरामीटर क्वेरी पैरामीटर के माध्यम से सेट किए जाते हैं: link (ऐप के अंदर लक्ष्य URL), apn (Android Package Name), ibi (iOS Bundle ID), st और sd (सोशल प्रीव्यू के लिए शीर्षक और विवरण)। मार्केटिंग टैग utm_source, utm_medium, utm_campaign ट्रैकिंग के लिए Google Analytics में भेजे जाते हैं।

Firebase Console और API के माध्यम से लिंक बनाना

Firebase Console Engage > Dynamic Links अनुभाग में Dynamic Links बनाने के लिए एक विज़ुअल इंटरफ़ेस प्रदान करता है। कंसोल में, आप लिंक के सभी पैरामीटर सेट कर सकते हैं, जिसमें डीप लिंक, वेब व्यवहार, सोशल मेटाडेटा और UTM टैग शामिल हैं। लिंक बनाने के बाद, कंसोल एक तैयार URL के साथ-साथ क्लिक और ट्रांज़िशन पर आँकड़े प्रदान करता है। बल्क लिंक निर्माण के लिए, OAuth 2.0 प्रमाणीकरण के साथ Firebase Dynamic Links REST API का उपयोग किया जाता है।

REST API के माध्यम से लिंक बनाना

Dynamic Links के प्रोग्रामेटिक निर्माण के लिए, Firebase Dynamic Links API को POST अनुरोध भेजा जाता है। अनुरोध निकाय में डीप लिंक पैरामीटर, प्लेटफ़ॉर्म सेटिंग्स और सोशल मेटाडेटा के साथ dynamicLinkInfo होता है। API https://your-app.page.link/abc123 जैसा तैयार URL लौटाता है। लंबे समय तक चलने वाले लिंक के लिए, suffix.option = UNIQUE का उपयोग किया जाता है — अद्वितीय सफ़िक्स वाले छोटे लिंक। अस्थायी लिंक के लिए — SHORT, संभावित टकराव के साथ।

const axios = require("axios")

const apiUrl = "https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=API_KEY"

const data = {
    dynamicLinkInfo: {
        domainUriPrefix: "https://yourapp.page.link",
        link: "https://yourapp.com/promo/summer",
        androidInfo: { androidPackageName: "com.example.myapp" },
        iosInfo: { iosBundleId: "com.example.myapp.ios" },
        socialMetaTagInfo: {
            socialTitle: "ग्रीष्मकालीन प्रचार",
            socialDescription: "महीने के अंत तक 50% तक की छूट"
        }
    },
    suffix: { option: "UNIQUE" }
}

axios.post(apiUrl, data)
    .then(res => console.log(res.data.shortLink))
    .catch(err => console.error(err))

छोटे लिंक और UTM टैग

Dynamic Links स्वचालित रूप से डोमेन के बाद 6–8 वर्णों वाले छोटे URL उत्पन्न करते हैं, जो उन्हें SMS और सोशल नेटवर्क में उपयोग के लिए उपयुक्त बनाता है। UTM पैरामीटर utmParameters फ़ील्ड या सीधे link पैरामीटर में जोड़े जाते हैं। Firebase स्वचालित रूप से Dynamic Links पर क्लिक को Firebase के लिए Google Analytics से जोड़ता है, जिससे रेफरल ट्रैफ़िक और अभियान एट्रिब्यूशन को ट्रैक किया जा सकता है।

Android में Dynamic Links एकीकृत करना

Android में Dynamic Links सेट अप करना में Firebase SDK जोड़ना, डीप लिंक प्राप्त करने वाली activity के लिए intent-filter कॉन्फ़िगर करना और Firebase Dynamic Links SDK के माध्यम से लिंक प्रोसेस करना शामिल है। SDK स्थापित करने और google-services.json जोड़ने के बाद, आपको अपने ऐप के डोमेन से लिंक प्रोसेस करने के लिए AndroidManifest.xml में intent-filter के साथ activity पंजीकृत करनी होगी।

AndroidManifest में intent-filter सेट अप करना

Dynamic Links प्रोसेस करने वाली activity में VIEW क्रिया और DEFAULT तथा BROWSABLE श्रेणियों के लिए intent-filter होना चाहिए। AndroidManifest.xml में आपके डीप लिंक से मेल खाने वाले android:scheme, android:host और android:pathPrefix के साथ data टैग शामिल है। page.link डोमेन से लिंक प्रोसेस करने के लिए, https स्कीम और आपके Dynamic Links डोमेन होस्ट के साथ intent-filter भी जोड़ा जाता है।

<!-- AndroidManifest.xml -->
<activity android:name=".MainActivity">
    <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="https"
            android:host="yourapp.com"
            android:pathPrefix="/promo" />
    </intent-filter>
</activity>

कोड में लिंक प्रोसेस करना

intent-filter सेट करने के बाद, Activity कोड में इनकमिंग Dynamic Link को प्रोसेस करना आवश्यक है। FirebaseDynamicLinks API intent से लिंक प्राप्त करता है और निकाले गए पैरामीटर के साथ PendingDynamicLinkData ऑब्जेक्ट लौटाता है। getLink मेथड लक्ष्य डीप लिंक लौटाता है, जिसे पार्स करके नेविगेशन के लिए उपयोग किया जा सकता है। कोल्ड स्टार्ट (onCreate में getIntent के माध्यम से) और हॉट स्टार्ट (onNewIntent के माध्यम से) दोनों पर लिंक को हैंडल करना महत्वपूर्ण है।

iOS में Dynamic Links एकीकृत करना

iOS में Dynamic Links सेट अप करना के लिए Firebase पक्ष और Xcode प्रोजेक्ट दोनों पर कॉन्फ़िगरेशन की आवश्यकता है। आपको Firebase Console में APNs कुंजी अपलोड करनी होगी, Swift Package Manager या CocoaPods के माध्यम से Firebase SDK जोड़ना होगा और Universal Links को हैंडल करने के लिए App Delegate कॉन्फ़िगर करना होगा। iOS में Dynamic Links ब्राउज़र और ऐप के बीच बिना किसी मध्यवर्ती पृष्ठ के सहज संक्रमण के लिए Universal Links का उपयोग करते हैं।

Universal Links सेट अप करना

Universal Links Apple की एक तकनीक है जो आपके डोमेन को मोबाइल ऐप से जोड़ती है। apple-app-site-association (AASA) फ़ाइल https://your-app.page.link/apple-app-site-association पर सर्वर पर अपलोड की जाती है। Firebase आपके Dynamic Links डोमेन के लिए स्वचालित रूप से यह फ़ाइल बनाता और बनाए रखता है। Xcode में, आपको Associated Domains सक्षम करना होगा और प्रोजेक्ट क्षमताओं में applinks:your-app.page.link निर्दिष्ट करना होगा।

Firebase SDK के माध्यम से लिंक प्रोसेस करना

iOS के लिए, Dynamic Links प्रोसेसिंग App Delegate या Scene Delegate में Firebase SDK के माध्यम से की जाती है। application:continueUserActivity: मेथड इनकमिंग Universal Link को इंटरसेप्ट करता है और Firebase Dynamic Links API को पास करता है, जो लक्ष्य लिंक और पैरामीटर निकालता है। Firebase SDK स्वचालित रूप से Firebase Installation API अल्पकालिक स्टोरेज के माध्यम से इंस्टॉलेशन डेटा का अनुरोध करके Deferred Deep Links को हैंडल करता है।

import FirebaseDynamicLinks

class AppDelegate: UIApplicationDelegate {

    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: @escaping
            ([UIUserActivityRestoring]?) -> Void
    ) -> Bool {
        return DynamicLinks.dynamicLinks()
            .handleUniversalLink(userActivity.webpageURL!) {
                dynamicLink, error in
                if let link = dynamicLink?.url {
                    self.handleDeepLink(link)
                }
            }
    }
}

Kotlin में कार्यान्वयन उदाहरण

आइए Kotlin का उपयोग करके Android ऐप में Dynamic Link प्रोसेस करने का पूरा उदाहरण देखें। MainActivity ऐप के कोल्ड और हॉट स्टार्ट दोनों पर इनकमिंग Dynamic Link को पढ़ता है। लिंक को पैरामीटर में पार्स किया जाता है जिसका उपयोग आर्गुमेंट पास करके वांछित स्क्रीन पर नेविगेशन के लिए किया जाता है। उदाहरण प्रोमो अभियान पहचानकर्ता के साथ प्रचार पृष्ठ के लिंक की प्रोसेसिंग दिखाता है।

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        handleDynamicLink(intent)
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        handleDynamicLink(intent)
    }

    private fun handleDynamicLink(intent: Intent) {
        FirebaseDynamicLinks.getInstance()
            .getDynamicLink(intent)
            .addOnSuccessListener { data ->
                val deepLink = data?.link ?: return@addOnSuccessListener
                val promoId = deepLink
                    .getQueryParameter("promoId") ?: ""
                if (promoId.isNotEmpty()) {
                    navigateToPromoScreen(promoId)
                }
            }
            .addOnFailureListener { e ->
                Log.e("DL", "लिंक प्रोसेसिंग त्रुटि", e)
            }
    }
}

Dynamic Links का परीक्षण

Dynamic Links के परीक्षण के लिए, Firebase Console का उपयोग किया जाता है, जहाँ आप एक परीक्षण लिंक बना सकते हैं और इसे मैसेंजर या ईमेल के माध्यम से डिवाइस पर भेज सकते हैं। Firebase Dynamic Links Debugger https://your-app.page.link/?d=1 पर उपलब्ध है और लिंक व्यवहार के बारे में विस्तृत जानकारी प्रदर्शित करता है। Deferred Deep Links का परीक्षण करते समय, सुनिश्चित करें कि ऐप अनइंस्टॉल है, और इंस्टॉलेशन के बाद लिंक पास किए गए पैरामीटर के साथ सही स्क्रीन पर ले जाए।