Firebase Dynamic Links: vad det är, hur det fungerar och används i utveckling

Vad är Firebase Dynamic Links?

Firebase Dynamic Links är en molntjänst från Google som skapar enhetliga universella länkar för mobila appar på iOS och Android. Den dynamiska länken innehåller en djup länk till innehåll i appen men beter sig som en vanlig HTTPS-länk: om appen är installerad öppnas den direkt, annars omdirigeras den till appbutiken.

Till skillnad från vanliga URL Schemes kan Dynamic Links fungera med oinstallerade appar tack vare tekniken deferred deep link. När användaren installerar appen efter att ha klickat på länken sparar Firebase övergångsparametrarna och skickar dem vid första starten. Detta öppnar möjligheter för hänvisningsprogram, marknadsföringskampanjer och inbjudningar.

Skillnad från vanliga URL Schemes

URL Schemes kräver en installerad app och har ingen standardmekanism för fallback. Firebase Dynamic Links löser detta problem genom en mellanliggande Firebase-webbtjänst som bestämmer appens installationsstatus på enheten och dirigerar användaren korrekt. En länk fungerar likadant på båda plattformarna.

Hur Firebase Dynamic Links fungerar

Firebase Dynamic Link använder en domän i formen yourcode.page.link, som registreras i Firebase Console. När en användare navigerar via en sådan länk bestämmer Firebase enhetstypen och appens installationsstatus. För iOS används Universal Links-mekanismen, för Android — App Links med automatisk verifiering via Digital Asset Links.

Bearbetningsprocessen omfattar flera på varandra följande steg: när användaren klickar på länken skickar webbläsaren en GET-begäran till Firebase-servern, servern bestämmer plattformen och kontrollerar om appen finns på enheten. Om appen är installerad — genereras en omdirigering till en Universal Link eller Intent med parametrar för att öppna målfönstret. Om appen inte är installerad — omdirigering till App Store eller Google Play för nedladdning.

Dynamic Links livscykel

Appen tar emot länken i initialiseringsfasen av Firebase SDK. Metoden getDynamicLink() returnerar ett PendingResult med data om övergången. Efter framgångsrik mottagning extraheras djup länk-parametrar, UTM-taggar för analys och godtyckliga data som skickades vid länkskapandet från länken.

Skapa Dynamic Link i Firebase Console

Firebase Console tillhandahåller ett visuellt gränssnitt för att skapa Dynamic Links. Utvecklaren anger den djupa länken (deep link URL), kampanjnamn, separata inställningar för iOS och Android samt analysparametrar. Efter skapandet genererar Firebase en kort länk i formen https://yourcode.page.link/abc123 som kan användas i reklammaterial, e-postkampanjer och sociala medier.

För programmeringsmässig skapande av Dynamic Links används Firebase REST API eller klientens SDK. REST API möjliggör massgenerering av länkar för marknadsföringskampanjer med anpassade parametrar, inklusive en länk för sociala medier och asynkron övergångsanalys. Vid skapande av länkar via API är det viktigt att korrekt ange parametrarna socialMetaTagInfo — de bestämmer hur länken visas vid delning i meddelandeappar och sociala nätverk med ett förhandsgranskningskort.

Dynamic Link-parametrar

Konfigurera Dynamic Links i iOS

För att arbeta med Firebase Dynamic Links på iOS måste Firebase SDK anslutas via CocoaPods eller Swift Package Manager, Info.plist konfigureras med GOOGLE_APP_ID och domänen för Dynamic Links registreras i projektets Associated Domains. Därefter bearbetar appen automatiskt de Universal Links som genererats av Firebase.

I Xcode måste funktionen Associated Domains läggas till med en post i formen applinks:yourcode.page.link. Firebase SDK använder metoden application(_:continue:restorationHandler:) för att bearbeta Universal Links, så ytterligare integration med AppDelegate krävs inte — Firebase extraherar automatiskt Dynamic Link-parametrarna från User Activity.

Konfiguration i Xcode

Exempel på Info.plist-konfiguration för korrekt initialisering av Firebase och registrering av Dynamic Links-hanteraren. Nyckeln FIROptions måste innehålla projektidentifikatorn från GoogleService-Info.plist.

<key>FirebaseDynamicLinksCustomDomains</key>
<array>
    <string>https://yourcode.page.link</string>
</array>
<key>FirebaseAppDelegateProxyEnabled</key>
<false/>

Om AppDelegate-proxyn är inaktiverad måste metoden handleUniversalLink(_:) anropas manuellt och User Activity från continue NSUserActivity skickas. Firebase SDK extraherar automatiskt länkparametrarna och returnerar DynamicLink via completion handler.

Konfigurera Dynamic Links i Android

På Android börjar integrationen av Firebase Dynamic Links med att lägga till beroenden i build.gradle och filen google-services.json från Firebase Console. Domänen för Dynamic Links registreras i Firebase Console, varefter alla länkar med denna domän automatiskt känns igen av Android-appen via ett Intent Filter med åtgärden VIEW. För korrekt funktion måste även plugin-programmet Google Services läggas till i rot- och modul-build.gradle och Gradle-synkronisering utföras.

För korrekt bearbetning av länkar på Android måste ett Intent Filter för Dynamic Links-domänen läggas till i den Activity som ska ta emot inkommande länkar. Filtret måste innehålla schemat https, värddatorn för din Dynamic Links-domän och standardsökvägen.

Intent Filter för Dynamic Links

Exempel på Intent Filter i AndroidManifest.xml för att ta emot Dynamic Links på domänen yourcode.page.link.

<activity android:name=".MainActivity"
    android:launchMode="singleTask">
    <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="yourcode.page.link" />
    </intent-filter>
</activity>

Det är viktigt att ställa in launchMode på singleTask för den Activity som tar emot Dynamic Links. Detta förhindrar att en ny Activity-instans skapas vid upprepad navigering via länken och möjliggör korrekt bearbetning av alla inkommande deep links i en enda instans.

Hantera mottagna länkar

Firebase SDK för Android tillhandahåller metoden FirebaseDynamicLinks.getInstance().getDynamicLink(intent), som returnerar ett PendingTask-objekt med data om länken. Från DynamicLink-objektet extraheras den djupa URI, UTM-parametrar och övergångens tidsstämpel. Bearbetning rekommenderas att utföras i metoderna onCreate() och onNewIntent() för Activity.

Vid bearbetning är det viktigt att ta hänsyn till att Dynamic Link kan tas emot både vid start av appen från kallt tillstånd (cold start) och vid övergång från en annan app till en redan igång app. För det andra fallet måste onNewIntent() åsidosättas och Dynamic Link-kontrollen anropas igen.

Bearbetning i Kotlin-kod

Exempel på mottagning och bearbetning av Firebase Dynamic Link i MainActivity. Koden hanterar både cold start och övergång från en annan app.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        checkDynamicLink(intent)
    }
    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        checkDynamicLink(intent)
    }
    private fun checkDynamicLink(intent: Intent) {
        FirebaseDynamicLinks.getInstance()
            .getDynamicLink(intent)
            .addOnSuccessListener link ->
                val deepLink = link?.link.toString()
                handleDeepLink(deepLink)
            }
    }
}

Metoden addOnSuccessListener returnerar DynamicLink, från vilken mållänken extraheras via link?.link. Om listenern returnerar null betyder det att Intent inte innehåller någon Dynamic Link — detta är en normal appstart utan inkommande länk. Även UTM-taggar finns tillgängliga för övergångsanalys, inklusive campaign, medium, source och content, som kan skickas till Google Analytics för detaljerad utvärdering av varje marknadsföringskanals effektivitet.