L'API Transactions verrà ritirata il 3 maggio 2023, prima della disattivazione delle azioni di conversazione il 13 giugno 2023. Per ulteriori informazioni, vedi
Ritiro di Azioni di conversazione.
Linee guida per il design
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Progetta una conversazione per guidare gli utenti attraverso i tuoi flussi transazionali. Abbiamo fornito esempi di riferimento che puoi utilizzare come guida
per la progettazione delle tue azioni transazionali.
Esempi
Suggerimenti di progettazione
Assicurati che i dialoghi
sembrino naturali e conversazionali,
come farebbe una persona reale.
Il testo pronunciato dalla voce non deve corrispondere esattamente al testo visualizzato nelle bolle della chat. Funziona bene se le bolle della chat
sono un sottoinsieme dei dialoghi.
Saluta i visitatori e coinvolgili. Chiedi di cosa ha bisogno e offri
alcuni chip di suggerimento per aiutarli a iniziare.
Prima di invitare l'utente ad aggiungere articoli al carrello, esegui un controllo backend aggiungendo il riempimento degli slot e utilizzando il tipo di slot actions.type.TransactionRequirementsCheckResult
per confermare che l'utente abbia configurato i pagamenti per l'Assistente Google.
Preparati a rispondere con la voce agli stessi problemi riscontrati in altre esperienze web o su dispositivi mobili. Ad esempio, offri un articolo simile quando non hai una taglia o un colore specifico oppure invita gli utenti a registrarsi per ricevere una notifica quando l'articolo sarà di nuovo disponibile.
Tieni presente che il riepilogo dell'ordine viene creato con i dati trasmessi tramite l'API.
L'etichetta "Paga con Google" aiuta gli utenti a capire che il pagamento è stato facilitato da Google.
Quando chiedi informazioni ai tuoi utenti, ad esempio l'indirizzo, devi spiegare loro il motivo della richiesta e i vantaggi che possono offrire.
Google mostrerà il metodo di autorizzazione di acquisto (senza autorizzazione, password o impronta) in base alle impostazioni dell'utente. A volte, la nostra valutazione del rischio dà inizio a un'ulteriore fase di autorizzazione, come la conferma del CVV per una carta.
Una volta completato il pagamento, assicurati di inviare una ricevuta e la conferma dell'ordine. È importante che gli utenti capiscano che sei il commerciante registrato e che forniscano tutti i dettagli relativi all'ordine, non a Google.
Per impostazione predefinita, le transazioni possono essere eseguite su una piattaforma dotata di
schermo (ad esempio un telefono Android) o su una piattaforma con comandi vocali (ad esempio Google Home).
Per supportare al meglio le transazioni di sola voce, presta particolare attenzione a progettare un'esperienza di conversazione efficace che guidi gli utenti attraverso l'esperienza completa delle transazioni.
Tieni presente che alcuni intent di transazione potrebbero richiedere una schermata. La maggior parte di queste
(ad esempio l'aggiunta di un nuovo indirizzo di consegna, la risoluzione dei problemi di pagamento, il collegamento dell'account)
verrà consegnata automaticamente al telefono. Se ci sono aggiunte
alla conversazione che sono meglio mostrate su uno schermo
(ad es. presentazione di risposte avanzate per la creazione di schede, visualizzazione di TdS o norme sulla privacy del commerciante), devi controllare se la piattaforma attuale supporta le
capabilities
RICH_RESPONSE
o WEB_LINK
e trasferire su una nuova piattaforma in caso contrario.
Se preferisci non supportare le transazioni di sola voce con l'Azione, puoi impostare il progetto Actions in modo che richieda una schermata andando su Esegui il deployment > Funzionalità Surface nella Console di Actions e impostando l'opzione Le azioni richiedono un output dello schermo su Sì.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eDesign conversational transactional flows, similar to natural human interactions, guiding users through the process.\u003c/p\u003e\n"],["\u003cp\u003eUtilize provided examples and design tips to create effective and user-friendly transactional Actions.\u003c/p\u003e\n"],["\u003cp\u003eEnsure clear communication, address potential issues proactively, and inform users about Google's role in payment processing.\u003c/p\u003e\n"],["\u003cp\u003eOptimize for both screen and voice-only interactions by tailoring the conversation and utilizing surface capabilities effectively.\u003c/p\u003e\n"],["\u003cp\u003eCustomize the user experience by enabling or disabling screen requirements based on your Action's functionalities.\u003c/p\u003e\n"]]],[],null,["# Design guidelines\n\nDesign a conversation to guide users through your transactional\nflows. We've provided reference examples that you can use as a guide\nwhen designing your own transactional Actions.\n\nExamples\n--------\n\n[](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) [Shoe store Example](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) \n[](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) [Ticketing example](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) \n[](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA) [Flower Shop Example](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA)\n\nDesign tips\n-----------\n\n- Make sure the dialogs\n [sound natural and conversational](/assistant/conversational/df-asdk/design)\n --- the way a real person would talk.\n\n- The text spoken by your TTS/voice does not have to exactly match the text\n shown in your chat bubbles. It works well if the chat bubbles are a subset\n of the spoken dialog.\n\n- Greet your visitors and get them engaged. Ask what they need and offer a\n few suggestion chips to get them started.\n\n- Before inviting the user to add items to the cart, do a backend check by\n adding slot filling and using the `actions.type.TransactionRequirementsCheckResult`\n slot type to confirm the user has payments set up for their Google Assistant.\n\n- Be prepared to respond to the same issues with voice as with other mobile\n or web experiences. For example, offer a similar item when you're out of a\n certain size or color, or invite users to sign up to be notified when the\n item is back in stock.\n\n- Note that the order summary is built with the data you pass via the API.\n The \"Pay with Google\" label helps users understand that Google facilitated\n the payment.\n\n- When requesting info from your users, like their address info, first let\n them know why you are making the request and how it will benefit them.\n\n- Google will present the purchase authorization method (either no auth\n required, password, or fingerprint) based on the user's settings. Sometimes\n our risk assessment will kick off an additional auth step like confirming\n CVV for a card.\n\n- After the payment is complete, be sure to send a receipt and an order\n confirmation. It's important that users understand that you are the merchant\n of record, and will follow up with all details about the order, not Google.\n\n- By default transactions can be performed on either a surface with a\n screen (such as an Android phone) or a voice-only surface (such as a Google Home).\n\n - To best support voice-only transactions, take extra care to design\n a [good conversational experience](/assistant/conversational/df-asdk/design)\n that walks users through the full transaction experience.\n\n - Note that some transactions intents may require a screen. Most of these\n (e.g. adding a new delivery address, fixing payment issues, account linking)\n will be handed off to the phone automatically. If there are any additions\n to the conversation that are best displayed on a screen\n (e.g. presenting rich responses for card building, displaying a merchant\n ToS or privacy policy), you should check if the current surface supports\n the `RICH_RESPONSE` or `WEB_LINK`\n [capabilities](/assistant/conversational/reference/rest/v1/TopLevel/fulfill#capability),\n and transfer to a new surface if not.\n\n - If you would rather not support voice-only transactions with your\n Action, you can set your Actions project to require a screen by\n navigating to **Deploy \\\u003e Surface capabilities** in the\n [Actions console](https://console.actions.google.com) and setting\n **Do your Actions require a screen output** to **Yes**."]]