Login e logout automáticos

Esta página descreve como implementar recursos relacionados ao modo como os usuários fazem login ou saem com o Google One Toque.

Fazer login dos usuários automaticamente

O Google One Tap é compatível com login automático, o que proporciona uma experiência do usuário (UX) fácil ao remover as etapas manuais que os visitantes precisam seguir ao retornar ao seu site. Os usuários não precisam lembrar qual Conta do Google foi selecionada durante o último acesso, o que reduz as chances de uma conta duplicada desnecessária ser criada na plataforma.

O login automático serve para complementar as caixas de diálogo do botão "Fazer login com o Google" e das caixas de diálogo com um toque. Ele foi criado para ser usado em todo o site. A inscrição manual ou a troca de contas ocorrem somente depois que o usuário sai do site.

Para que o login automático ocorra, as seguintes condições são necessárias:

  • primeiro, os usuários precisam estar conectados à Conta do Google.
  • tenha dado consentimento para compartilhar o perfil da conta dele com seu app;
  • ao usar o FedCM, fizeram apenas uma tentativa de login nos últimos 10 minutos. Um toque aparece quando ocorrem tentativas de login repetidas durante essa janela.
  • ao usar a FedCM, o Chrome exige que os usuários confirmem novamente se querem fazer login no site com a Conta do Google em cada instância do Chrome, mesmo que o usuário tenha aprovado o site antes do lançamento da FedCM. Essa mudança pode afetar a taxa de conversão no seu site atual usando o recurso de um toque. Na atualização do Chrome M121, a melhoria do Login automático diminui o problema de queda na taxa de conversão.

Para páginas em que o login automático está ativado e essas condições são atendidas, a credencial do token de ID dos visitantes é retornada automaticamente sem qualquer interação do usuário. Se essas condições não forem atendidas, e mesmo que o login automático esteja ativado na página, o usuário usará por padrão o fluxo de um toque para login ou consentimento. Se um usuário tiver várias Contas do Google e acessar seu site, ele precisará primeiro fazer login em uma única Conta do Google e fornecer o consentimento para ela.

Você pode medir a taxa de êxito de login automático usando o valor auto no campo select_by do objeto de credencial retornado.

Para ativar o login automático, adicione data-auto_select="true" ao seu código, conforme mostrado no snippet a seguir:

<div id="g_id_onload"
     data-client_id="YOUR_GOOGLE_CLIENT_ID"
     data-login_uri="https://your.domain/your_login_endpoint"
     data-auto_select="true">
</div>

Sair

Quando um usuário sai do seu site, ele pode ser direcionado para uma página em que uma solicitação do Google One Tap é exibida automaticamente. Para essa configuração, a seleção automática precisa ser proibida. Caso contrário, o usuário será conectado de novo automaticamente, o que levará a uma UX de loop morto.

Como usar o FedCM

Para melhorar a experiência do usuário, há um período de silêncio de 10 minutos entre cada tentativa de login automático. Durante esse período, a opção "Um toque" é exibida.

Sem FedCM

Para proibir a seleção automática depois que um usuário sair, adicione o nome de classe g_id_signout a todos os links e botões de saída. Confira o snippet de código a seguir:

<div class="g_id_signout">Sign Out</div>

O snippet de código JavaScript a seguir também pode ser usado para sair:

const button = document.getElementById('signout_button');
button.onclick = () => {
  google.accounts.id.disableAutoSelect();
}

Consequentemente, o status de logout é registrado por meio de um cookie no seu domínio para que a UX de loop morto seja evitada.

O status de logout é armazenado no cookie g_state no seu domínio. Se você tiver um serviço que monitore todos os cookies usados no seu domínio, será necessário notificá-los sobre esse cookie.

Se você não quiser carregar a biblioteca de cliente nas páginas pós-login, use estas soluções para evitar uma UX de loop morto após a saída da conta:

  • Ao sair, redirecione os usuários para uma página (por exemplo, https://example.com/logged_out) em que o recurso "Um toque" não seja exibido ou em que o login automático esteja sempre desativado.
  • Ao sair, adicione um parâmetro ao URL. Por exemplo, logged_out=1. Ao renderizar a API One Tap by JavaScript, verifique o parâmetro de URL e desative o login automático quando houver.

Principais jornadas do usuário

A página de login automático.

Como usar o FedCM

Pop-up de login automático do FedCM

Se os usuários não clicarem no X para cancelar em até cinco segundos, um token de ID será compartilhado com o site.

Sem FedCM

Pop-up de login automático.

Se os usuários não clicarem no botão Cancelar em até cinco segundos, um token de ID será compartilhado com seu site.

Quando o login é cancelado, com base no número de sessões do Google ativas, a página do seletor de conta ou a página do usuário recorrente é exibida.

  • Várias sessões do Google

    Como usar o FedCM

    Página do seletor de conta da FedCM

    Sem FedCM

    Página do seletor de conta

  • Sessões únicas do Google

    Como usar o FedCM

    Página do seletor de conta da FedCM

    Sem FedCM

    Página do usuário para retornar com um toque