Personalizar uma tela de boas-vindas

O conteúdo personalizado pode encantar seus usuários e fornecer uma experiência desde a primeira interação com seu aplicativo com base em suas preferências, histórico de uso e localidade. O Firebase permite definir públicos com base nas métricas do Google Analytics e personalizar seu aplicativo com o Firebase Remote Config diretamente do console do Firebase.

Usando esses dois recursos juntos, você pode personalizar a tela de boas-vindas do seu aplicativo para um usuário recorrente com base em suas preferências ou atividades no seu aplicativo.

Este guia orienta você no processo de criação de sua própria tela personalizada de "boas-vindas" no Android.

Para começar, você precisará de um aplicativo Android conectado a um projeto do Firebase. Se você ainda não tiver um, consulte Primeiros passos para Android para conectar seu aplicativo.

Visão geral da implementação

A implementação da tela de boas-vindas personalizada do seu aplicativo consiste em três etapas amplas:

1. Configure o Remote Config para manter parâmetros dos elementos a serem personalizados. Por exemplo, você pode armazenar a mensagem da tela de boas-vindas como parâmetro. Dessa forma, você pode atualizar a mensagem sem republicar seu aplicativo.
2. Configure o Analytics para definir públicos e/ou propriedades de usuário para a Configuração remota segmentar seus usuários. Ambos os recursos podem ser usados ​​para segmentação; no entanto, existem diferenças importantes entre eles. As vantagens relativas de cada um são discutidas posteriormente neste guia.
3. Configure as condições do Configuração remota para personalizar seu parâmetro com base nos públicos do Analytics ou nas propriedades do usuário que você configurou.

Configurar parâmetros no Configuração remota

Depois de identificar os elementos do seu app que deseja personalizar, use a Configuração remota para armazenar parâmetros. Exploraremos a personalização da mensagem da tela de boas-vindas no restante deste guia.

O que fazer no console do Firebase

1. Acesse a página de parâmetros do Configuração remota no console do Firebase. Se você nunca configurou o Configuração remota no seu aplicativo, clique em Adicionar seu primeiro parâmetro .

2. Preencha uma chave de parâmetro e um valor padrão. Por exemplo, welcome_message e Welcome to this sample app .

   

3. Clique em Publicar alterações .

O que fazer no aplicativo Android

1. Adicione o código para ler e exibir o parâmetro que você acabou de adicionar ao seu aplicativo no Firebase Console. Por exemplo:

   final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
   config.getInstance.fetch(CACHE_EXPIRATION_MS)
     .addOnCompleteListener(this, new OnCompleteListener<Void>() {
       @Override
       public void onComplete(@NonNull Task<Void> task) {
           if (task.isSuccessful()) {
               config.activateFetched();
   
               String welcomeMessage = config.getString("welcome_message");
           }
       }
   });
   

   Você também pode seguir as etapas em Usar o Firebase Remote Config no Android para ler e exibir o parâmetro criado no console. Se você tiver dúvidas, o passo a passo do Android o guiará pela implementação funcional do aplicativo de exemplo.

2. Ative o modo de desenvolvedor para ver as alterações de configuração imediatamente durante o teste.

Teste se funciona

1. Abra seu aplicativo e verifique se ele mostra o valor atual do parâmetro na IU do Configuração remota .
2. Altere o valor no console e clique em Publicar alterações
3. Reinicie seu aplicativo. O novo valor do parâmetro deve ser mostrado.

Configurar públicos-alvo ou propriedades de usuário do Analytics

Nesta etapa você usará o Analytics para definir os usuários que deverão ver o conteúdo personalizado. Neste passo a passo, usaremos uma propriedade de usuário para fazer isso, mas você também pode definir um Audience . Essas abordagens são semelhantes, mas você deve estar ciente de que, depois que um usuário é adicionado a um público, ele não pode sair dele ou ser removido. Se o atributo que você deseja usar para segmentação puder mudar, use uma propriedade de usuário.

O que fazer no console do Firebase

1. Acesse a página de propriedades do usuário do Analytics no console do Firebase. Clique em Nova propriedade do usuário .

2. Dê um nome e uma descrição à propriedade do usuário. Por exemplo, se você estivesse personalizando um aplicativo com base na preferência do usuário por cães ou gatos, você poderia nomeá-lo animal_preference .

   

3. Clique em Criar .

O que fazer no aplicativo Android

1. Siga as etapas em Definir propriedades do usuário para aprender a definir a propriedade do usuário no seu aplicativo. Por exemplo, você pode perguntar a um usuário se ele prefere gatos ou cachorros e definir um valor de string de acordo. Você pode pular as etapas para registrar sua propriedade no console, como já fez na seção anterior.
2. Siga as etapas em Eventos de depuração para ativar o modo de depuração para seu aplicativo.

Teste se funciona

1. Abra seu aplicativo e navegue até onde sua propriedade de usuário está definida.
2. Abra a página Analytics DebugView no console do Firebase.
3. Verifique se alguma propriedade do usuário foi definida (pode haver alguns minutos de atraso antes que algo apareça).

Configurar condições do Configuração remota

Agora que seu aplicativo tem parâmetros que podem ser configurados e propriedades do usuário (ou públicos) para usar como variáveis, você pode criar condições para personalizar os valores dos seus parâmetros.

O que fazer no console do Firebase

1. Acesse Configuração remota no console do Firebase.
2. Clique no seu parâmetro para editá-lo.
3. Clique em Incluir valor para condição .
4. Selecione Definir nova condição .
5. Dê um nome à sua condição. Por exemplo, "Prefere gatos" para refletir a preferência anterior do usuário.

6. Em Aplica-se se , selecione Propriedade do usuário (ou Usuário no público se você criou um público no Analytics), selecione seu parâmetro e defina um relacionamento condicional com os valores de seus parâmetros.

   

7. Clique em Criar condição .

8. Insira um valor para refletir a nova condição. Por exemplo, a mensagem de boas-vindas para “Prefere gatos” poderia ser “Miau!”.

9. Clique em Atualizar para salvar suas alterações.

10. Clique em Publicar alterações para ativar as novas condições e valores em seu aplicativo.

Teste se funciona

1. Abra seu aplicativo e navegue até onde sua propriedade de usuário está definida.
2. Abra a página Analytics DebugView no console do Firebase.
3. Verifique se alguma propriedade do usuário foi definida (pode haver alguns minutos de atraso antes que algo apareça).
4. Reinicie seu aplicativo e verifique se seus elementos personalizados foram definidos.