Domande frequenti sulla deprecazione dei collegamenti dinamici

Abbiamo lanciato Firebase Dynamic Links oltre 7 anni fa per rendere gli URL più potenti, ad esempio modificando dinamicamente la destinazione di un collegamento in base alle condizioni di runtime.

Nel corso degli anni, gli ecosistemi web e mobili si sono evoluti con tecnologie come App Links , Google Play Instant , Universal Links e App Clips e hanno reso i percorsi degli utenti attraverso le app e il Web più fluidi e prevedibili per gli utenti della tua app. Riteniamo che tu e i tuoi utenti potrete trarre maggiori benefici dall’adozione diretta di queste tecnologie e dal continuare a far avanzare l’ecosistema. Tuttavia, insieme a queste nuove modifiche, anche le API native originali su cui erano basati Firebase Dynamic Links si sono evolute e hanno presentato nuove sfide.

Ad esempio, i cambiamenti dell'ecosistema hanno influito sulla nostra capacità di fornire un'esperienza costantemente stabile per una delle funzionalità principali di Firebase Dynamic Links: offrire agli utenti dell'app una transizione graduale all'app dopo l'installazione, indipendentemente dalla piattaforma.

Invece di continuare a supportare un'esperienza tutt'altro che ideale, abbiamo deciso di abbandonare Firebase Dynamic Links e di concentrare nuovamente le nostre risorse sulla risoluzione di altri punti critici degli sviluppatori.

Comprendiamo che questo cambiamento richiederà il tuo tempo per valutare e adottare soluzioni alternative o fornitori di piattaforme sul mercato.

Stiamo continuando a far evolvere Firebase per soddisfare le tue esigenze mentre l'ecosistema continua ad evolversi e cambiare. Continueremo a lanciare nuove funzionalità e aggiornamenti sui prodotti Firebase e ci impegneremo ad aiutarti a eccellere nei tuoi percorsi di sviluppo di app.

Cosa devo sapere?

Il 25 agosto 2025, Firebase Dynamic Links verrà disattivato. Tutti i collegamenti serviti da Firebase Dynamic Links (sia ospitati su domini personalizzati che sottodomini page.link) smetteranno di funzionare e non sarai più in grado di creare nuovi collegamenti.

Per aiutarti a decidere come eseguire la migrazione da Firebase Dynamic Links, continueremo ad aggiornare questo documento di domande frequenti con ulteriori informazioni da prendere in considerazione, oltre a fornire guide di migrazione per diversi scenari di migrazione che potrebbero corrispondere al modo in cui utilizzi Firebase Dynamic Links oggi.

Continueremo inoltre ad aggiornare questa guida con più domande frequenti man mano che la deprecazione avanza verso la data di scadenza del 25 agosto 2025 e scopriamo eventuali problemi aggiuntivi mentre ti aiutiamo nelle tue attività di migrazione.

Consulta le domande frequenti riportate di seguito per rispondere ad alcune delle tue domande più importanti.

Per iniziare la migrazione, dai un'occhiata alle domande frequenti su "Come dovrei eseguire la migrazione dal servizio" più avanti.

Il 25 agosto 2025, Firebase Dynamic Links verrà disattivato. Tutti i collegamenti serviti da Firebase Dynamic Links (sia quelli ospitati su domini personalizzati che su sottodomini page.link) smetteranno di funzionare.

Quanto tempo avrò per migrare?

Hai tempo fino al 25 agosto 2025 per completare la migrazione.

Sì, i tuoi collegamenti nuovi ed esistenti continueranno a funzionare fino alla chiusura del servizio Collegamenti dinamici il 25 agosto 2025.

Quando Firebase Dynamic Links viene disattivato, puoi aspettarti che:

  • Tutti i collegamenti su cui si fa clic restituiranno una risposta sullo stato HTTP 404 agli utenti finali.
  • Tutte le richieste HTTP a:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (API collegamenti brevi)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (API Link Stats)

    restituirà una risposta di stato HTTP 400/403.

  • Il seguente comportamento in base alla versione della piattaforma SDK e alla chiamata API effettuata nella tua app:

    iOS

    Caso d'uso Chiamata API Codice di stato Comportamento La tua app si bloccherà?
    Crea collegamento breve

    accorciare (rapido)

    accorciare l'URL (Swift)

    accorciareConCompletion (Obiettivo-C)

    400 Viene emesso un errore con il motivo dell'errore NO*
    Prima attribuzione aperta

    Viene chiamato automaticamente su FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 Non viene emesso alcun errore, ma viene restituito un oggetto FDL con dati vuoti NO*
    Riapri l'attribuzione

    manigliaUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Viene emesso un errore con il motivo dell'errore NO*

    Androide

    Caso d'uso Chiamata API Codice di stato Comportamento La tua app si bloccherà?
    Crea collegamento breve

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    400 Viene emesso un errore con il motivo dell'errore NO*
    Prima attribuzione aperta

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 L'attività restituisce una risposta di successo, ma i dati FDL saranno vuoti NO*
    Riapri l'attribuzione

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 L'attività restituisce una risposta di successo, ma i dati FDL saranno vuoti NO*
    Accetta l'invito Modulo AppInvite in Google Play Services richiamato durante la gestione del reindirizzamento dell'intento (da *.page.link o dominio personalizzato) 400 Mostra uno spinner quando viene richiamato Google Play Services e scompare quando viene restituita una risposta 400 NO*

Come devo migrare dal servizio?

Abbiamo scoperto che sviluppatori diversi hanno esigenze diverse quando si tratta di utilizzare Firebase Dynamic Links.

A seconda dei tuoi casi d'uso e della valutazione dell'utilizzo di Firebase Dynamic Links, è probabile che uno degli scenari seguenti soddisfi le tue esigenze.

Per questo scenario, ti consigliamo di utilizzare altri fornitori/fornitori di servizi di deep linking, come Adjustment, AppsFlyer, Bitly, Branch, Kochava e altri fornitori simili sul mercato. (Nota: questi fornitori non sono stati controllati da Google, ma forniscono funzionalità simili a Firebase Dynamic Links).

Puoi anche esportare i metadati dei tuoi collegamenti diretti , il che può semplificare la migrazione dei tuoi collegamenti a qualunque fornitore tu scelga.

Per trovare un fornitore con funzionalità corrispondenti a Firebase Dynamic Links, fare riferimento al seguente elenco di funzionalità riportato di seguito.

Funzionalità dei collegamenti dinamici Firebase:

  • Indirizza gli utenti al negozio corretto per il loro dispositivo con un solo clic (e torna a una pagina web, se necessario)
  • Fornisce agli utenti la continuazione del viaggio dopo aver scaricato e installato l'app visualizzando un collegamento diretto differito
  • Fornisce agli utenti un'esperienza contestuale tramite contenuti con link diretti nella tua app (se già installata)
  • Fornisce dati analitici relativi agli eventi di clic sui collegamenti dinamici
  • Fornisce la possibilità di creare URL di collegamenti brevi
  • Fornisce la possibilità di aggiungere metadati ai collegamenti per la condivisione sui social

Cosa succede se mi interessa solo il deep linking alla mia app dopo che è già stata installata?

Per questo scenario, consigliamo di utilizzare collegamenti app e collegamenti universali , che rappresentano modalità supportate dalla piattaforma con cui gli sviluppatori possono fornire esperienze di collegamento diretto ai propri utenti.

Consulta questa guida per ulteriori dettagli su come eseguire la migrazione all'utilizzo dei collegamenti app e dei collegamenti universali .

Questa guida descrive anche come utilizzare facoltativamente Firebase Hosting per ospitare i file di verifica dei collegamenti di dominio e risorse necessari sul dominio che prevedi di utilizzare per i tuoi nuovi collegamenti (ad esempio file assetlinks.json per collegamenti app, file apple-app-site-association per Collegamenti universali).

Per questo scenario, potrebbe non essere necessario eseguire alcuna azione nell'app per gestire l'imminente ritiro, tuttavia ti consigliamo di:

  • Revisione dei collegamenti dinamici Firebase esistenti seguendo la guida sull'esportazione dei metadati dei collegamenti per garantire che gli utenti e l'app non subiscano alcun impatto una volta che i collegamenti non verranno più serviti.

  • Eliminazione dei prefissi URL dei collegamenti dinamici Firebase nella console Firebase . Nota: i domini con prefisso URL verranno automaticamente eliminati dopo il 25 agosto 2025.

  • Rimozione dell'SDK Firebase Dynamic Links dalle tue app.

Se vedi uno scenario di migrazione che non soddisfa le tue esigenze, contattaci per farcelo sapere

Le API Firebase Dynamic Links per Short Link e Analytics rimarranno disponibili fino alla data di scadenza del 25 agosto 2025.

Dopo tale data queste API non saranno più disponibili per l'uso e il servizio verrà interrotto .

Consulta la guida sull'esportazione dei metadati del collegamento per istruzioni su come esportare i metadati del collegamento.

Puoi utilizzare la guida all'esportazione per recuperare i metadati di Firebase Dynamic Links, che includono il collegamento stesso.

Puoi utilizzare l' API Firebase Dynamic Links Analytics per recuperare i dati statistici sui collegamenti per ciascuno dei tuoi Firebase Dynamic Links. Questa API Analytics è limitata a ~5 QPS. Per un esempio su come operare entro tale limite di richieste quando si utilizza l'API, fare riferimento a questo esempio di Cloud Task .

Puoi anche utilizzare Google Analytics ed esportare i tuoi dati per un sottoinsieme di dati di analisi dei collegamenti, inclusi gli eventi di aggiornamenti delle app esclusivi di Google Analytics.

Se hai bisogno di una percentuale di richieste più elevata per ricevere assistenza nella migrazione, contattaci all'indirizzo Supporto Firebase .

Il tuo dominio e i metadati del tuo collegamento verranno contrassegnati per l'eliminazione il 25 agosto 2025 ed eliminati in conformità con la nostra politica di conservazione dei dati .

Sì, l'autenticazione del collegamento e-mail tramite l'autenticazione Firebase continuerà a funzionare.

Firebase Authentication attualmente utilizza Firebase Dynamic Links per personalizzare i collegamenti di autenticazione, ma forniremo un aggiornamento per garantire che questa funzionalità continui a funzionare dopo la chiusura del servizio Firebase Dynamic Links.

Tieni presente che questa continuazione della funzionalità è separata dall'utilizzo di Firebase Dynamic Links per i casi d'uso principali di instradamento del negozio e del Web, deep link differiti e regolari, che saranno deprecati in base alla sequenza temporale della migrazione condivisa sopra.

Consulta la domanda frequente "Come dovrei eseguire la migrazione dal servizio" che descrive in dettaglio i diversi scenari di migrazione e fornisce guide di migrazione per le varie alternative disponibili.