Per ricevere l'Firebase Dynamic Links che
hai creato, devi includere l'SDK Dynamic Links nella tua app e chiamare il
metodo FirebaseDynamicLinks.getDynamicLink()
quando l'app viene caricata per
ottenere i dati passati nell'Dynamic Link.
Configura Firebase e l'SDK Dynamic Links
Se non l'hai ancora fatto, aggiungi Firebase al tuo progetto Android.
Quando registri la tua app, specifica la chiave di firma SHA-1. Se utilizzi i link alle app, specifica anche la chiave SHA-256.
-
Nel file Gradle (a livello di app) del modulo (di solito
<project>/<app-module>/build.gradle.kts
o<project>/<app-module>/build.gradle
), aggiungi la dipendenza per la libreria Dynamic Links per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.Per un'esperienza ottimale con Dynamic Links, ti consigliamo di attivare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.16.0")) // Add the dependencies for the Dynamic Links and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links' implementation 'com.google.firebase:firebase-analytics' }
Utilizzando la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.
(Alternativa) Aggiungi le dipendenze della libreria Firebase senza utilizzare BoM
Se scegli di non utilizzare la Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga della dipendenza.
Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni.
dependencies { // Add the dependencies for the Dynamic Links and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links:22.1.0' implementation 'com.google.firebase:firebase-analytics:22.5.0' }
- Nella console Firebase, apri la sezione Dynamic Links. Accetta i termini di servizio se ti viene richiesto.
Aggiungere un filtro per intent per i link diretti
Come per i
link diretti semplici, devi aggiungere un nuovo filtro per intent all'attività che gestisce
i link diretti per la tua app. Il filtro per intent deve intercettare i link diretti del tuo dominio, poiché
Dynamic Link reindirizzerà al tuo dominio se la tua app è installata. Questo è necessario affinché la tua app
riceva i dati Dynamic Link dopo l'installazione/l'aggiornamento dal Play Store e dopo aver toccato il
pulsante Continua. In AndroidManifest.xml
:
<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:host="example.com" android:scheme="https"/> </intent-filter>
Quando gli utenti aprono un Dynamic Link con un link diretto allo schema e all'host che specifichi, la tua app avvierà l'attività con questo filtro per intent per gestire il link.
Gestire i link diretti
Per ricevere il link diretto, chiama il metodo getDynamicLink()
:
Kotlin
Firebase.dynamicLinks .getDynamicLink(intent) .addOnSuccessListener(this) { pendingDynamicLinkData: PendingDynamicLinkData? -> // Get deep link from result (may be null if no link is found) var deepLink: Uri? = null if (pendingDynamicLinkData != null) { deepLink = pendingDynamicLinkData.link } // Handle the deep link. For example, open the linked // content, or apply promotional credit to the user's // account. // ... } .addOnFailureListener(this) { e -> Log.w(TAG, "getDynamicLink:onFailure", e) }
Java
FirebaseDynamicLinks.getInstance() .getDynamicLink(getIntent()) .addOnSuccessListener(this, new OnSuccessListener<PendingDynamicLinkData>() { @Override public void onSuccess(PendingDynamicLinkData pendingDynamicLinkData) { // Get deep link from result (may be null if no link is found) Uri deepLink = null; if (pendingDynamicLinkData != null) { deepLink = pendingDynamicLinkData.getLink(); } // Handle the deep link. For example, open the linked // content, or apply promotional credit to the user's // account. // ... // ... } }) .addOnFailureListener(this, new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "getDynamicLink:onFailure", e); } });
Devi chiamare getDynamicLink()
in ogni attività che potrebbe essere
avviata dal link, anche se il link potrebbe essere disponibile dall'intent
utilizzando getIntent().getData()
. La chiamata di getDynamicLink()
recupera il link e cancella i dati in modo che vengano elaborati una sola volta dalla tua
app.
In genere, chiami getDynamicLink()
nell'attività principale e in tutte le attività avviate dai filtri per intent che corrispondono al link.
Analisi dei record
I seguenti eventi possono essere monitorati automaticamente in Google Analytics e visualizzati nella console Firebase.
dynamic_link_app_open
dynamic_link_first_open
dynamic_link_app_update
Per registrare questi eventi, devi configurare Google Analytics prima di recuperare il link diretto. Verifica che siano soddisfatte le seguenti condizioni:
- Chiama
FirebaseDynamicLinks.getDynamicLink()
nei punti di accesso dell'app: - Attività di Avvio app. Ad esempio:
action="android.intent.action.MAIN"
,category="android.intent.category.LAUNCHER"
. - Entry point dell'attività. Ad esempio:
onStart()
,onCreate()
. - Attività di link diretto.
- Configura e utilizza Google Analytics:
- Includi la dipendenza Google Analytics. Questo valore viene in genere aggiunto automaticamente dal
plug-in Gradle
google-services
. - Includi il
google-services.json
file di configurazione nella tua app. - Chiama
FirebaseAnalytics.getInstance()
prima di chiamareFirebaseDynamicLinks.getDynamicLink()
.
Gestione di Dynamic Links tramite i link per app
Su Android 6.0 (livello API 23) e versioni successive, puoi configurare la tua app per gestire Dynamic Links direttamente quando l'app è già installata utilizzando Android App Links.
Assicurati di aver aggiunto l'impronta del certificato SHA256 per la tua app al progetto nella Firebase console. Dynamic Links si occuperà di configurare l'associazione del sito web App Links per il tuo dominio Dynamic Links.
Aggiungi un filtro per intent verificato automaticamente all'attività che gestirà Dynamic Link, impostando l'host sul dominio Dynamic Links del tuo progetto come
trovato nella console Firebase. In
AndroidManifest.xml
:
<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:host="example.com/link" android:scheme="http"/> <data android:host="example.com/link" android:scheme="https"/> </intent-filter>
Tieni presente che android:host
deve essere impostato sul tuo dominio Dynamic Links e non sul dominio
del link diretto.
Per attivare i link
dell'app, tutti i filtri per intent autoVerify
nel manifest devono essere registrati. Firebase gestisce questa operazione automaticamente per i tuoi domini Dynamic Links, ma puoi verificarla aprendo il file assetlinks.json
ospitato sul tuo dominio Dynamic Links:
https://YOUR_DOMAIN/.well-known/assetlinks.json
Dynamic Links verrà ora inviato direttamente alla tua app. Potrai ottenere il link diretto e altri dati Dynamic Link chiamando getDynamicLink()
nell'attività a cui hai aggiunto il filtro per intent App Links (come descritto in Gestire i link diretti).
Nota:poiché l'invocazione tramite i link per app indirizza l'utente direttamente all'app, un Dynamic Link non può rispettare la versione minima richiesta. Una volta aperta l'app, devi confrontare la versione minima del link dinamico ( getminimumappversion) con PackageInfo.versionCode e reindirizzare l'utente all'upgrade dell'app, se necessario, utilizzando getUpdateAppIntent.