Firebase Dynamic Links: ano ito, paggawa ng mga link at pagsasama

Ano ang Firebase Dynamic Links

Firebase Dynamic Links ay teknolohiya ng Google na gumagawa ng iisang link na humahantong sa nais na nilalaman sa mobile app o website, inaangkop ang pag-uugali depende sa platform at katayuan ng pag-install. Sinusuri ng link kung naka-install ang app sa device: kung oo — binuksan ito kasama ang pagpapasa ng mga parameter, kung hindi — idinidirekta sa Google Play o App Store para sa pag-install, at pagkatapos ng pag-install ay nagre-redirect sa target na screen.

Pangunahing tampok: Deferred Deep Linking

Ang pangunahing bentahe ng Dynamic Links kumpara sa mga ordinaryong deep link ay ang suporta para sa mga deferred deep link. Deferred Deep Linking ay nangangahulugan na ang konteksto ng paglipat (mga parameter ng link) ay pinapanatili kahit hindi pa naka-install ang app. Kapag ini-install ng user ang app mula sa store, binabasa ng Dynamic Links SDK ang naka-save na konteksto at ipinapasa ito sa tamang screen. Kung wala ang teknolohiyang ito, pagkatapos ng pag-install ay mapupunta lang ang user sa pangunahing screen, mawawala ang promo code, imbitasyon, o link sa partikular na order.

Mga lugar ng aplikasyon

Ginagamit ang Dynamic Links sa mga referral program para makaakit ng mga bagong user na naka-link sa account ng nag-imbita. Mga kampanya sa marketing na may mga transition mula sa email newsletter at social media ay gumagamit ng Dynamic Links para sa tumpak na pagsukat ng conversion. Sa mga onboarding scenario, dinadala ng link ang bagong user sa welcome screen na may personalized na nilalaman. Sa e-commerce, pinapanatili ng mga link ng produkto ang konteksto at humahantong sa product card kahit sa unang paglunsad pagkatapos ng pag-install.

Paano gumagana ang mga dynamic na link

Mekanismo ng paggana ng Dynamic Links ay binubuo ng ilang yugto, na ang bawat isa ay maaaring mag-iba depende sa estado ng app. Kapag nag-click ang user sa isang dynamic na link, nagpapadala ang browser ng kahilingan sa server ng Firebase. Sinusuri ng Firebase kung naka-install ang app sa pamamagitan ng pag-verify ng intent-filter o universal link. Kung naka-install ang app, binuksan ito ng Firebase kasama ang pagpapasa ng deep link. Kung hindi — nagre-redirect sa pahina ng store o bersyon ng web.

Anatomy ng isang dynamic na link

Ang isang karaniwang Dynamic Link ay binubuo ng base URL, mga parameter ng link, at mga opsyonal na marketing tag. Ang base URL ay isang domain na may anyong your-app.page.link, na naka-rehistro sa Firebase Console. Ang mga parameter ng deep link ay tinutukoy sa pamamagitan ng query parameters: link (target na URL sa loob ng app), apn (Android Package Name), ibi (iOS Bundle ID), st at sd (titulo at deskripsyon para sa social preview). Ang mga marketing tag na utm_source, utm_medium, utm_campaign ay ipinapasa sa Google Analytics para sa pagsubaybay.

Paggawa ng mga link sa pamamagitan ng Firebase Console at API

Firebase Console ay nagbibigay ng visual na interface para sa paggawa ng Dynamic Links sa seksyong Engage > Dynamic Links. Sa console, maaaring itakda ang lahat ng parameter ng link, kabilang ang deep link, pag-uugali sa web, social metadata, at UTM tag. Pagkatapos gumawa ng link, nagbibigay ang console ng handa nang URL pati na rin ang mga istatistika ng pag-click at paglipat. Para sa maramihang paggawa ng mga link, ginagamit ang REST API ng Firebase Dynamic Links na may OAuth 2.0 authentication.

Paggawa ng link sa pamamagitan ng REST API

Para sa programmatic na paggawa ng Dynamic Links, ginagamit ang POST request sa Firebase Dynamic Links API. Ang body ng request ay naglalaman ng dynamicLinkInfo na may mga parameter ng deep link, mga setting ng platform, at social metadata. Ibinabalik ng API ang handa nang URL na may anyong https://your-app.page.link/abc123. Para sa pangmatagalang link, ginagamit ang suffix.option = UNIQUE — mga maikling link na may natatanging suffix. Para sa pansamantalang link — SHORT, na may posibilidad ng banggaan.

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: "Summer promo",
            socialDescription: "Mga diskwento hanggang 50% hanggang katapusan ng buwan"
        }
    },
    suffix: { option: "UNIQUE" }
}

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

Mga maikling link at UTM tag

Awtomatikong bumubuo ang Dynamic Links ng mga maikling URL na may haba na 6–8 character pagkatapos ng domain, na ginagawang angkop ang mga ito para sa paggamit sa SMS at social media. Ang mga parameter ng UTM ay idinaragdag sa pamamagitan ng field na utmParameters o direkta sa parameter ng link. Awtomatikong iniuugnay ng Firebase ang mga pag-click sa Dynamic Links sa Google Analytics para sa Firebase, na nagpapahintulot sa pagsubaybay ng referral traffic at attribution ng kampanya.

Pagsasama ng Dynamic Links sa Android

Konfigurasyon ng Dynamic Links sa Android ay kinabibilangan ng pagdaragdag ng Firebase SDK, pag-configure ng intent-filter para sa aktibidad na tumatanggap ng mga deep link, at pagproseso ng mga link sa pamamagitan ng Firebase Dynamic Links SDK. Pagkatapos i-install ang SDK at idagdag ang google-services.json, dapat i-rehistro ang aktibidad sa AndroidManifest.xml na may intent-filter para sa pagproseso ng mga link mula sa domain ng app.

Pag-configure ng intent-filter sa AndroidManifest

Ang aktibidad na nagpoproseso ng Dynamic Links ay dapat magkaroon ng intent-filter para sa action na VIEW at mga kategoryang DEFAULT at BROWSABLE. Ang AndroidManifest.xml ay naglalaman ng data tag na may android:scheme, android:host, at android:pathPrefix na tumutugma sa iyong deep link. Para sa pagproseso ng mga link mula sa domain na page.link, idinaragdag din ang intent-filter na may scheme na https at host ng iyong Dynamic Links domain.

<!-- 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>

Pagproseso ng link sa code

Pagkatapos i-configure ang intent-filter, dapat iproseso ang papasok na Dynamic Link sa code ng aktibidad. FirebaseDynamicLinks API ay kumukuha ng link mula sa intent at nagbabalik ng PendingDynamicLinkData object na may mga extract na parameter. Ang getLink method ay nagbabalik ng target na deep link na maaaring suriin at gamitin para sa nabigasyon. Mahalagang iproseso ang link pareho sa malamig na start (sa pamamagitan ng getIntent sa onCreate) at sa mainit na start (sa pamamagitan ng onNewIntent).

Pagsasama ng Dynamic Links sa iOS

Konfigurasyon ng Dynamic Links sa iOS ay nangangailangan ng konfigurasyon pareho sa panig ng Firebase at sa proyekto ng Xcode. Ang APNs key ay dapat i-upload sa Firebase Console, idagdag ang Firebase SDK sa pamamagitan ng Swift Package Manager o CocoaPods, at i-configure ang App Delegate para sa pagproseso ng Universal Links. Ang Dynamic Links sa iOS ay gumagamit ng Universal Links para sa seamless na paglipat sa pagitan ng browser at app nang walang intermediate na pahina.

Pag-configure ng Universal Links

Ang Universal Links ay teknolohiya ng Apple na nag-uugnay ng iyong domain sa mobile app. Ang file na apple-app-site-association (AASA) ay na-load sa server sa https://your-app.page.link/apple-app-site-association. Awtomatikong ginagawa at pinapanatili ng Firebase ang file na ito para sa iyong Dynamic Links domain. Sa Xcode, dapat i-activate ang Associated Domains at tukuyin ang applinks:your-app.page.link sa Capabilities ng proyekto.

Pagproseso ng link sa pamamagitan ng Firebase SDK

Para sa iOS, ang pagproseso ng Dynamic Links ay ginagawa sa pamamagitan ng Firebase SDK sa App Delegate o Scene Delegate. Ang pamamaraang application:continueUserActivity: ay humaharang sa papasok na Universal Link at ipinapasa ito sa Firebase Dynamic Links API, na kumukuha ng target na link at mga parameter. Awtomatikong pinoproseso ng Firebase SDK ang Deferred Deep Links, humihiling ng data ng pag-install sa pamamagitan ng panandaliang imbakan ng Firebase Installation API.

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)
                }
            }
    }
}

Halimbawa ng implementasyon sa Kotlin

Tingnan natin ang kumpletong halimbawa ng pagproseso ng Dynamic Link sa Android app sa Kotlin. MainActivity ay nagbabasa ng papasok na Dynamic Link pareho sa malamig at mainit na start ng app. Ang link ay hinihiwa-hiwalay sa mga parameter na ginagamit para sa nabigasyon sa tamang screen na may pagpapasa ng mga argumento. Ipinapakita ng halimbawa ang pagproseso ng link sa pahina ng promosyon na may ID ng promosyon.

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", "Error sa pagproseso ng link", e)
            }
    }
}

Pag-test ng Dynamic Links

Para sa pag-test ng Dynamic Links, ginagamit ang Firebase Console, kung saan maaaring gumawa ng test link at ipadala sa device sa pamamagitan ng messenger o email. Firebase Dynamics Links Debugger ay available sa URL na https://your-app.page.link/?d=1 at nagpapakita ng detalyadong impormasyon tungkol sa pag-uugali ng link. Kapag nagte-test ng Deferred Deep Links, dapat tiyakin na ang app ay naka-uninstall, at pagkatapos ng pag-install ang link ay humahantong sa tamang screen na may mga ipinasa na parameter.