2023년 6월 13일에 대화형 작업이 종료되기 전에 2023년 5월 3일에 Transactions API가 지원 중단됩니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
디자인 가이드라인
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자에게 거래 흐름을 안내하는 대화를 설계하세요. 자체 트랜잭션 작업을 설계할 때 가이드로 사용할 수 있는 참조 예시를 제공했습니다.
예
디자인 팁
실제 사람이 말하는 방식처럼 자연스러우면서도 대화적인 대화를 가져야 합니다.
TTS/음성으로 말하는 텍스트는 채팅 풍선에 표시된 텍스트와 정확히 일치하지 않아도 됩니다. 채팅 풍선이 음성 대화상자의 하위 집합인 경우 잘 작동합니다.
방문자에게 인사하고 참여를 유도하세요. 무엇이 필요한지 물어보고
몇 가지 추천 칩을 제공하여 시작하는 데 도움을 줍니다
장바구니에 항목을 추가하도록 사용자를 초대하기 전에 슬롯 채우기를 추가하고 actions.type.TransactionRequirementsCheckResult
슬롯 유형을 사용하여 사용자가 Google 어시스턴트에 결제를 설정했는지 확인하는 백엔드 검사를 실행합니다.
다른 모바일 또는 웹 환경과 동일한 문제에 대응할 준비를 해야 합니다. 예를 들어 특정 크기나 색상이 떨어졌을 때 비슷한 상품을 제공하거나 사용자가 상품 재입고 시 알림을 받도록 가입하도록 유도할 수 있습니다.
주문 요약은 API를 통해 전달된 데이터를 사용하여 작성됩니다.
'Google을 통해 결제' 라벨은 Google에서 결제를 처리했음을 사용자가 이해하는 데 도움이 됩니다.
사용자에게 주소 정보와 같은 정보를 요청할 때는 먼저 요청하는 이유와 이를 통해 얻을 수 있는 이점을 설명하세요.
Google은 사용자의 설정에 따라 구매 승인 방법 (인증 필요 없음, 비밀번호 또는 디지털 지문)을 표시합니다. 위험 평가에서 카드의 CVV 확인과 같은 추가 인증 단계가 시작되는 경우가 있습니다.
결제가 완료되면 영수증과 주문 확인을 전송해야 합니다. 판매자가 등록된 판매자임을 사용자가 알고 있어야 하며
Google이 아닌 주문에 대한 모든 세부정보를 제공해야 합니다.
기본적으로 트랜잭션은 화면이 있는 노출 영역 (예: Android 휴대전화) 또는 음성 전용 노출 영역 (예: Google Home)에서 실행할 수 있습니다.
음성 전용 트랜잭션을 가장 효과적으로 지원하려면 사용자에게 전체 트랜잭션 환경을 안내하는 우수한 대화형 환경을 설계해야 합니다.
일부 트랜잭션 인텐트에는 화면이 필요할 수 있습니다. 새 배송지 주소 추가, 결제 문제 해결, 계정 연결과 같은 대부분의 작업은 자동으로 휴대전화로 핸드오프됩니다. 대화에 가장 잘 표시되는 내용이 있는 경우(예: 카드 작성에 관한 리치 응답 표시, 판매자 서비스 약관 또는 개인정보처리방침 표시) 현재 표시 경로에서 RICH_RESPONSE
또는 WEB_LINK
capabilities을 지원하는지 확인하고 지원되지 않는 경우 새 노출 영역으로 전송해야 합니다.
작업에서 음성 전용 트랜잭션을 지원하지 않으려면 작업 콘솔에서 배포 > 노출 영역 기능으로 이동하고 작업에 화면 출력이 필요합니까?를 예로 설정하여 작업 프로젝트가 화면을 요구하도록 설정할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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**."]]