Ir para o console

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. O Firebase permite que você defina públicos de acordo com as métricas do Google Analytics para Firebase e personalize o seu aplicativo com o Configuração remota do Firebase diretamente do Firebase console.

Usando esses dois recursos juntos, você pode 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 orientará você no processo de criação da sua própria tela de boas-vindas no Android.

Para começar, você precisa 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 o Configuração remota para manter os parâmetros dos elementos que serão 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 o aplicativo.
  2. Configure o Analytics para definir públicos e/ou propriedades de usuário para que o 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 do 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 no Configuração remota

Depois de identificar os elementos do seu app que você quer personalizar, use o 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 Firebase console

  1. Acesse a página parâmetro do Configuração remota no Firebase console. Se você nunca definiu o Configuração remota no seu app, clique em Adicionar o 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 do Configuração remota.

  3. Clique em Publicar alterações.

O que fazer no app para Android

  1. Adicione o código para ler e exibir o parâmetro que você acabou de adicionar ao app no Firebase console. 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 Configuração remota do Firebase no Android para ler e exibir o parâmetro que você criou no console. Se não souber o que fazer, consulte as instruções do Android na implementação do exemplo de app.

  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 do Configuração remota.
  2. Altere o valor no console e clique em Publicar alterações.
  3. Reinicie o aplicativo. O novo valor do parâmetro deverá ser exibido.

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

Nesta etapa, você usará o Analytics para definir os usuários que devem ver conteúdo personalizado. Neste passo a passo, usaremos 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, você pode dar à propriedade o nome animal_preference.

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

  3. Clique em Criar.

O que fazer no app para 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, você pode perguntar a um usuário se ele prefere gatos ou cachorros e definir um valor de string correspondente. Você pode 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 se funciona

  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 do 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, você pode 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 do 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 Atualizar para salvar as alterações.

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

Verificar se funciona

  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.