Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando implementas la vinculación de cuentas en tu Acción, controlas los datos del usuario, por lo que es muy importante cumplir con las prácticas recomendadas de vinculación de cuentas.
Además, seguir las prácticas recomendadas proporciona una experiencia del usuario con pocas fricciones que maximiza la cantidad de usuarios que vinculan correctamente su cuenta. Tu acción debe seguir los lineamientos de conversación generales de Google, además de las prácticas recomendadas que se presentan aquí para brindar una mejor experiencia del usuario.
En esta página, se describen las prácticas recomendadas de implementación y de conversación para tu acción que usa la vinculación de cuentas.
Conversación
Cuando diseñes la conversación para tu acción que use la vinculación de cuentas, asegúrate de seguir estos lineamientos:
Solo usa la vinculación de cuentas si el acceso a los datos de la cuenta de los usuarios proporciona una
experiencia más enriquecida para tu Acción. Por ejemplo, usar la vinculación de cuentas podría mejorar una Acción de pedido de bebidas, ya que permitir que esta recuerde las bebidas favoritas de un usuario y sugiera nuevas bebidas para probar según sus pedidos anteriores. Si solo deseas vincular una cuenta para que tu Acción pueda referirse al usuario por su nombre, no es necesario vincular la cuenta.
No uses la solicitud de vinculación de cuentas como el primer mensaje de tu Acción.
Solicitar a los usuarios que vinculen su cuenta antes de poder iniciar tu Acción puede causar una experiencia frustrante. En su lugar, pídele al usuario que vincule su cuenta cuando sea necesario recopilar los datos para que los usuarios continúen.
Por ejemplo, el primer mensaje de una Acción de pedido de bebidas para el usuario podría ser: "Welcome to Boba Bonanza! ¿Todo listo para pedir
o quieres que los acompañe? En este caso, el usuario debería poder escuchar
las opciones de tragos sin acceder. Cuando pide pedir una bebida, la Acción debe pedirle al usuario que vincule su cuenta.
Personaliza la justificación en la escena del sistema de vinculación de cuentas para comunicar por qué necesitas que el usuario vincule su cuenta. Es necesario proporcionar una justificación clara para asegurarse de que los usuarios se sientan cómodos con la manera en que se usan sus datos.
En nuestro ejemplo de acción de pedido de bebidas, puedes proporcionar la siguiente justificación: "To remember your public bebidas and offer custom usarlo..." (Recuerda tus bebidas favoritas y ofrece sugerencias personalizadas).
La vinculación de cuentas no debe requerir una invocación explícita desde el extremo del usuario. En otras palabras, el usuario nunca debería tener que decir “acceder” para vincular su cuenta. En cambio, se le debe ofrecer la opción de hacer algo que requiera la vinculación de una cuenta. Luego, tu Acción debe indicarles que deben vincular su cuenta para hacerlo.
Este lineamiento es una práctica recomendada general para la autenticación y la autorización. Es más probable que los usuarios vinculen sus cuentas cuando sepan por qué necesitas la información de su cuenta.
Por ejemplo, en la acción hipotética de pedido de bebidas, no se le debe pedir al usuario que vincule su cuenta hasta que solicite pedir una bebida, lo que requiere que vincule su cuenta.
Después de que el usuario vincula su cuenta, debes reiterar todas las opciones que tiene ahora que la cuenta está vinculada. Por ejemplo, una vez que el usuario haya vinculado su cuenta en la acción hipotética de pedido de bebidas, tu acción podría decir algo como lo siguiente: "Ahora que tu cuenta está vinculada, puedes pedir un trago, consultar sugerencias de bebidas que podrían gustarte o ver las novedades del menú. Entonces, ¿qué te gustaría hacer?".
Si el usuario no otorga su consentimiento para que Google acceda a su cuenta, puedes proporcionarle un "flujo de invitado" alternativo y limitado a través de tu Acción. En este caso, debes comunicarle al usuario lo que puede hacer sin vincular su cuenta.
Por ejemplo, si el usuario no da su consentimiento, la conversación con tu acción de pedido de bebidas podría verse de la siguiente manera:
Asistente
Para recibir tu pedido de siempre, necesito tu nombre, etc. ¿Puedo pedirlos a
Google?
Usuario
No
Asistente
Muy bien. Aún puedes ver el menú o consultar los descuentos de hoy. ¿Qué
te gustaría hacer?
[null,null,["Última actualización: 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|-----------|---------------------------------------------------------------------------------------------|"]]
