Firebase Dynamic Links: Was es ist, wie es funktioniert und in der Entwicklung verwendet wird

Was sind Firebase Dynamic Links?

Firebase Dynamic Links ist ein Cloud-Dienst von Google, der einheitliche universelle Links für mobile Apps auf iOS und Android erstellt. Ein dynamischer Link enthält einen Deep Link zu Inhalten innerhalb der App, verhält sich aber wie ein normaler HTTPS-Link: Wenn die App installiert ist, öffnet er sie direkt; wenn nicht, leitet er zum App Store weiter.

Im Gegensatz zu normalen URL-Schemas können Dynamic Links dank der Deferred-Deep-Link-Technologie mit nicht installierten Apps funktionieren. Wenn ein Benutzer die App nach dem Klicken auf den Link installiert, speichert Firebase die Übergangsparameter und übergibt sie beim ersten Start. Dies eröffnet Möglichkeiten für Empfehlungsprogramme, Marketingkampagnen und Einladungen.

Unterschied zu normalen URL-Schemas

URL-Schemas erfordern eine installierte App und haben keinen Standard-Fallback-Mechanismus. Firebase Dynamic Links lösen dieses Problem über einen zwischengeschalteten Firebase-Webdienst, der den Installationsstatus der App auf dem Gerät ermittelt und den Benutzer korrekt weiterleitet. Gleichzeitig funktioniert ein Link auf beiden Plattformen identisch.

Wie Firebase Dynamic Links funktionieren

Firebase Dynamic Link verwendet eine Domain wie yourcode.page.link, die in der Firebase Console registriert wird. Wenn ein Benutzer auf einen solchen Link klickt, ermittelt Firebase den Gerätetyp und den Installationsstatus der App. Für iOS wird der Universal-Links-Mechanismus verwendet, für Android App Links mit automatischer Verifizierung über Digital Asset Links.

Der Verarbeitungsprozess umfasst mehrere aufeinanderfolgende Schritte: Beim Klicken auf den Link sendet der Browser eine GET-Anfrage an den Firebase-Server; der Server ermittelt die Plattform und prüft, ob die App auf dem Gerät vorhanden ist. Wenn die App installiert ist, wird eine Weiterleitung zu einem Universal Link oder Intent mit Parametern zum Öffnen des Zielbildschirms generiert. Wenn die App nicht installiert ist, wird zum App Store oder Google Play zum Herunterladen weitergeleitet.

Lebenszyklus eines Dynamic Link

Die App empfängt den Link während der Firebase SDK-Initialisierung. Die Methode getDynamicLink() gibt ein PendingResult mit Übergangsdaten zurück. Nach erfolgreichem Abruf werden die Deep-Link-Parameter, UTM-Tags für Analysen und beliebige Daten, die beim Erstellen des Links übergeben wurden, extrahiert.

Erstellen eines Dynamic Link in der Firebase Console

Die Firebase Console bietet eine visuelle Oberfläche zum Erstellen von Dynamic Links. Der Entwickler gibt die Deep-Link-URL, den Kampagnennamen, die Einstellungen für iOS und Android getrennt sowie Analyseparameter an. Nach der Erstellung generiert Firebase einen kurzen Link wie https://yourcode.page.link/abc123, der in Werbematerialien, E-Mail-Kampagnen und sozialen Netzwerken verwendet werden kann.

Für die programmatische Erstellung von Dynamic Links wird die Firebase REST API oder das Client-SDK verwendet. Die REST API ermöglicht die Massengenerierung von Links für Marketingkampagnen mit benutzerdefinierten Parametern, einschließlich Links für soziale Netzwerke und asynchroner Klickanalyse. Beim Erstellen von Links über die API ist es wichtig, die Parameter socialMetaTagInfo korrekt anzugeben — sie bestimmen, wie der Link beim Teilen in Messengern und sozialen Netzwerken mit einer Vorschaukarte angezeigt wird.

Dynamic Link-Parameter

Einrichten von Dynamic Links in iOS

Um mit Firebase Dynamic Links unter iOS zu arbeiten, muss das Firebase SDK über CocoaPods oder Swift Package Manager integriert, Info.plist mit GOOGLE_APP_ID konfiguriert und die Dynamic Links-Domain in den Associated Domains des Projekts registriert werden. Danach verarbeitet die App automatisch die von Firebase generierten Universal Links.

In Xcode muss die Associated Domains-Fähigkeit mit einem Eintrag wie applinks:yourcode.page.link hinzugefügt werden. Das Firebase SDK verwendet die Methode application(_:continue:restorationHandler:) zur Verarbeitung von Universal Links, daher ist keine zusätzliche Integration mit AppDelegate erforderlich — Firebase extrahiert automatisch die Dynamic Link-Parameter aus der User Activity.

Konfiguration in Xcode

Beispiel für die Info.plist-Konfiguration zur ordnungsgemäßen Firebase-Initialisierung und Dynamic Link-Handler-Registrierung. Der FIROptions-Schlüssel sollte die Projektkennung aus GoogleService-Info.plist enthalten.

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

Wenn der AppDelegate-Proxy deaktiviert ist, muss die Methode handleUniversalLink(_:) manuell aufgerufen und die User Activity aus dem continue NSUserActivity übergeben werden. Das Firebase SDK extrahiert automatisch die Linkparameter und gibt über den Completion Handler ein DynamicLink zurück.

Einrichten von Dynamic Links in Android

Unter Android beginnt die Integration von Firebase Dynamic Links mit dem Hinzufügen von Abhängigkeiten in build.gradle und der Datei google-services.json von der Firebase Console. Die Dynamic Links-Domain wird in der Firebase Console registriert, wonach alle Links mit dieser Domain automatisch von der Android-App über einen Intent Filter mit Action VIEW erkannt werden. Für den korrekten Betrieb muss außerdem das Google Services-Plugin in der Stamm- und Modul-build.gradle hinzugefügt und die Gradle-Synchronisierung durchgeführt werden.

Um Links unter Android korrekt zu verarbeiten, muss ein Intent Filter für die Dynamic Links-Domain in der Activity hinzugefügt werden, die eingehende Links empfangen soll. Der Filter muss das https-Schema, den Host Ihrer Dynamic Links-Domain und den Standardpfad enthalten.

Intent Filter für Dynamic Links

Beispiel für einen Intent Filter in AndroidManifest.xml zum Empfangen von Dynamic Links auf der Domain 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>

Es ist wichtig, launchMode auf singleTask für die Activity zu setzen, die Dynamic Links empfängt. Dies verhindert die Erstellung einer neuen Activity-Instanz bei wiederholten Link-Klicks und ermöglicht die Verarbeitung aller eingehenden Deep Links in einer einzigen Instanz.

Empfangene Links verarbeiten

Das Firebase SDK für Android stellt die Methode FirebaseDynamicLinks.getInstance().getDynamicLink(intent) bereit, die ein PendingTask-Objekt mit Linkdaten zurückgibt. Aus dem DynamicLink-Objekt werden die Deep-URI, UTM-Parameter und der Übergangszeitstempel extrahiert. Die Verarbeitung sollte in den Methoden onCreate() und onNewIntent() der Activity erfolgen.

Bei der Verarbeitung ist zu beachten, dass ein Dynamic Link sowohl beim Starten der App aus einem kalten Zustand (Cold Start) als auch beim Übergang von einer anderen App zu einer bereits laufenden App empfangen werden kann. Für den zweiten Fall muss onNewIntent() überschrieben und die Dynamic Link-Prüfung erneut aufgerufen werden.

Verarbeitung in Kotlin-Code

Beispiel für den Empfang und die Verarbeitung eines Firebase Dynamic Link in MainActivity. Der Code verarbeitet sowohl Cold Start als auch den Übergang von einer anderen 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)
            }
    }
}

Die Methode addOnSuccessListener gibt ein DynamicLink zurück, aus dem der Ziellink über link?.link extrahiert wird. Wenn der Listener null zurückgibt, enthält der Intent keinen Dynamic Link — es handelt sich um einen normalen App-Start ohne eingehenden Link. Außerdem stehen UTM-Tags für die Klickanalyse zur Verfügung, darunter campaign, medium, source und content, die an Google Analytics übergeben werden können, um die Effektivität jedes Marketingkanals detailliert zu bewerten.