Ir para o console

Como migrar do Firebase Invites para o Dynamic Links com compartilhamento personalizado

O Firebase Invites ofereceu um mecanismo para receber links dinâmicos do Firebase no seu aplicativo, bem como um recurso para compartilhar esse link por SMS ou e-mail. Desenvolvemos o Firebase Invites para ajudar você a expandir seus usuários de aplicativos por meio do boca a boca, mas ao longo do tempo aprendemos que você encontrou maneiras melhores de incentivar os usuários a compartilhar seus aplicativos favoritos com os amigos, além do que o Firebase Invites faz hoje.

Também vimos que, embora o uso do Firebase Invites tenha caído, muitos de vocês ainda usam o Firebase Dynamic Links como o ingrediente principal da solução de compartilhamento de usuário para usuário. Por isso, estamos aumentando nosso foco e nossos esforços para tornar o Firebase Dynamic Links a melhor maneira de criar recursos de compartilhamento de usuário para usuário no seu aplicativo. Como parte dessa mudança, descontinuamos o recurso Firebase Invites e o suporte dele a partir de 24 de janeiro de 2020.

O que isso significa e como isso me afeta?

A partir de 24 de janeiro de 2020, os usuários não poderão mais enviar ou receber convites do Firebase, e o serviço de back-end do Invites começará a retornar respostas de erro ao fazer chamadas para enviar e receber um link de convite. Os SDKs atuais incluem gerenciamento de erros para ajudar a garantir casos de falha simples para essas respostas do servidor, para que seus usuários continuem usando seu aplicativo sem travar. Mas recomendamos que você não use mais o Firebase Invites e mude para uma solução alternativa usando o Firebase Dynamic Links com uma solução de compartilhamento personalizada.

Veja como fazer isso.

Primeiro, crie um link dinâmico que seus usuários possam compartilhar com os amigos. A boa notícia é que você já está familiarizado com essa etapa, porque ela é semelhante à do Firebase Invites. Mas também é possível adicionar parâmetros específicos ao seu link dinâmico, como adicionar metadados sociais aos seus links, se os usuários compartilharem seu aplicativo por meio de uma rede social para personalizar a aparência do URL que é compartilhado.

Criar uma solução de compartilhamento

Em seguida, crie sua solução de compartilhamento para que seus usuários possam compartilhar esse link com os amigos. O que você precisará criar aqui varia dependendo de como você quer fornecer o recurso de compartilhamento que substituirá o anterior no Firebase Invites. Mas, para a maioria dos aplicativos para dispositivos móveis, é possível aproveitar os recursos já integrados à plataforma.

No Android, uma solução simples que abrange o compartilhamento de SMS e e-mail, bem como outros aplicativos populares de redes sociais e de mensagens, é usar um intent genérico com uma ação definida como Intent.ACTION_SEND. Isso proporciona uma maneira conveniente de compartilhar dados do seu aplicativo com qualquer aplicativo que o usuário tenha instalado e que possa manipular um intent de compartilhamento.

Algo semelhante ao exemplo a seguir pode funcionar aqui, e recomendamos que você use recursos de string constantes no seu próprio código:

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "Here's a new lesson for" +
        " learning more Miwok vocabulary:\n\n" + dynamicLink);
sendIntent.putExtra(Intent.EXTRA_SUBJECT, "Let's Learn Miwok!");
sendIntent.setType("text/plain");
startActivity(Intent.createChooser(sendIntent,
        getResources().getText(R.string.send_to)));

Para ver um exemplo mais completo e mais detalhes, confira este guia de como enviar dados simples para outros aplicativos.

O snippet de código acima gerará algo como o fluxo de convites mostrado nas telas abaixo:

Compartilhar no Android

Para desenvolvedores do iOS, é possível usar um UIActivityViewController, transmitindo o link criado como parte dos dados para o VC personalizado. Esse método forneceria um fluxo de compartilhamento semelhante às telas abaixo:

Compartilhar no iOS

Receber um link dinâmico no seu aplicativo

Por fim, a última etapa para integrar o compartilhamento de usuário para usuário no seu aplicativo é receber um link dinâmico no seu aplicativo.

No Android, esse processo continua o mesmo, então não será preciso mudar muita coisa. A única diferença é que, sem o Firebase Invites, não haverá mais um código de convite. Será preciso remover a chamada para extrair o código de convite por meio de FirebaseAppInvite invite = FirebaseAppInvite.getInvitation(data), se seu aplicativo fizer a chamada. Para ver mais detalhes sobre esta etapa, consulte o guia sobre Como receber links dinâmicos no seu aplicativo para Android.

No iOS, isso exigiria alterar o objeto FIRReceivedInvite para o objeto FIRDynamicLink, que contêm dados semelhantes. Consulte o guia sobre Como receber links dinâmicos no seu aplicativo para iOS para ver mais detalhes.

Para os desenvolvedores do Unity, existem várias bibliotecas e soluções equivalentes de código aberto, como as descritas acima, para migrar a funcionalidade de compartilhamento de usuário para usuário. Se você precisar de ajuda para fornecer uma solução adequada, entre em contato com os recursos de suporte relacionados abaixo.

O Firebase Invites tem sido uma ótima ferramenta, e temos orgulho de tê-lo criado. À medida que olhamos para o futuro, queremos melhorar ainda mais o Firebase Dynamic Links, para que você tenha mais flexibilidade e controle sobre como incentivar os usuários a convidar outras pessoas para seu aplicativo. Se tiver alguma dúvida sobre como configurar o Firebase Dynamic Links e as soluções de compartilhamento personalizadas, entre em contato por meio do StackOverflow ou de um dos nossos fóruns de suporte adicionais.