Esta página descreve como implementar recursos relacionados a como os usuários fazem login ou saem com o Google One Toque.
Fazer login de usuários automaticamente
O Google One Toque é compatível com o login automático, o que proporciona uma experiência do usuário (UX) simples ao remover as etapas manuais que os visitantes precisam seguir ao retornar ao site. Os usuários não precisam lembrar qual Conta do Google foi selecionada durante a última visita, diminuindo as chances de criar contas duplicadas desnecessárias na plataforma.
O login automático tem como objetivo complementar as caixas de diálogo do botão "Fazer login com o Google" e das caixas de diálogo de um toque. Ele foi projetado 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 fazer login na Conta do Google.
- consentiu anteriormente em compartilhar o perfil da conta com o app;
- ao usar o FedCM, fizeram apenas uma única tentativa de login nos últimos 10 minutos. Um toque é exibido quando ocorrem várias tentativas de login durante essa janela.
Nas 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á o fluxo de um toque por padrão 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 essa conta.
Você pode medir a taxa de sucesso do 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 é direcionado para uma página em que uma solicitação do Google One Toque é exibida automaticamente. Para essa configuração, a seleção automática precisa ser proibida. Caso contrário, o usuário será conectado automaticamente de novo, o que leva a uma UX de loop morto.
Uso do 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, um toque aparece.
Sem FedCM
Para proibir a seleção automática depois que um usuário sair, adicione o nome da classe
g_id_signout a todos os links e botões de logout. 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 usuário desconectado é registrado usando um cookie no seu domínio para evitar a UX de loop morto.
O status de logout é armazenado no cookie g_state no seu domínio. Se você tiver um serviço que monitora 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 suas páginas pós-login, use estas soluções para evitar uma UX contínua após a saída:
- 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 o recurso Um toque da API 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.
Uso 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
Se os usuários não clicarem no botão Cancel em até cinco segundos, um token de código 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
Uso do FedCM
Sem FedCM
Sessões únicas do Google
Uso do FedCM
Sem FedCM
