Transactions API tidak akan digunakan lagi mulai 3 Mei 2023, sebelum penghentian Percakapan Percakapan pada 13 Juni 2023. Untuk mengetahui informasi selengkapnya, lihat
Penghentian Action Percakapan.
Panduan desain
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Desain percakapan untuk memandu pengguna melalui alur transaksi
Anda. Kami telah menyediakan contoh referensi yang dapat digunakan sebagai panduan
saat mendesain Action transaksional Anda sendiri.
Contoh
Tips desain
Pastikan dialog
terdengar natural dan komunikatif
— layaknya orang sungguhan untuk berbicara.
Teks yang diucapkan oleh TTS/suara tidak harus sama persis dengan teks
yang ditampilkan dalam balon chat. Fitur ini berfungsi dengan baik jika balon chat merupakan subset
dari dialog lisan.
Sambut pengunjung dan buat mereka terlibat. Tanyakan apa yang mereka butuhkan dan tawarkan
beberapa {i>chip<i} saran untuk membantu mereka memulai.
Sebelum mengundang pengguna untuk menambahkan item ke keranjang, lakukan pemeriksaan backend dengan
menambahkan pengisian slot dan menggunakan jenis slot actions.type.TransactionRequirementsCheckResult
untuk memastikan pengguna telah menyiapkan pembayaran untuk Asisten Google-nya.
Bersiaplah untuk merespons masalah yang sama dengan suara seperti pada pengalaman seluler atau web lainnya. Misalnya, tawarkan item serupa saat Anda kehabisan
ukuran atau warna tertentu, atau undang pengguna untuk mendaftar agar diberi tahu saat
item kembali tersedia.
Perhatikan bahwa ringkasan pesanan dibuat dengan data yang Anda teruskan melalui API.
Label "Bayar dengan Google" membantu pengguna memahami bahwa Google memfasilitasi
pembayaran.
Saat meminta info dari pengguna, seperti info alamat mereka, pertama-tama beri tahu mereka alasan Anda membuat permintaan tersebut dan manfaatnya bagi mereka.
Google akan menampilkan metode otorisasi pembelian (tidak diperlukan autentikasi, sandi, atau sidik jari) berdasarkan setelan pengguna. Terkadang, penilaian risiko kami akan memulai langkah autentikasi tambahan, seperti mengonfirmasi CVV untuk kartu.
Setelah pembayaran selesai, pastikan untuk mengirimkan tanda terima dan konfirmasi
pesanan. Penting bagi pengguna untuk memahami bahwa Anda adalah entitas pemroses kartu, dan akan menindaklanjuti dengan semua detail pesanan, bukan Google.
Secara default, transaksi dapat dilakukan di platform dengan
layar (seperti ponsel Android) atau platform khusus suara (seperti Google Home).
Untuk mendukung transaksi hanya suara dengan baik, berhati-hatilah dalam mendesain
pengalaman percakapan yang baik
yang memandu pengguna melalui pengalaman transaksi sepenuhnya.
Perhatikan, beberapa intent transaksi mungkin memerlukan layar. Sebagian besar masalah tersebut (misalnya, menambahkan alamat pengiriman baru, memperbaiki masalah pembayaran, menautkan akun) akan otomatis diteruskan ke ponsel. Jika ada tambahan
pada percakapan yang paling baik ditampilkan di layar
(misalnya menampilkan respons lengkap untuk pembuatan kartu, menampilkan ToS
penjual atau kebijakan privasi), Anda harus memeriksa apakah platform saat ini mendukung
capabilities
RICH_RESPONSE atau WEB_LINK,
dan mentransfer ke platform baru jika tidak.
Jika Anda memilih untuk tidak mendukung transaksi hanya suara dengan
Action, Anda dapat menyetel agar project Actions Anda memerlukan layar dengan
membuka Deploy > SurfaceCapabilities di
Konsol Actions dan menyetel
Do your Actions requires a screen output ke Yes.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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**."]]
