Há mais de sete anos, lançamos o Firebase Dynamic Links para tornar os URLs mais eficientes. Por exemplo, mudar dinamicamente o destino de um link com base nas condições de tempo de execução.
Ao longo dos anos, os ecossistemas da Web e para dispositivos móveis evoluíram com tecnologias como App Links, Google Play Instant, Universal Links e Clipes de app, além de simplificar a previsibilidade e a jornada do usuário nos apps e na Web. Acreditamos que você e seus usuários serão mais beneficiados com a adoção direta dessas tecnologias e a adoção contínua do ecossistema. No entanto, além dessas novas alterações, as APIs nativas originais em que o Firebase Dynamic Links foi criado também evoluíram e apresentaram novos desafios.
Por exemplo, as mudanças no ecossistema afetaram nossa capacidade de fornecer uma experiência consistente e estável para um dos principais recursos do Firebase Dynamic Links, oferecendo aos usuários do app uma transição tranquila para o app após a instalação, independentemente da plataforma.
Em vez de continuar a oferecer uma experiência inferior à ideal, decidimos desativar o Firebase Dynamic Links e concentrar nossos recursos em resolver outros problemas do desenvolvedor.
Entendemos que essa mudança exigirá seu tempo para avaliar e adotar soluções alternativas ou provedores de plataforma no mercado.
Continuamos aprimorando o Firebase para atender às suas necessidades, já que o ecossistema continua evoluindo e mudando. Continuaremos a lançar novos recursos e atualizações em produtos do Firebase e estamos comprometidos em ajudar você a se destacar na jornada de desenvolvimento de apps.
O que eu preciso saber?
Em 25 de agosto de 2025, o Firebase Dynamic Links será desativado. Todos os links veiculados pelo Firebase Dynamic Links (hospedados em domínios personalizados e subdomínios de page.link) deixarão de funcionar, e você não poderá mais criar novos links.
Para ajudar você a decidir como migrar do Firebase Dynamic Links, continuaremos atualizando este documento de perguntas frequentes com informações adicionais para sua análise, bem como fornecendo guias de migração para diferentes cenários de migração que podem corresponder a maneira como você usa o Firebase Dynamic Links hoje.
Também continuaremos atualizando este guia com mais perguntas frequentes à medida que a suspensão de uso avança para a data de desativação, em 25 de agosto de 2025. Além disso, descobrimos outros problemas para ajudar você nos esforços de migração.
Consulte as Perguntas frequentes abaixo para obter respostas a algumas das perguntas mais importantes.
Para iniciar a migração, consulte as Perguntas frequentes sobre "Como migrar do serviço" abaixo.
Quando o Firebase Dynamic Links deixará de funcionar?
Em 25 de agosto de 2025, o Firebase Dynamic Links será desativado. Todos os links veiculados pelo Firebase Dynamic Links (tanto os hospedados em domínios personalizados quanto os subdomínios de page.link) deixarão de funcionar.
Quanto tempo precisarei migrar?
Você tem até 25 de agosto de 2025 para concluir a migração.
Os links novos e existentes continuarão funcionando?
Sim, os links novos e existentes continuarão funcionando até que o serviço do Dynamic Links seja encerrado em 25 de agosto de 2025.
O que acontecerá com meus links e nos meus apps quando o Firebase Dynamic Links for desativado (em 25 de agosto de 2025)?
Quando o Firebase Dynamic Links for desativado:
- Todos os links clicados retornarão uma resposta de status HTTP 404 para os usuários finais.
Todas as solicitações HTTP para:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (API Short Links)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (API Link Stats)
retornarão uma resposta de status HTTP 400/403.
O comportamento a seguir com base na versão da plataforma do SDK e chamada de API feitas no seu app:
iOS
Caso de uso Chamada de API Código de status Comportamento Seu app falhará? Criar link curto shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
400 Erro emitido com motivo da falha Não* Atribuição de primeiro acesso É chamada automaticamente em FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C).
400 Nenhum erro é emitido, mas um objeto FDL é enviado de volta com dados vazios Não* Reabrir atribuição handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Erro emitido com motivo da falha Não* Android
Caso de uso Chamada de API Código de status Comportamento Seu app falhará? Criar link curto buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
400 Erro emitido com motivo da falha Não* Atribuição de primeiro acesso getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 A tarefa retorna uma resposta de sucesso, mas os dados do FDL ficarão vazios Não* Reabrir atribuição getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 A tarefa retorna uma resposta de sucesso, mas os dados do FDL ficarão vazios Não* Aceitar convite Módulo AppInvite no Google Play Services invocado ao lidar com redirecionamento de intent (de *.page.link ou domínio personalizado) 400 Mostra um ícone de carregamento quando o Google Play Services é invocado e desaparece quando uma resposta 400 é retornada. Não*
Como devo migrar do serviço?
Descobrimos que desenvolvedores diferentes têm necessidades diferentes em relação ao uso do Firebase Dynamic Links.
Dependendo dos seus próprios casos de uso e da avaliação de uso do Firebase Dynamic Links, é provável que um dos cenários abaixo atenda às suas necessidades.
O que devo fazer se eu precisar de paridade total de recursos com o Firebase Dynamic Links?
Para esse cenário, recomendamos que você use outros provedores de serviços de link direto/ fornecedores, como o Adjust, , Airbridge, AppsFlyer, Bitly, Branch, Kochava e outros provedores semelhantes no mercado. Esses provedores não foram analisados pelo Google, mas oferecem funcionalidade semelhante ao Firebase Dynamic Links.
Também é possível exportar os metadados de link direto, o que facilita a migração dos links para o provedor escolhido.
Para encontrar um provedor com recursos correspondentes ao Firebase Dynamic Links, consulte a lista de recursos abaixo.
Recursos do Firebase Dynamic Links:
- Direciona os usuários para o armazenamento correto do dispositivo com um único clique (e volta a uma página da Web, se necessário)
- Fornece aos usuários uma continuação da jornada após o download e a instalação da visualização do seu app com um link direto adiado
- Fornece aos usuários uma experiência contextual por meio de conteúdo com link direto no seu app (quando já instalado).
- Fornece dados de análise relacionados a eventos de cliques em links dinâmicos
- Permite criar URLs de links curtos
- Permite adicionar metadados a links para compartilhamento em redes sociais
E se eu só quiser usar links diretos no meu aplicativo após a instalação?
Nesse cenário, recomendamos o uso de links de apps e links universais, que são maneiras compatíveis com a plataforma para que os desenvolvedores ofereçam experiências de links diretos aos usuários.
Confira este guia para ver mais detalhes sobre como migrar para o links de app e os links universais.
Este guia também descreve como usar opcionalmente o Firebase Hosting para hospedar os arquivos de verificação necessários do domínio e do link de recursos no domínio que você pretende usar para os novos links (por exemplo, arquivo assetlinks.json para App Links, apple-app-site-association para links universais).
E se meu app não precisar mais dos recursos do Firebase Dynamic Links e não precisar substituí-los?
Nesse cenário, talvez não seja necessário realizar nenhuma ação no app para lidar com a desativação, mas recomendamos o seguinte:
Revise os links dinâmicos do Firebase seguindo o guia sobre como exportar seus metadados de links para garantir que os usuários e o app não serão afetados depois que os links não forem mais veiculados.
Exclusão dos prefixos de URL do Firebase Dynamic Links no Console do Firebase. Observação: os domínios de prefixo de URL serão excluídos automaticamente após 25 de agosto de 2025.
Remoção do SDK do Firebase Dynamic Links dos seus apps.
Se você encontrar um cenário de migração que não atende às suas necessidades, entre em contato conosco
Ainda poderei usar as APIs Firebase Dynamic Links?
As APIs Firebase Dynamic Links para Links curtos e Analytics permanecerão disponíveis até a data de desativação, em 25 de agosto de 2025.
Após essa data, essas APIs não estarão mais disponíveis para uso, e o serviço será encerrado.
Como posso exportar meus metadados de links?
Consulte o guia sobre como exportar seus metadados de link para instruções sobre como exportar seus metadados de link.
Como consigo meus dados de análise de links do Firebase Dynamic Links?
Você pode usar o guia de exportação para recuperar metadados do Firebase Dynamic Links, que incluem o próprio link.
Você pode usar a API Firebase Dynamic Links Analytics para recuperar os dados de estatísticas de link de cada um dos Firebase Dynamic Links. Essa API do Analytics é limitada a cerca de 5 QPS. Para um exemplo de como operar dentro desse limite de solicitação ao usar a API, consulte esta amostra do Cloud Tasks.
Também é possível usar o Google Analytics e exportar os dados de um subconjunto de dados de análise de links, incluindo eventos de atualizações de apps exclusivos do Google Analytics.
Se você precisar de uma taxa de solicitação mais alta para ajudar na migração, entre em contato com nossa equipe no Suporte do Firebase.
O que acontecerá com os metadados de links atuais após a data de desativação (25 de agosto de 2025)?
Seus metadados de link e domínio serão marcados para exclusão em 25 de agosto de 2025 e limpos de acordo com nossa política de retenção de dados.
Impacto do Firebase Dynamic Links nos fluxos do Firebase Authentication
Quero ativar a autenticação por link de e-mail no Firebase Authentication para meu projeto. Preciso integrar o Firebase Dynamic Links?
Não, você não precisa integrar o Firebase Dynamic Links, porque isso não é mais possível. Em vez disso, siga os guias atualizados sobre como começar a usar a autenticação de link por e-mail para ativar e implementar no seu projeto:
Confira a lista completa de ações afetadas por essa mudança.
Como os seguintes recursos de autenticação são afetados: autenticação de link de e-mail, redefinição de senha e verificação de e-mail?
A autenticação por link de e-mail e suas ações de e-mail fora da banda com o Firebase vão continuar funcionando, mas você vai precisar fazer upgrade para os SDKs Firebase Authentication mais recentes e migrar para a nova solução para continuar usando essas ações depois que o serviço Firebase Dynamic Links for encerrado em 25 de agosto de 2025.
Siga os guias abaixo para instruções sobre como concluir a migração:
Confira uma lista completa de ações afetadas.
Como as implementações do fluxo OAuth com versões do SDK do Firebase Authentication para Android anteriores à v20.0.0 ou versões da BoM anteriores à 26.0.0 são afetadas?
Você precisa atualizar para o SDK do Firebase Authentication para Android mais recente (pelo menos v20.0.0) para continuar usando a implementação do fluxo OAuth nos apps Android.
As ações de e-mail do Firebase Authentication em apps da Web foram afetadas?
Não. A descontinuação do Firebase Dynamic Links só afeta o processamento de URLs recebidos em dispositivos móveis.
Como as implementações que usam as bibliotecas do SDK do Firebase para JavaScript para autenticar provedores OAuth em um app do Cordova são afetadas?
Sim, o SDK do Firebase JS usa o Firebase Dynamic Links para implementar o fluxo de autenticação OAuth. Você vai precisar modificar sua implementação do fluxo executando o fluxo OAuth manualmente e transmitindo a credencial OAuth resultante para o Firebase para concluir o fluxo de autenticação.
Consulte o guia do Cordova para saber mais.
Quais são algumas opções alternativas para o Firebase Dynamic Links?
Consulte as Perguntas frequentes "Como migrar do serviço", que detalha diferentes cenários de migração e apresenta guias de migração para as várias alternativas disponíveis.