جریان ورود کاربر نهایی

این راهنما راهنمای UX را برای طراحی یکپارچه مجوزهای دستگاه APIهای Google Home و به اشتراک گذاری برای تجربه ورود در برنامه شما ارائه می دهد.

موضوعات اصلی شرح داده شده در اینجا عبارتند از:

• چرا دستگاه ها را با Google Home به اشتراک بگذارید؟
• مراحل کلیدی جریان اشتراک گذاری
• پیاده سازی فنی
• بهترین شیوه های UX

چرا دستگاه ها را با Google Home به اشتراک بگذارید؟

برای لذت بردن از قابلیت‌هایی که Home API ارائه می‌دهند، کاربران باید دستگاه‌های خود را با Google Home به اشتراک بگذارند زیرا:

• این یک الزام فنی برای Google است که از این دستگاه ها در اتوماسیون استفاده کند.
• به حفظ یک تجربه سازگار و انعطاف پذیر Google Home کمک می کند.
  • اطمینان از اینکه دستگاه‌ها به‌طور مداوم در برنامه‌های دارای API فعال Home ارائه می‌شوند، برای جلوگیری از ایجاد یک تجربه کاربری تکه‌تکه و گیج‌کننده که در آن کاربران باید بین برنامه‌ها برای انجام کارهای اساسی پرش کنند، بسیار مهم است.

اجزای کلیدی جریان اشتراک گذاری

پیاده سازی فنی

نحوه ایجاد جریان های اشتراک گذاری بستگی به این دارد که کدام دستگاه ها را می خواهید با Google به اشتراک بگذارید.

برای سناریوهای زیر، توصیه می کنیم مراحل را به ترتیب ارائه شده دنبال کنید. این به کاربران کمک می کند تا تجربه کلی بهتری را برای کاربران فراهم کنند.

شما فقط دستگاه های Matter را تولید می کنید

شما دستگاه‌های دارای Matter را تولید می‌کنید که می‌خواهید به Google Home سفارش دهید.

1. با Permissions API تماس بگیرید.

2. برای هر دستگاه Matter که قبلاً به یک پارچه دیگر راه اندازی شده است، با Google Commissioning API تماس بگیرید.

   1. از آنجا که اشتراک‌گذاری Matter باید برای هر دستگاه به‌صورت جداگانه انجام شود، و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارند، توصیه می‌کنیم کاربر را از طریق این فرآیند راهنمایی کنید:
      • ارائه فهرستی از دستگاه‌های Matter که با Google به اشتراک گذاشته نمی‌شوند به کاربران ارائه شود.
      • به کاربران اجازه می‌دهد تا با کلیک کردن روی دستگاه‌های موجود در آن فهرست، فرآیند اشتراک‌گذاری دستگاه (با استفاده از Commissioning API) را شروع کنند.
      • بازگشت به لیست دستگاه های Matter، نمایش پیشرفت کار و وضعیت اشتراک گذاری به کاربر.

شما فقط با استفاده از APIهای Cloud-to-Cloud دستگاه هایی را تولید می کنید که با Google به اشتراک گذاشته شده اند

1. پیوند عمیق Cloud-to-cloud را انجام دهید. این دستگاه ها را به نمودار صفحه اصلی Google اضافه می کند.

   1. توصیه می‌کنیم ابتدا پیوند Cloud-to-cloud را انجام دهید تا از موقعیت‌های بالقوه گیج‌کننده مانند نمایش فهرستی که شامل دستگاه‌هایی است که با Google به اشتراک گذاشته می‌شوند و دستگاه‌هایی که با Google به اشتراک گذاشته نمی‌شوند، به کاربر ارائه می‌شود.

2. با Permissions API تماس بگیرید.

شما هر دو دستگاه Cloud-to-cloud و Matter را تولید می کنید

1. پیوند عمیق Cloud-to-cloud را انجام دهید.

   1. توصیه می‌کنیم ابتدا پیوند Cloud-to-cloud را انجام دهید تا از موقعیت‌های بالقوه گیج‌کننده مانند نمایش فهرستی که شامل دستگاه‌هایی است که با Google به اشتراک گذاشته می‌شوند و دستگاه‌هایی که با Google به اشتراک گذاشته نمی‌شوند، به کاربر ارائه می‌شود.

2. با Permissions API تماس بگیرید.

3. برای هر دستگاه Matter که قبلاً به یک پارچه دیگر راه اندازی شده است، با Google Commissioning API تماس بگیرید.

   1. از آنجا که اشتراک‌گذاری Matter باید برای هر دستگاه به‌صورت جداگانه انجام شود، و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارند، توصیه می‌کنیم کاربر را از طریق این فرآیند راهنمایی کنید:
      • ارائه فهرستی از دستگاه‌های Matter که با Google به اشتراک گذاشته نمی‌شوند به کاربران ارائه شود.
      • به کاربران اجازه می‌دهد تا با کلیک کردن روی دستگاه‌های موجود در آن فهرست، فرآیند اشتراک‌گذاری دستگاه (با استفاده از Commissioning API) را شروع کنند.
      • بازگشت به لیست دستگاه های Matter، نمایش پیشرفت کار و وضعیت اشتراک گذاری به کاربر.

شما هیچ دستگاهی برای اشتراک گذاری با Google ندارید

با Permissions API تماس بگیرید.

بهترین شیوه های UX

این بخش شامل برخی از سفرهای حیاتی کاربر است که باید هنگام توسعه برنامه‌ای که از APIهای Home استفاده می‌کند در نظر بگیرید.

کجا به اشتراک گذاری دستگاه را در برنامه معرفی کنیم

این فهرست جامعی نیست و ممکن است فرصت‌های دیگری برای ارائه به موقع Google Home و تجربه اشتراک‌گذاری برای کاربران خود بیابید.

اینها همچنین متقابلاً منحصر به فرد نیستند و چندین نقطه ورودی وجود دارد:

از منوی تنظیمات

از آنجایی که کاربران احتمالاً عادت دارند با استفاده از منوی تنظیمات، با اکوسیستم های Google Home خود ارتباط برقرار کنند، این روش به آنها اجازه می دهد تا با این پارادایم ادامه دهند.

ممکن است بخواهید اشتراک گذاری دستگاه (پیوند Cloud-to-cloud و Matter Commissioning API) را از مجوز برنامه (API مجوزها) جدا کنید. این به کاربران امکان کنترل مراحلی را می دهد که انجام می دهند و فرصتی را برای شما فراهم می کند تا وضعیت اتصال را به کاربر نمایش دهید.

هنگام استفاده از دستگاه‌ها در اتوماسیون‌های اجرا شده توسط Google

از تب Automations، کاربران می‌توانند روی یک نقطه ورودی به جریان اشتراک‌گذاری ضربه بزنند، صفحه ارزش پیشنهادی را بخوانند که به وضوح مزایای حرکت رو به جلو را توضیح می‌دهد، و سپس به سرعت در جریان مجوزها حرکت کنند.

فقط از راه اندازی

این سناریو در درجه اول برای شرکای است که فقط دستگاه‌های Matter را تولید می‌کنند (بدون دستگاه‌های Cloud-to-cloud ) و پارچه Matter خود را ندارند. نقطه ورود کاربر می‌تواند درست پس از یک صفحه نمایش خارج از جعبه باشد که در آن اشتراک‌گذاری دستگاه‌های Matter (از طریق Commissioning API) و مجوز برنامه (از طریق Permissions API) بخشی از جریان تجربه کاربر یکسان است.

به اشتراک گذاری منطق

برخی از پیشنهادات در مورد درخواست های کاربر عبارتند از:

• به طور کلی باید از کاربران بخواهید که فقط مراحل گمشده مورد نیاز برای نصب روی پلت فرم را تکمیل کنند. برای مثال، مشتریان قدیمی ممکن است قبلاً دستگاه‌های یک OEM را با Google به اشتراک بگذارند، در این صورت آنها فقط باید از طریق فرآیند اعطای مجوزهای Home APIs به برنامه دسترسی پیدا کنند تا به Google Home خود دسترسی داشته باشند.

• ممکن است چندین سرپرست Google Home یک ساختار Google Home را به اشتراک بگذارند، و در برخی موارد ممکن است فقط یک حساب برای اشتراک‌گذاری دستگاه‌ها با Google استفاده شود. در نتیجه، تکمیل پیوند Cloud-to-cloud نباید پیش نیازی برای درخواست مجوزهای Home API باشد.

پیشنهادات طراحی بصری

• یک مزیت واضح از ورود به Google Home (به عنوان مثال، «ایجاد اتوماسیون‌های پیشرفته با پشتیبانی از Google Home» یا «کنترل دستگاه‌ها با استفاده از برنامه‌های انتخابی شما»).

• یک فراخوان برای اقدام (به عنوان مثال، "شروع به کار") و راهی برای لغو اگر کاربر نمی خواهد ادامه دهد.

• اگر فضا اجازه دهد، توضیحی در مورد آنچه که کاربر از طریق صفحه نمایش پیشرفت می کند، رخ خواهد داد.

• به طور خاص برای Matter ، زمانی که کاربر قبلاً از طریق APIهای Home به شما اجازه دسترسی به خانه خود را داده است، می‌توانید هنگام راه‌اندازی دستگاه‌های جدید، اشتراک‌گذاری دستگاه‌های موجود در خانه خود را با Google Home ممکن کنید. به عنوان مثال، می توانید یک دستگاه Matter را به پارچه خود اضافه کنید و سپس از کاربر بخواهید که این دستگاه را به پارچه Google اضافه کند.

پیشنهادات محتوا

برای کاربران راحت‌تر است که به چیزی که می‌فهمند اعتماد کنند و به آن ارزش اضافه می‌کند. با ارائه اطلاعات برای تصمیم گیری آگاهانه، از جمله معاوضه، کاربران را توانمند کنید.

زمین بحرانی

اگر پیشنهاد ارزش قوی برای انجام این کار وجود نداشته باشد، کاربران مسیر اشتراک‌گذاری دستگاه‌ها را ادامه نمی‌دهند.

• به نحوه قرار دادن پیشنهاد توجه ویژه ای داشته باشید.
• آن را فریبنده کنید اما بیش از حد قول ندهید.
• اگر کاربر به وسیله‌ای نیاز دارد که در طرح شما ذکر شده است، مطمئن شوید که به وضوح بیان شده است تا به مانع غیرمنتظره‌ای برخورد نکند.
• ممکن است فقط یک فرصت برای جذب این کاربران داشته باشید، بنابراین آن را به حساب بیاورید.

بهترین شیوه ها

1. با دیدگاه کاربر شروع کنید - "چه چیزی در آن برای من است؟" رویکرد
2. بیش از چهار خط محتوا در بلوک بخش ننویسید. کلمات بیشتر ممکن است توجه کاربر را از دست بدهند. با این حال، وضوح و درک مطلب می تواند مهمتر از مختصر بودن باشد.
3. اتوماسیون ها سرگرم کننده هستند! اگر فضا اجازه می دهد، یک مثال هیجان انگیز اما مفید انتخاب کنید.
4. اگر با استراتژی کلی شما مطابقت دارد، صدا و لحن بازیگوش را امتحان کنید.
5. از عبارات کاربردی مانند «شروع کن» استفاده کنید.