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 que você defina públicos com base nas métricas do Google Analytics e personalize 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 de seu aplicativo para um usuário recorrente com base em suas preferências ou atividades em seu aplicativo.

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

Para começar, você precisará de um aplicativo Android conectado a um projeto do Firebase. Se ainda não tiver um, consulte Introdução ao 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 os parâmetros dos elementos a serem personalizados. Por exemplo, você pode armazenar a mensagem da tela de boas-vindas como um parâmetro. Dessa forma, você pode atualizar a mensagem sem republicar seu aplicativo.
  2. Configure o Analytics para definir públicos e/ou propriedades do usuário para o Configuração remota para 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 Remote Config 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 Remote Config

Depois de identificar os elementos do seu aplicativo que deseja personalizar, use o Remote Config para armazenar os 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 Remote Config no console do Firebase. Se você nunca configurou o Remote Config em seu aplicativo, clique em Add Your First Parameter .
  2. Preencha uma chave de parâmetro e um valor padrão. Por exemplo, welcome_message e Welcome to this sample app .

    Configuração de parâmetro do Remote Config.

  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 configuração remota do Firebase no Android para ler e exibir o parâmetro que você criou no console. Se você ficar preso, o passo a passo do Android o guiará pela implementação do aplicativo de amostra funcional.

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

Teste que funciona

  1. Abra seu aplicativo e verifique se ele mostra o valor atual do parâmetro na IU do Remote Config .
  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 do Google Analytics ou propriedades do usuário

Nesta etapa, você usará o Analytics para definir os usuários que devem 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 uma vez que um usuário é adicionado a um Audience, ele não pode deixá-lo 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ê estiver personalizando um aplicativo com base na preferência de um usuário por cães ou gatos, poderá nomeá-lo como animal_preference .

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

  3. Clique em Criar .

O que fazer no aplicativo Android

  1. Siga as etapas em Definir propriedades do usuário para aprender a definir sua propriedade de usuário em 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, pois já fez isso na seção anterior.
  2. Siga as etapas em Eventos de depuração para habilitar o modo de depuração para seu aplicativo.

Teste que 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 qualquer coisa apareça).

Configurar as condições do Remote Config

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 de 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 do usuário anterior.
  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 uma relação condicional com os valores de seus parâmetros.

    Uma nova condição de configuração remota.

  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" pode ser "Miau!".

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

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

Teste que 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 qualquer coisa apareça).
  4. Reinicie seu aplicativo e verifique se seus elementos personalizados foram definidos.