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.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.