Personalizar uma tela de boas-vindas

Conteúdo personalizado pode encantar seus usuários e fornecer uma experiência desde a primeira interação com seu aplicativo com base nas preferências, histórico de uso e local deles. Com o Firebase, você define públicos-alvo com base Google Analytics e personalize seu aplicativo com Firebase Remote Config diretamente do console do Firebase.

Usando esses dois recursos juntos, é possível personalizar as boas-vindas do app tela para um usuário recorrente com base nas preferências ou atividades dele no aplicativo.

Este guia vai orientar você no processo de criação da sua tela de boas-vindas no Android.

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

Visão geral da implementação

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

1. Configure Remote Config para manter os parâmetros dos elementos que serão personalizado. Por exemplo, é possível armazenar a mensagem da tela de boas-vindas como um parâmetro. Dessa forma, é possível atualizar a mensagem sem republicar o aplicativo.
2. Configure o Analytics para definir públicos-alvo e/ou propriedades do usuário para Remote Config para segmentar os usuários. Ambos os recursos podem ser usados para segmentação. No entanto, há diferenças importantes entre eles. As vantagens relativas de cada um são discutidas mais adiante neste guia.
3. Configure as condições Remote Config para personalizar seu parâmetro com base em os públicos-alvo Analytics ou as propriedades do usuário que você configurou.

Configurar parâmetros em Remote Config

Depois de identificar os elementos do app que você quer personalizar, use Remote Config para armazenar parâmetros. Vamos explorar a personalização da mensagem da tela de boas-vindas no restante deste guia.

O que fazer no Console do Firebase

1. Acesse o parâmetro Remote Config. no console do Firebase. Se que você nunca tenha configurado o Remote Config no seu app, 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.

   Configuração do parâmetro da Configuração remota.">

3. Clique em Publicar alterações.

O que fazer no app Android

1. Adicione o código para ler e exibir o parâmetro que você acabou de adicionar ao seu app na Console do Firebase. 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 que você criou no console. Se você receber travado, o tutorial do Android orienta você com a implementação do app de exemplo.

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

Verificar o funcionamento

1. Abra o app e verifique se ele mostra o valor atual do parâmetro. na interface Remote Config.
2. Altere o valor no console e clique em Publicar alterações.
3. Reinicie o app. O novo valor do parâmetro deve ser exibido.

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

Nesta etapa, você vai usar Analytics para definir os usuários que vão receber conteúdo personalizado. Neste tutorial, usaremos uma propriedade do usuário para fazer isso mas também é possível definir Público-alvo. Essas abordagens são semelhantes, mas você deve estar ciente de que, uma vez que um usuário é adicionado a um público, ele não pode deixá-lo ou ser removido. Se o atributo que você quer usar para a segmentação pode mudar, use uma propriedade de usuário em vez disso.

O que fazer no Console do Firebase

1. Acesse a propriedade do usuário 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 estiver personalizando um aplicativo com base na preferência de um usuário por cães ou gatos, é possível dar à propriedade o nome animal_preference.

   Configuração da propriedade do usuário do Analytics.">

3. Clique em Criar.

O que fazer no app Android

1. Siga as etapas em Definir propriedades do usuário para aprender a definir a propriedade de usuário no seu aplicativo. Por exemplo, é possível perguntar a um usuário se ele prefere gatos ou cachorros e definir um valor de string correspondente. É possível ignorar as etapas para registrar a propriedade no console, como na seção anterior.
2. Siga as etapas em Eventos de depuração para ativar o modo de depuração no app.

Verificar o funcionamento

1. Abra o app e vá até onde a propriedade de usuário está configurada.
2. Abra a página do DebugView Analytics. no console Firebase.
3. Verifique se as propriedades do usuário foram definidas (pode levar alguns minutos até que algo apareça).

Configurar as condições Remote Config

Agora que seu aplicativo dispõe de parâmetros que podem ser configurados e propriedades do usuário (ou público) para serem usadas como variáveis, é possível criar condições para personalizar os valores dos seus parâmetros.

O que fazer no Console do Firebase

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

6. Em Aplicável se, selecione Propriedade do usuário (ou Usuário no público se você criou um público-alvo em Analytics) e selecionou o parâmetro, e defina uma relação condicional com os valores dos parâmetros.

   Condição da Configuração remota.">

7. Clique em Criar condição.

8. Insira um valor que reflita a nova condição. Por exemplo, a mensagem de boas-vindas para "Prefere gatos" pode ser "Miau!".

9. Clique em Update to save your changes.

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

Verificar o funcionamento

1. Abra o app e vá até onde a propriedade de usuário está configurada.
2. Abra a página do DebugView Analytics. no console Firebase.
3. Verifique se as propriedades do usuário foram definidas (pode levar alguns minutos até que algo apareça).
4. Reinicie o app e verifique se os elementos personalizados foram configurados.