Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ao implementar a vinculação de conta na sua Ação, você processa dados do usuário.
Por isso, é especialmente importante seguir as práticas recomendadas de vinculação de contas.
Além disso, seguir as práticas recomendadas oferece uma experiência de usuário de baixo atrito que maximiza o número de usuários que vinculam as contas. Para melhorar a experiência do usuário, sua
Ação precisa seguir as
diretrizes de conversa
gerais do Google, além das práticas recomendadas apresentadas aqui.
Esta página aborda as práticas recomendadas de conversa e implementação para
sua ação que usa a vinculação de conta.
Conversa
Ao projetar a conversa para sua ação que usa vinculação de conta, siga estas diretrizes:
Só use a vinculação de conta se o acesso aos dados da conta dos usuários fornecer uma
experiência mais completa para a Ação. Por exemplo, o uso da vinculação de contas
pode melhorar uma ação de pedir bebidas, permitindo que ela se lembre das
bebidas favoritas de um usuário e sugira novas bebidas para experimentar com base nos pedidos
anteriores. Se você quiser vincular apenas uma conta para que sua Ação se refira ao usuário pelo
nome, não é necessário vincular a conta.
Não use a solicitação de vinculação de contas como a primeira instrução da sua ação.
Exigir que os usuários vinculem a conta antes de iniciar a ação pode
causar uma experiência frustrante. Em vez disso, solicite que o usuário vincule a
conta quando a coleta de dados for necessária para que os usuários continuem.
Por exemplo, a primeira mensagem de uma Ação de pedido de bebida para o usuário pode ser
"Bem-vindo à Boba Bonanza! Tudo pronto para fazer o pedido ou quer que eu
consiga as bebidas com você?" Nesse caso, o usuário precisa ouvir
as opções de bebida sem fazer login. Quando pedirem uma bebida,
a ação deve pedir que o usuário vincule a conta.
Personalize a lógica no cenário do sistema de vinculação de contas
para comunicar por que você precisa que o usuário vincule a conta. É necessário
fornecer uma justificativa clara para garantir que os usuários se sintam confortáveis com como os dados
estão sendo usados.
Para nossa ação de pedir bebidas, você poderia fornecer a seguinte
justificativa: "Para lembrar das suas bebidas favoritas e oferecer sugestões personalizadas..."
A vinculação de contas não pode exigir uma invocação explícita do usuário. Em outras palavras, o usuário nunca precisa dizer "fazer login" para vincular
a conta. Em vez disso, ele precisa ter a opção de fazer algo
que exija a vinculação. Sua Ação precisa informar que é necessário
vincular a conta para fazer isso.
Esta diretriz é uma prática recomendada geral para autenticação e autorização. É mais provável que os usuários vinculem a conta quando sabem por que você precisa das informações dela.
Por exemplo, na ação hipotética de pedido de bebida, o usuário não deve
ser solicitado a vincular a conta até que peça uma bebida, o que
exige a vinculação da conta.
Depois que o usuário vincular a conta, reitere todas as opções
que o usuário tem agora que a conta está vinculada. Por exemplo, depois que o usuário
vinculou a conta na Ação hipotética de pedido de bebida, sua
Ação pode dizer algo como: "Agora que sua conta
está vinculada, você pode pedir uma bebida, conferir sugestões de bebidas que você pode
gostar ou ver as novidades do menu. O que você quer fazer?"
Se o usuário não der consentimento para que o Google acesse a conta, ofereça um "fluxo de convidado" alternativo e limitado usando sua ação. Nesse caso, você precisa informar ao usuário
o que ele pode fazer sem vincular a conta.
Por exemplo, se o usuário não der consentimento, a conversa com sua
ação de pedido de bebida poderá ficar assim:
Google Assistente
Para receber seu pedido normal, preciso do seu nome etc. Posso pegar essas informações com o
Google?
Usuário
Não
Google Assistente
Certo, você ainda pode ver o cardápio ou conferir os descontos de hoje. O que
você quer fazer?
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eAccount linking should only be used to enhance user experience with richer, personalized features, not for basic functionalities like name retrieval.\u003c/p\u003e\n"],["\u003cp\u003eUsers should be prompted to link their accounts only when it's necessary for the desired action, providing a clear rationale for data access.\u003c/p\u003e\n"],["\u003cp\u003eThe account linking process should be seamlessly integrated into the conversation flow, initiated by user actions rather than explicit sign-in requests.\u003c/p\u003e\n"],["\u003cp\u003eAfter successful account linking, users should be informed about the newly available features and functionalities.\u003c/p\u003e\n"],["\u003cp\u003eOffer a limited 'guest flow' with alternative functionalities for users who decline account linking, clearly communicating the available options.\u003c/p\u003e\n"]]],["Account linking should enhance user experience, not be a barrier. Prompt users to link accounts only when necessary, such as when they initiate an action that requires it. Clearly explain the rationale for linking and customize it. Avoid explicit invocation; users shouldn't have to say \"sign in.\" After linking, reiterate the new options available. Offer a limited \"guest flow\" if users decline linking, communicating the features available without it. Ensure best practices to maintain a user-friendly action, or risk lack of promotion.\n"],null,["When you implement account linking in your Action, you are handling user data,\nso it's especially important to comply with account linking best practices.\nAdditionally, following best practices provides a low-friction user experience\nthat maximizes the number of users who successfully link their account. Your\nAction should follow Google's general\n[conversational guidelines](https://designguidelines.withgoogle.com/conversation/)\nin addition to the best practices presented here for the best user experience.\n\nThis page goes over both conversational and implementation best practices for\nyour Action that uses account linking.\n| **Note:** If users are leaving your Action consistently because of account linking issues, Google will not actively promote your Action.\n\nConversation\n\nWhen you design the conversation for your Action that uses account linking, be\nsure to follow these guidelines:\n\n- **Only use account linking if accessing users' account data provides a\n richer experience for your Action.** For example, using account linking could enhance a drink-ordering Action by allowing the Action to remember a user's favorite drinks and suggest new drinks to try based on their past orders. If you only want to link an account so your Action can refer to the user by name, then account linking isn't necessary.\n- **Don't use the account linking prompt as the first prompt of your Action.**\n Requiring users to link their account before they can start your Action can\n cause a frustrating experience. Instead, prompt the user to link their\n account when collecting the data is necessary for users to continue.\n\n For example, a drink-ordering Action's first message to the user could be,\n *\"Welcome to Boba Bonanza! Are you ready to order or do you want me to go\n through the drinks with you?\"* In this case, the user should be able to hear\n the drink options without signing in. When they ask to order a drink,\n the Action should then ask the user to link their account.\n- **Customize the rationale in the Account Linking system scene\n to communicate why you need the user to link their account.** It's necessary\n to provide a clear rationale to make sure users feel comfortable with how their data\n is being used.\n\n For our example drink-ordering Action, you could provide the following\n rationale: *\"To remember your favorite drinks and offer customized suggestions...\"*\n- **Account linking should not require an explicit invocation from the user's\n end**. In other words, the user should never have to say \"sign in\" to link\n their account; instead, the user should be given the option to do something\n that requires account linking. Your Action should then tell them that they\n need to link their account to do so.\n\n This guideline is a general best practice for authentication and\n authorization. Users are more likely to link their account when they know\n why you need their account information.\n\n For example, in the hypothetical drink-ordering Action, the user should not\n be asked to link their account until they ask to order a drink, which\n requires them to link their account.\n- **After the user links their account, you should reiterate all the options\n the user has now that their account is linked.** For example, once the user\n has linked their account in the hypothetical drink-ordering Action, your\n Action could say something like the following: *\"Now that your account's\n linked, you can order a drink, check out suggestions for drinks you might\n like, or see what's new on the menu. So, what would you like to do?\"*\n\n- **If your user doesn't give consent for Google to access their account, you\n could provide them with an alternate, limited 'guest flow' through your\n Action.** In this case, you should communicate to the user\n what they can do without linking their account.\n\n For example, if the user doesn't give consent, the conversation with your\n drink-ordering Action could look like the following:\n\n| Assistant | To get your usual order, I need your name, etc. Can I have those from Google? |\n| User | No |\n| Assistant | Okay, you can still see the menu or check out today's discounts. What would you like to do? |\n|-----------|---------------------------------------------------------------------------------------------|"]]
