Transactions API در 3 مه 2023 منسوخ خواهد شد، قبل از غروب کنشهای مکالمه در 13 ژوئن 2023. برای اطلاعات بیشتر،
غروب کنشهای مکالمه را ببینید.
دستورالعمل های طراحی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مکالمه ای طراحی کنید تا کاربران را در جریان تراکنش های خود راهنمایی کند. ما نمونههای مرجعی را ارائه کردهایم که میتوانید هنگام طراحی اکشنهای تراکنشی خود از آنها به عنوان راهنما استفاده کنید.
مثال ها
نکات طراحی
مطمئن شوید که دیالوگها طبیعی و محاورهای به نظر میرسند - همان طور که یک شخص واقعی صحبت میکند.
متنی که توسط TTS/صدای شما گفته می شود لازم نیست دقیقاً با متن نشان داده شده در حباب های چت شما مطابقت داشته باشد. اگر حباب های چت زیرمجموعه ای از گفتگوی گفتاری باشند، به خوبی کار می کند.
به بازدیدکنندگان خود سلام کنید و آنها را درگیر کنید. از آنها بپرسید که چه چیزی نیاز دارند و چند تراشه پیشنهادی برای شروع آنها ارائه دهید.
قبل از دعوت از کاربر برای افزودن موارد به سبد خرید، با افزودن پر کردن اسلات و استفاده از نوع اسلات actions.type.TransactionRequirementsCheckResult
یک بررسی پشتیبان انجام دهید تا تأیید کنید کاربر پرداختهایی را برای دستیار Google خود تنظیم کرده است.
آماده باشید که به همان مسائل با صدا پاسخ دهید مانند سایر تجربیات تلفن همراه یا وب. به عنوان مثال، زمانی که اندازه یا رنگ مشخصی ندارید، کالای مشابهی را پیشنهاد دهید، یا از کاربران دعوت کنید که ثبت نام کنند تا زمانی که کالا در انبار موجود است مطلع شوند.
توجه داشته باشید که خلاصه سفارش با داده هایی که از طریق API ارسال می کنید ساخته می شود. برچسب "پرداخت با Google" به کاربران کمک می کند بفهمند که Google پرداخت را تسهیل کرده است.
هنگام درخواست اطلاعات از کاربران خود، مانند اطلاعات آدرس آنها، ابتدا به آنها اطلاع دهید که چرا این درخواست را انجام می دهید و چه سودی برای آنها خواهد داشت.
Google روش مجوز خرید (یا بدون نیاز به احراز هویت، رمز عبور یا اثر انگشت) را بر اساس تنظیمات کاربر ارائه میکند. گاهی اوقات ارزیابی ریسک ما یک مرحله تأیید اعتبار اضافی مانند تأیید CVV برای یک کارت را آغاز می کند.
پس از اتمام پرداخت، حتما رسید و تایید سفارش را ارسال کنید. این مهم است که کاربران بدانند که شما تاجر سابقه دار هستید و همه جزئیات سفارش را پیگیری می کنند، نه Google.
بهطور پیشفرض، تراکنشها میتوانند بر روی یک سطح دارای صفحه نمایش (مانند تلفن Android) یا یک سطح فقط صوتی (مانند Google Home) انجام شوند.
برای پشتیبانی بهتر از تراکنشهای فقط صوتی، برای طراحی یک تجربه مکالمه خوب که کاربران را در تجربه کامل تراکنش راهنمایی میکند، دقت بیشتری داشته باشید.
توجه داشته باشید که برخی از اهداف تراکنش ممکن است نیاز به صفحه نمایش داشته باشند. بسیاری از این موارد (به عنوان مثال افزودن آدرس تحویل جدید، رفع مشکلات پرداخت، پیوند دادن حساب) به طور خودکار به تلفن تحویل داده می شود. اگر موارد افزودهای به مکالمه وجود دارد که به بهترین شکل روی صفحه نمایش داده میشود (مثلاً ارائه پاسخهای غنی برای ساخت کارت، نمایش ToS تاجر یا خطمشی رازداری)، باید بررسی کنید که آیا سطح فعلی از قابلیتهای RICH_RESPONSE
یا WEB_LINK
پشتیبانی میکند یا خیر، و به آن منتقل کنید. سطح جدید اگر نه
اگر ترجیح میدهید از تراکنشهای فقط صوتی با Action خود پشتیبانی نکنید، میتوانید پروژه Actions خود را به گونهای تنظیم کنید که با رفتن به Deploy > Surface capabilities در کنسول Actions و تنظیم Do your Actions need a screen output را روی Yes تنظیم کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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**."]]