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, é possível definir públicos-alvo com base nas métricas do Google Analytics e personalizar seu aplicativo com o Configuração remota do Firebase diretamente do Console do Firebase.

Usando esses dois recursos juntos, é possível personalizar a tela de boas-vindas do seu app para um usuário repetido 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. Defina a Configuração remota para manter os parâmetros dos elementos que vão ser personalizados. 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 e/ou propriedades de usuário para que a Configuração remota segmente 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 da Configuração remota para personalizar seu parâmetro com base nos públicos do Google Analytics ou nas propriedades do usuário que você configurou.

Configurar parâmetros na Configuração remota

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

O que fazer no Firebase console

  1. Acesse a página parâmetro da Configuração remota no Firebase console. Se você nunca configurou a Configuração remota no seu aplicativo, clique em Adicione 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 app no 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 a Configuração remota do Firebase no Android para ler e exibir o parâmetro que você criou no console. Se não souber como prosseguir, consulte as instruções do Android durante 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 se funciona

  1. Abra o app e verifique se ele exibe o valor atual do parâmetro na IU da Configuração remota.
  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 públicos-alvo do Analytics ou propriedades do usuário

Nesta etapa, você vai usar o Analytics para definir os usuários que devem ver conteúdo personalizado. Neste passo a passo, vamos usar uma propriedade de usuário para fazer isso, mas você também pode definir um público. 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 Firebase console

  1. Acesse a página Propriedade de usuário do Analytics no Firebase console. Clique em Nova propriedade de 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 Analytics DebugView no Firebase console.
  3. Verifique se as propriedades do usuário foram definidas (pode levar alguns minutos até que algo apareça).

Configurar as condições da Configuração remota

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 Firebase console

  1. Acesse Configuração remota no Firebase console.
  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 de usuário (ou Usuário no público, se tiver criado um público no Analytics), selecione seu parâmetro e defina uma relação condicional com os parameter values.

    Uma nova 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 Analytics DebugView no Firebase console.
  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.