Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Quando implementi il collegamento degli account nell'Azione, gestisci i dati utente,
quindi è particolarmente importante rispettare le best practice per il collegamento degli account.
Inoltre, le best practice offrono un'esperienza utente semplificata che massimizza il numero di utenti che collegano correttamente il proprio account. L'Azione deve seguire le linee guida generali per le conversazioni di Google, oltre alle best practice qui presentate, per garantire la migliore esperienza utente.
Questa pagina illustra le best practice relative alle conversazioni e all'implementazione dell'Azione che utilizza il collegamento dell'account.
Dialogo
Quando progetti la conversazione per l'Azione che utilizza il collegamento degli account, assicurati di seguire queste linee guida:
Utilizza il collegamento degli account solo se l'accesso ai dati degli account degli utenti offre un'esperienza migliore per l'Azione. Ad esempio, l'utilizzo del collegamento di account potrebbe migliorare un'Azione di ordinazione di bevande consentendo all'Azione di ricordare le bevande preferite di un utente e suggerire nuove bevande da provare in base all'ordine precedente. Se vuoi collegare un account solo in modo che l'Azione possa fare riferimento all'utente per nome, il collegamento dell'account non è necessario.
Non usare la richiesta di collegamento dell'account come prima richiesta dell'Azione.
Richiedere agli utenti di collegare il proprio account prima di poter avviare un'Azione può causare un'esperienza frustrante. Chiedi invece all'utente di collegare il proprio account
se la raccolta dei dati è necessaria affinché gli utenti possano continuare.
Ad esempio, il primo messaggio di un'azione per ordinare una bevanda all'utente potrebbe essere:
"Ti diamo il benvenuto in Boba Bonanza! È tutto pronto per ordinare o vuoi che
ti beva da bere?" In questo caso, l'utente deve poter ascoltare
le opzioni di drink senza eseguire l'accesso. Quando l'utente chiede di ordinare un drink,
l'Azione deve poi chiedere all'utente di collegare il proprio account.
Personalizza la motivazione nella scena del sistema di collegamento degli account per spiegare perché l'utente deve collegare il proprio account. È necessario fornire una motivazione chiara per assicurarsi che gli utenti si sentano a proprio agio con il modo in cui vengono utilizzati i loro dati.
Per il nostro esempio di azione per ordinare bevande, potresti fornire la seguente
razionale: "Per ricordare le tue bevande preferite e offrire suggerimenti personalizzati...".
Il collegamento degli account non deve richiedere una chiamata esplicita da parte dell'utente. In altre parole, l'utente non dovrebbe mai dover dire "Accedi" per collegare il proprio account; dovrebbe invece avere la possibilità di eseguire un'azione che richiede il collegamento dell'account. L'Azione dovrebbe poi comunicare loro che
devono collegare il proprio account per farlo.
Questa linea guida è una best practice generale per l'autenticazione e l'autorizzazione. È più probabile che gli utenti colleghino il loro account se sanno
perché hai bisogno dei dati dell'account.
Ad esempio, nell'ipotetica azione per ordinare bevande, all'utente non deve essere chiesto di collegare il proprio account fino a quando non chiede di ordinare un drink, il che richiede di collegare il proprio account.
Dopo che l'utente ha collegato il proprio account, devi ribadire tutte le opzioni di cui dispone ora che l'account è stato collegato. Ad esempio, dopo che l'utente
ha collegato il proprio account nell'ipotetica azione di ordinazione di bevande, l'azione potrebbe presentare il seguente messaggio: "Ora che il tuo account è collegato, puoi ordinare un drink, consultare i suggerimenti di bevande che potrebbero piacerti o scoprire le novità nel menu. Quindi, cosa vorresti fare?".
Se l'utente non acconsente all'accesso di Google al suo account, potresti fornire un "flusso ospite" alternativo e limitato tramite l'Azione. In questo caso, devi comunicare all'utente
cosa può fare senza collegare il suo account.
Ad esempio, se l'utente non dà il consenso, la conversazione con l'azione di ordinazione di bevande potrebbe essere la seguente:
Assistente
Per ricevere il tuo ordine abituale mi serve il tuo nome e così via. Posso riceverli da Google?
Utente
No
Assistente
Ok, puoi comunque vedere il menu o dare un'occhiata agli sconti di oggi. Che cosa vorresti fare?
[null,null,["Ultimo aggiornamento 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|-----------|---------------------------------------------------------------------------------------------|"]]
