Perguntas frequentes sobre a suspensão de uso do Dynamic Links

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.

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.

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.

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:

    No 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.

Para esse cenário, recomendamos que você use outros provedores de serviços de link direto/ fornecedores, como o Adjust, 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).

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

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.

Consulte o guia sobre como exportar seus metadados de link para instruções sobre como exportar seus metadados de link.

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.

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.

Sim, a autenticação por link de e-mail usando o Firebase Authentication continuará funcionando.

Atualmente, o Firebase Authentication usa o Firebase Dynamic Links para personalizar links do Authentication, mas forneceremos uma atualização que exigirá uma atualização no lado do cliente para garantir que a autenticação por e-mail continue funcionando depois que o serviço do Firebase Dynamic Links for encerrado.

O Firebase Authentication depende apenas do serviço do Firebase Dynamic Links internamente, mas não do SDK do Dynamic Links.

No momento, não é possível fazer a integração recente ao Firebase Dynamic Links se seu projeto ainda não tiver o FDL ativado na data de anúncio de desativação, em 25 de agosto de 2023.

Se você precisa ativar o Firebase Dynamic Links para ativar a autenticação de links por e-mail, entre em contato com o Suporte do Firebase. Entraremos em contato com você para ajudar na configuração.

Observe que essa continuação da funcionalidade é separada do uso do Firebase Dynamic Links para os principais casos de uso de roteamento na loja e na Web, adiado e link direto regular, que terão o uso suspenso de acordo com o cronograma de migração compartilhado. acima.

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.