Confira as novidades do Firebase anunciadas no Google I/O 2022. Saiba mais

Como migrar de convites do Firebase para links dinâmicos com compartilhamento personalizado

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Firebase Invites forneceu um mecanismo para receber links dinâmicos do Firebase em seu aplicativo, bem como um recurso para compartilhar esse link por SMS ou e-mail. Desenvolvemos o Firebase Invites para ajudar você a aumentar os usuários do seu aplicativo por meio do boca a boca, mas, com o tempo, descobrimos 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 usavam o Firebase Dynamic Links como o principal ingrediente de sua solução de compartilhamento de usuário para usuário. Portanto, estamos fortalecendo nosso foco e aumentando nosso esforço para tornar o Firebase Dynamic Links a melhor maneira de criar recursos de compartilhamento de usuário para usuário em seu aplicativo. Como parte dessa mudança, suspendemos o uso do recurso Firebase Invites e descontinuaremos o suporte 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, seus usuários não poderão mais enviar ou receber convites do Firebase, e o serviço de back-end de convites começará a retornar respostas de erro ao fazer chamadas para enviar e receber um link de convite. Os SDKs atuais incluem tratamento de erros para ajudar a garantir casos de falha normais para essas respostas do servidor, para que seus usuários possam continuar 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 Links dinâmicos com uma solução de compartilhamento personalizada.

Aqui está como fazer isso!

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

Crie uma solução de compartilhamento

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

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

Algo semelhante ao exemplo a seguir deve funcionar aqui (recomendando que você use recursos de string constantes em 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 um exemplo mais completo e mais detalhes, confira este guia para enviar dados simples para outros aplicativos .

O trecho de código acima irá gerar algo como o fluxo de convite mostrado nas telas abaixo:

Compartilhamento no Android

Para desenvolvedores iOS, você pode usar um UIActivityViewController , passando o link criado como parte dos dados para o VC personalizado. Esse método forneceria um fluxo de compartilhamento semelhante às telas abaixo:

Compartilhamento no iOS

Receba um Dynamic Link em seu aplicativo

Por fim, a última etapa para fornecer compartilhamento de usuário para usuário para seu aplicativo após o pôr do sol é receber um link dinâmico em seu aplicativo.

Para Android, esse processo permanece o mesmo, então você não precisará mudar muito aqui. A única diferença é que, sem o Firebase Invites, não haverá mais um ID de convite e, portanto, você precisaria remover a chamada para extrair o ID do convite via FirebaseAppInvite invite = FirebaseAppInvite.getInvitation(data) , se seu aplicativo estiver fazendo essa chamada . Para obter mais detalhes sobre este artigo, consulte o guia sobre como receber links dinâmicos em seu aplicativo Android .

Para iOS, isso exigiria a mudança do objeto FIRReceivedInvite para o objeto FIRDynamicLink , que contém dados semelhantes. Consulte o guia sobre como receber links dinâmicos em seu aplicativo iOS para obter mais detalhes.

Para desenvolvedores do Unity, há várias bibliotecas de código aberto e soluções equivalentes às descritas acima para migrar sua 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 vinculados mais abaixo.

O Firebase Invites tem sido uma ótima ferramenta que temos orgulho de ter criado. À medida que olhamos para o futuro, temos o prazer de 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 você tiver alguma dúvida sobre como configurar seus links dinâmicos do Firebase e soluções de compartilhamento personalizadas, entre em contato com o StackOverflow ou qualquer um de nossos fóruns de suporte adicionais .

,

O Firebase Invites forneceu um mecanismo para receber links dinâmicos do Firebase em seu aplicativo, bem como um recurso para compartilhar esse link por SMS ou e-mail. Desenvolvemos o Firebase Invites para ajudar você a aumentar os usuários do seu aplicativo por meio do boca a boca, mas, com o tempo, descobrimos 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 usavam o Firebase Dynamic Links como o principal ingrediente de sua solução de compartilhamento de usuário para usuário. Portanto, estamos fortalecendo nosso foco e aumentando nosso esforço para tornar o Firebase Dynamic Links a melhor maneira de criar recursos de compartilhamento de usuário para usuário em seu aplicativo. Como parte dessa mudança, suspendemos o uso do recurso Firebase Invites e descontinuaremos o suporte 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, seus usuários não poderão mais enviar ou receber convites do Firebase, e o serviço de back-end de convites começará a retornar respostas de erro ao fazer chamadas para enviar e receber um link de convite. Os SDKs atuais incluem tratamento de erros para ajudar a garantir casos de falha normais para essas respostas do servidor, para que seus usuários possam continuar 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 Links dinâmicos com uma solução de compartilhamento personalizada.

Aqui está como fazer isso!

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

Crie uma solução de compartilhamento

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

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

Algo semelhante ao exemplo a seguir deve funcionar aqui (recomendando que você use recursos de string constantes em 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 um exemplo mais completo e mais detalhes, confira este guia para enviar dados simples para outros aplicativos .

O trecho de código acima irá gerar algo como o fluxo de convite mostrado nas telas abaixo:

Compartilhamento no Android

Para desenvolvedores iOS, você pode usar um UIActivityViewController , passando o link criado como parte dos dados para o VC personalizado. Esse método forneceria um fluxo de compartilhamento semelhante às telas abaixo:

Compartilhamento no iOS

Receba um Dynamic Link em seu aplicativo

Por fim, a última etapa para fornecer compartilhamento de usuário para usuário para seu aplicativo após o pôr do sol é receber um link dinâmico em seu aplicativo.

Para Android, esse processo permanece o mesmo, então você não precisará mudar muito aqui. A única diferença é que, sem o Firebase Invites, não haverá mais um ID de convite e, portanto, você precisaria remover a chamada para extrair o ID do convite via FirebaseAppInvite invite = FirebaseAppInvite.getInvitation(data) , se seu aplicativo estiver fazendo essa chamada . Para obter mais detalhes sobre este artigo, consulte o guia sobre como receber links dinâmicos em seu aplicativo Android .

Para iOS, isso exigiria a mudança do objeto FIRReceivedInvite para o objeto FIRDynamicLink , que contém dados semelhantes. Consulte o guia sobre como receber links dinâmicos em seu aplicativo iOS para obter mais detalhes.

Para desenvolvedores do Unity, há várias bibliotecas de código aberto e soluções equivalentes às descritas acima para migrar sua 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 vinculados mais abaixo.

O Firebase Invites tem sido uma ótima ferramenta que temos orgulho de ter criado. À medida que olhamos para o futuro, temos o prazer de 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 você tiver alguma dúvida sobre como configurar seus links dinâmicos do Firebase e soluções de compartilhamento personalizadas, entre em contato com o StackOverflow ou qualquer um de nossos fóruns de suporte adicionais .