Domande frequenti sul ritiro di Dynamic Links

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

Nel corso degli anni, gli ecosistemi web e mobile si sono evoluti con tecnologie come App Links, Google Play Instant , link universali e App Clip, rendendo i percorsi utente su app e web più fluidi e prevedibili per gli utenti delle app. Riteniamo che tu e i tuoi utenti trarrete maggiori vantaggi dall'adozione diretta di queste tecnologie e dal continuo sviluppo dell'ecosistema. Tuttavia, insieme a queste nuove modifiche, si sono evolute anche le API native originali su cui si basava Firebase Dynamic Links, presentando nuove sfide.

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

Anziché continuare a supportare un'esperienza non ideale, abbiamo deciso di ritirare Firebase Dynamic Links e di concentrare le nostre risorse sulla risoluzione di altri problemi degli sviluppatori.

Sappiamo che questa modifica richiederà del tempo per valutare e adottare soluzioni o fornitori di piattaforme alternativi sul mercato.

Continuiamo a sviluppare Firebase per soddisfare le tue esigenze man mano che l'ecosistema continua a evolversi e cambiare. Continueremo a lanciare nuove funzionalità e aggiornamenti per i prodotti Firebase e ci impegniamo ad aiutare a eccellere nei tuoi percorsi di sviluppo di app.

Che cosa devo sapere?

Il 25 agosto 2025, Firebase Dynamic Links verrà disattivato. Tutti i link forniti da Firebase Dynamic Links (sia quelli ospitati su domini personalizzati sia quelli ospitati su sottodomini page.link) smetteranno di funzionare e non potrai più creare nuovi link.

Per aiutarti a decidere come eseguire la migrazione da Firebase Dynamic Links, continueremo ad aggiornare questo documento con le domande frequenti con ulteriori informazioni da prendere in considerazione, oltre a fornire guide alla 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 altre domande frequenti man mano che il ritiro si avvicina alla data di disattivazione del 25 agosto 2025 e scopriremo eventuali problemi aggiuntivi mentre ti aiutiamo nei tuoi sforzi di migrazione.

Consulta le domande frequenti di seguito per trovare le risposte ad alcune delle tue domande più importanti.

Per iniziare la migrazione, consulta la domanda frequente "Come devo eseguire la migrazione dal servizio" più avanti.

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

Quanto tempo avrò a disposizione per eseguire la migrazione?

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

Sì, i link nuovi ed esistenti continueranno a funzionare fino alla disattivazione del servizio Dynamic Links il 25 agosto 2025.

No, una volta disattivato il servizio Firebase Dynamic Links, i domini .page.link non saranno più disponibili. Ti consigliamo di esaminare questo elenco di domande per valutare la procedura di migrazione più adatta dal servizio, e, se è necessaria la parità di funzionalità completa, di seguire queste indicazioni per esportare i metadati ed eseguire la migrazione a un altro fornitore di servizi di deep link utilizzando un nuovo dominio.

Quando Firebase Dynamic Links verrà ritirato, puoi aspettarti che:

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

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

    restituiranno una risposta di stato HTTP 400/403.

  • Le risposte di errore sopra indicate inizieranno gradualmente il 25 agosto 2025 fino a raggiungere tassi di risposta di errore del 100% dopo la data di ritiro.

  • 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 L'app si arresterà in modo anomalo?
    Crea link breve

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    403 Viene generato un errore con il motivo dell'errore No*
    Attribuzione della prima apertura

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

    400 Non vengono generati errori, ma viene restituito un oggetto FDL con dati vuoti No*
    Attribuzione della riapertura

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Viene generato un errore con il motivo dell'errore No*

    Android

    Caso d'uso Chiamata API Codice di stato Comportamento L'app si arresterà in modo anomalo?
    Crea link breve

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    403 Viene generato un errore con il motivo dell'errore No*
    Attribuzione della prima apertura

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 L'attività restituisce una risposta di successo, ma i dati FDL saranno vuoti No*
    Attribuzione della riapertura

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 L'attività restituisce una risposta di successo, ma i dati FDL saranno vuoti No*
    Accetta invito Il modulo AppInvite in Google Play Services viene richiamato durante la gestione del reindirizzamento dell'intent (da *.page.link o dominio personalizzato) 400 Mostra un indicatore di caricamento quando viene richiamato Google Play Services e scompare quando viene restituita una risposta 400 No*

Come devo eseguire la migrazione dal servizio?

Abbiamo scoperto che gli sviluppatori 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 riportati di seguito corrisponda alle tue esigenze.

Per questo scenario, ti consigliamo di utilizzare altri fornitori di servizi di deep link, come Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular e altri fornitori simili sul mercato. (Tieni presente che questi fornitori non sono stati verificati da Google, ma forniscono funzionalità simili a Firebase Dynamic Links).

Puoi anche esportare i metadati dei deep link, il che può semplificare la migrazione dei link al fornitore che preferisci.

Per trovare un fornitore con funzionalità corrispondenti a Firebase Dynamic Links, consulta l'elenco delle funzionalità riportato di seguito.

Funzionalità di Firebase Dynamic Links:

  • Indirizza gli utenti allo store corretto per il loro dispositivo con un solo clic (e torna a una pagina web, se necessario)
  • Fornisce agli utenti una continuazione del percorso dopo il download e l'installazione della vista app di un deep link differito
  • Offre agli utenti un'esperienza contestuale tramite contenuti con deep link nell'app (se già installata)
  • Fornisce dati di analisi relativi agli eventi di clic sui link dinamici
  • Offre la possibilità di creare URL di link brevi
  • Offre la possibilità di aggiungere metadati ai link per la condivisione sui social

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

Per questo scenario, ti consigliamo di utilizzare App Links e link universali, che sono modi supportati dalla piattaforma per gli sviluppatori di fornire esperienze di deep link per i propri utenti.

Consulta questa guida per maggiori dettagli su come eseguire la migrazione all'utilizzo di App Links e link universali.

Questa guida descrive anche come utilizzare facoltativamente Firebase Hosting per ospitare i file di verifica del dominio e dei link alle risorse necessari sul dominio che intendi utilizzare per i nuovi link (ad es. file assetlinks.json per App Links, file apple-app-site-association per link universali).

Per questo scenario, potresti non dover intraprendere alcuna azione nella tua app per gestire l'imminente ritiro, ma ti consigliamo di:

  • Esaminare i Firebase Dynamic Links esistenti seguendo la guida sull'esportazione dei metadati link per assicurarti che gli utenti e l'app non vengano interessati una volta che i link non vengono più erogati.

  • Eliminare i prefissi URL di Firebase Dynamic Links nella console Firebase. Nota: i domini dei prefissi URL verranno eliminati automaticamente dopo il 25 agosto 2025.

  • Rimuovere l'SDK Firebase Dynamic Links dalle tue app.

Se vedi uno scenario di migrazione che non copre le tue esigenze, contattaci

Cosa devo fare dopo aver completato la migrazione?

Una volta completata la migrazione da Firebase Dynamic Links, assicurati di eliminare tutti i prefissi del dominio URL (domini FDL) associati ai precedenti link dinamici Firebase nel tuo progetto.

Per farlo:

  1. Vai alla sezione Firebase Dynamic Links nella console Firebase
  2. Seleziona il prefisso URL che vuoi eliminare dal selettore a sinistra Screenshot della console FDL del selettore del prefisso del percorso URL

  3. Fai clic sul menu con tre puntini accanto al pulsante "Nuovo link dinamico" Screenshot della console FDL delle opzioni del prefisso del percorso URL

  4. Seleziona "Elimina prefisso URL"

  5. Inserisci il prefisso URL per confermare che vuoi eliminarlo e fai clic su "Elimina prefisso URL"

Una volta eliminati tutti i prefissi del dominio URL, il progetto Firebase verrà contrassegnato come migrazione completata da Firebase Dynamic Links. Verrà rimosso anche il promemoria popup che potresti aver visto nella console Firebase per il tuo progetto.

Tieni presente che questa azione eliminerà tutti i link dinamici Firebase una volta completata, quindi assicurati di aver eseguito completamente la migrazione dal servizio prima di eliminare i prefissi del dominio URL.

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

Dopo questa data, queste API non saranno più disponibili per l'uso e il servizio verrà disattivato.

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

Puoi utilizzare la guida all'esportazione per recuperare i metadati di Firebase Dynamic Links, incluso il link stesso.

Puoi utilizzare l'API Analytics di Firebase Dynamic Links per recuperare i dati delle statistiche dei link per ciascuno dei tuoi link dinamici Firebase. Questa API Analytics è limitata a circa 5 QPS. Per un esempio su come operare entro questo limite di richieste quando utilizzi l'API, consulta questo esempio di Cloud Tasks.

Puoi anche utilizzare Google Analytics ed esportare i dati per un sottoinsieme di dati di analisi dei link, inclusi gli eventi di aggiornamento delle app che sono univoci per Google Analytics.

Se hai bisogno di un tasso di richieste più elevato per la migrazione, contattaci all'assistenza Firebase.

I metadati del dominio e dei link verranno contrassegnati per l'eliminazione il 25 agosto 2025 ed eliminati in conformità con i nostri criteri di conservazione dei dati.

No, non devi eseguire l'onboarding di Firebase Dynamic Links perché non è più possibile. In alternativa, puoi seguire le guide aggiornate su come iniziare a utilizzare l'autenticazione tramite link via email per attivarla e implementarla per il tuo progetto:

Consulta l'elenco completo delle azioni interessate da questa modifica.

L'autenticazione tramite link via email e le azioni email fuori banda con Firebase continueranno a funzionare, ma dovrai eseguire l'upgrade agli SDK Firebase Authentication più recenti ed eseguire la migrazione alla nuova soluzione per continuare a utilizzare queste azioni dopo la disattivazione del servizio Firebase Dynamic Links il 25 agosto 2025.Firebase AuthenticationFirebase Dynamic Links

Puoi seguire le guide collegate di seguito per istruzioni su come completare la migrazione:

Consulta l'elenco completo delle azioni interessate da questa modifica.

In che modo sono interessate le implementazioni del flusso OAuth con le versioni dell'SDK Android di Firebase Authentication precedenti alla v20.0.0 o le versioni della distinta base precedenti alla 26.0.0?

Dovrai eseguire l'aggiornamento all'SDK Android di Firebase Authentication più recente (almeno la versione 20.0.0) per continuare a utilizzare l'implementazione del flusso OAuth nelle tue app Android.

Le azioni email di Firebase Authentication sulle app web sono interessate?

No. Il ritiro di Firebase Dynamic Links influisce solo sulla gestione degli URL in entrata sui dispositivi mobili.

In che modo sono interessate le implementazioni che utilizzano le librerie dell'SDK Firebase JS per autenticare i provider OAuth in un'app Cordova?

L'SDK Firebase JS utilizza Firebase Dynamic Links per implementare i flussi di autenticazione OAuth nelle app Cordova. Dovrai modificare l'implementazione del flusso eseguendo il flusso OAuth manualmente e passando le credenziali OAuth risultanti a Firebase per completare il flusso di autenticazione.

Per maggiori dettagli, consulta la guida di Cordova.

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