Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Lorsque vous implémentez l'association de comptes dans votre action, vous gérez les données utilisateur. Il est donc particulièrement important de respecter les bonnes pratiques en matière d'association de comptes.
De plus, le respect des bonnes pratiques permet d'offrir une expérience utilisateur simple qui maximise le nombre d'utilisateurs qui associent leur compte. Pour une expérience utilisateur optimale, votre action doit respecter les consignes relatives aux conversations générales de Google en plus des bonnes pratiques présentées ici.
Cette page présente les bonnes pratiques de conversation et d'implémentation pour votre action utilisant l'association de comptes.
Conversation
Lorsque vous concevez la conversation pour votre action utilisant l'association de comptes, veillez à suivre ces consignes:
N'utilisez l'association de comptes que si l'accès aux données des comptes des utilisateurs offre une expérience plus riche pour votre action. Par exemple, l'association de comptes peut améliorer une action de commande de boissons en permettant à celle-ci de mémoriser les boissons préférées d'un utilisateur et de suggérer de nouvelles boissons à essayer en fonction de ses commandes passées. Si vous souhaitez seulement associer un compte afin que votre action puisse faire référence à l'utilisateur par son nom, l'association de compte n'est pas nécessaire.
N'utilisez pas l'invite d'association de comptes comme première invite de votre action.
Demander aux utilisateurs d'associer leur compte avant qu'ils puissent lancer votre action peut entraîner une expérience frustrante. Invitez plutôt l'utilisateur à associer son compte lorsqu'il est nécessaire de collecter les données pour continuer.
Par exemple, le premier message d'une action de commande de boissons à l'utilisateur pourrait être : "Bienvenue chez Boba Bonanza ! Tu es prêt à passer commande ou veux-tu que je passe les boissons avec toi ?" Dans ce cas, l'utilisateur doit pouvoir entendre les options de boissons sans se connecter. Lorsqu'il demande à commander une boisson, l'action doit ensuite demander à l'utilisateur d'associer son compte.
Personnalisez la chaîne de contexte dans l'intent d'aide à la connexion au compte afin d'indiquer pourquoi vous souhaitez que l'utilisateur associe son compte. Il est nécessaire de fournir du contexte pour s'assurer que les utilisateurs se sentent à l'aise avec l'utilisation de leurs données.
Pour notre exemple d'action de commande de boissons, vous pouvez fournir la chaîne de contexte suivante: Pour mémoriser vos boissons préférées et proposer des suggestions personnalisées...
L'association de comptes ne doit pas nécessiter d'appel explicite du côté de l'utilisateur. En d'autres termes, l'utilisateur ne devrait jamais avoir à dire "Se connecter" pour associer son compte. L'utilisateur doit avoir la possibilité d'effectuer une action nécessitant une association de compte. Votre action doit ensuite lui indiquer qu'elle doit associer son compte pour le faire.
Il s'agit d'une bonne pratique générale pour l'authentification et l'autorisation. Les utilisateurs sont plus susceptibles d'associer leur compte s'ils savent pourquoi vous avez besoin de leurs informations de compte.
Par exemple, dans l'action fictive de commande de boissons, l'utilisateur ne doit pas être invité à associer son compte tant qu'il n'a pas demandé à commander une boisson, ce qui l'oblige à associer son compte.
Une fois que l'utilisateur a associé son compte, vous devez répéter toutes les options dont il dispose maintenant que son compte est associé. Par exemple, une fois que l'utilisateur a associé son compte à l'action de commande de boissons fictive, votre action peut ressembler à ceci: "Maintenant que votre compte est associé, vous pouvez commander une boisson, consulter des suggestions de boissons qui pourraient vous plaire ou voir les nouveautés du menu. Alors, que souhaitez-vous faire ?"
Si votre utilisateur n'autorise pas Google à accéder à son compte, vous pouvez lui fournir un autre "flux invité" limité via votre action. Dans ce cas, vous devez indiquer à l'utilisateur ce qu'il peut faire sans associer son compte.
Par exemple, si l'utilisateur ne donne pas son autorisation, la conversation avec votre action de commande de boissons peut se présenter comme suit:
Assistant
Pour recevoir votre commande habituelle, j'ai besoin de votre nom, etc. Puis-je les avoir envoyés par Google ?
Utilisateur
Non
Assistant
D'accord, vous pouvez toujours consulter le menu ou consulter les remises du jour. Que souhaitez-vous faire ?
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eAccount linking should only be used to enhance user experience with personalized features, not for basic functionalities like addressing the user by name.\u003c/p\u003e\n"],["\u003cp\u003eThe account linking prompt should be integrated naturally into the conversation flow, triggered when user actions require account access, rather than being the initial interaction.\u003c/p\u003e\n"],["\u003cp\u003eTransparency is crucial; clearly explain why account linking is needed using the context string in the Account Sign-in helper intent to foster user trust.\u003c/p\u003e\n"],["\u003cp\u003eUsers should not have to explicitly request account linking; the Action should guide them through the process when necessary based on their chosen actions.\u003c/p\u003e\n"],["\u003cp\u003eOffer a limited 'guest flow' for users who decline account linking, ensuring they still have access to basic functionalities and outlining the limitations.\u003c/p\u003e\n"]]],["Account linking should enhance user experience, not be a barrier. Prompt users to link accounts only when necessary for features, like remembering preferences. Provide context for why linking is needed, using a customized string. Avoid requiring explicit \"sign in\" commands; instead, offer account-linked actions. After linking, showcase new options. If users decline consent, provide a limited 'guest flow' with alternative functionalities, outlining its capabilities. If issues related to account linking cause users to consistently leave the Action, Google will not actively promote it.\n"],null,["# Best practices (Dialogflow)\n\nWhen 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------------\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 context string in the [Account Sign-in helper intent](/assistant/df-asdk/helpers#account_sign-in)\n to communicate why you need the user to link their account.** It's necessary\n to provide context 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 context string: *\"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|-----------|---------------------------------------------------------------------------------------------|"]]
