Son kullanıcı oryantasyon akışları

Bu kılavuzda, uygulamanızdaki ilk katılım deneyimi için sorunsuz Google Home API'leri, cihaz izinleri ve paylaşımı tasarlamayla ilgili kullanıcı deneyimi yönergeleri sağlanmaktadır.

Burada açıklanan başlıca konular şunlardır:

• Cihazları Google Home ile neden paylaşmalısınız?
• Paylaşım akışının önemli aşamaları
• Teknik uygulama
• Kullanıcı deneyimiyle ilgili en iyi uygulamalar

Cihazları Google Home ile neden paylaşmalısınız?

Home API'lerinin sunduğu özelliklerden yararlanmak için kullanıcıların cihazlarını Google Home ile paylaşması gerekir. Bunun nedeni:

• Google'ın bu cihazları otomasyonlarda kullanabilmesi için teknik bir şarttır.
• Bu, tutarlı ve esnek bir Google Home deneyimi sunmanıza yardımcı olur.
  • Cihazların Home API özellikli uygulamalarda tutarlı bir şekilde sunulmasını sağlamak, kullanıcıların temel görevleri tamamlamak için uygulamalar arasında geçiş yapması gereken dağınık ve kafa karıştırıcı bir kullanıcı deneyimi oluşturmamak açısından çok önemlidir.

Paylaşım akışının temel bileşenleri

Bileşen	Program	Açıklama
Permissions API	İzinler için Home API'leri	Kullanıcılardan uygulamanıza izin vermesini ister. Ev API'lerinden herhangi birini kullanmadan önce uygulamanızın, kullanıcının evindeki cihazlara (API'de yapı olarak adlandırılır) erişme izni olmalıdır. Ancak bu adımın uygulanma sırası geliştirici senaryosuna bağlıdır ve teknik uygulamaya dahildir.
Buluttan buluta bağlantı	Hesap bağlama için buluttan buluta	Buluta bağlı cihazları Google Home ile paylaşmak için uygulamanızdan hesap bağlama sürecini başlatmanıza olanak tanır. Kullanıcı deneyimini iyileştirmek amacıyla, kullanıcıları doğrudan GHA'daki hesap bağlama sayfanıza yönlendiren derin bağlantı özelliğini (hem Android hem de iOS'te kullanılabilir) kullanmanızı öneririz.
Commissioning API	Matter Commissioning	Genellikle yeni Matter cihazları devreye almak için bir API olarak düşünülse de bu API'yi, Google kumaşını başka bir kumaşa devredilmiş Matter cihazlara eklemek için de kullanabilirsiniz. Bu nedenle, oryantasyon süreci için yararlı bir araçtır.

Teknik uygulama

Paylaşım akışlarını nasıl oluşturacağınız, Google ile hangi cihazları paylaşmayı planladığınıza bağlıdır.

Aşağıdaki senaryolarda, adımları belirtilen sırayla uygulamanızı öneririz. Bu, kullanıcılara daha iyi bir genel deneyim sunmanıza yardımcı olur.

Yalnızca Matter cihazları üretiyorsanız

Google Home'da kullanmak istediğiniz Matter özellikli cihazlar üretiyorsunuz.

1. Permissions API'yi çağırın.

2. Daha önce başka bir kumaşa atanmış her Matter cihazda Google Commissioning API'yi çağırın.

   1. Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran bulunduğundan, kullanıcıya bu süreçte rehberlik etmenizi öneririz:
      • Kullanıcılara Google ile paylaşılmayan Matter cihazlarının listesini sağlama
      • Kullanıcıların bu listedeki cihazları tıklayarak cihaz paylaşım sürecini (Commissioning API'yi kullanarak) başlatmasına izin verme.
      • Matter cihazlarının listesine dönerek kullanıcıya görev ilerleme durumunu ve paylaşım durumunu gösterir.

Yalnızca buluttan buluta API'leri kullanarak Google ile paylaşılan cihazlar üretiyorsunuz

1. Cloud-to-cloud derin bağlantısı oluşturun. Bu işlem, cihazları Google Home Graph'a ekler.

   1. Kullanıcıya Google ile paylaşılan ve Google ile paylaşılmayan cihazları içeren bir liste gösterilmesi gibi kafa karıştırıcı durumları önlemek için önce Cloud-to-cloud bağlama işlemini yapmanızı öneririz.

2. Permissions API'yi çağırın.

Hem buluttan buluta hem de Matter cihazlar üretiyorsunuz

1. Cloud-to-cloud derin bağlantısı oluşturun.

   1. Kullanıcıya Google ile paylaşılan ve Google ile paylaşılmayan cihazları içeren bir liste gösterilmesi gibi kafa karıştırıcı durumları önlemek için önce Cloud-to-cloud bağlama işlemini yapmanızı öneririz.

2. Permissions API'yi çağırın.

3. Daha önce başka bir kumaşa atanmış her Matter cihazda Google Commissioning API'yi çağırın.

   1. Matter paylaşımı her cihaz için ayrı ayrı yapılması gerektiğinden ve kullanıcı girişi gerektiren birçok ekran bulunduğundan, kullanıcıya bu süreçte rehberlik etmenizi öneririz:
      • Kullanıcılara Google ile paylaşılmayan Matter cihazlarının listesini sağlama
      • Kullanıcıların bu listedeki cihazları tıklayarak cihaz paylaşım sürecini (Commissioning API'yi kullanarak) başlatmasına izin verme.
      • Matter cihazlarının listesine dönerek kullanıcıya görev ilerleme durumunu ve paylaşım durumunu gösterir.

Google ile paylaşabileceğiniz cihazınız yok

Permissions API'yi çağırın.

Kullanıcı deneyimi en iyi uygulamaları

Bu bölümde, Home API'lerinden yararlanan bir uygulama geliştirirken dikkate alınması gereken bazı önemli kullanıcı yolculukları yer almaktadır.

Uygulamada cihaz paylaşımını nerede tanıtmalısınız?

Bu liste tam kapsamlı değildir. Kullanıcılarınıza zamanında Google Home tanıtımı ve paylaşım deneyimi sunmak için başka fırsatlar da bulabilirsiniz.

Bunlar birbirini dışlamaz ve birden fazla giriş noktası vardır:

Ayarlar menüsünden

Kullanıcılar muhtemelen Google Home ekosistemleriyle bağlantıları bir ayarlar menüsü aracılığıyla kurmaya alışkın olduklarından bu yöntem, bu paradigmaya devam etmelerine olanak tanır.

Cihaz paylaşımını (Cloud-to-cloud bağlantısı ve Matter Commissioning API) uygulama izinlerinden (Permissions API) ayırmak isteyebilirsiniz. Bu sayede kullanıcılar hangi adımları tamamlayacaklarını kontrol edebilir ve siz de bağlantı durumunu kullanıcıya gösterebilirsiniz.

Google tarafından çalıştırılan otomasyonlarda cihazlar kullanıldığında

Kullanıcılar, Otomasyonlar sekmesinden paylaşım akışına bir giriş noktasına dokunabilir, devam etmenin avantajlarını açıkça açıklayan bir değer teklifi ekranını okuyabilir ve ardından izin akışında hızlıca ilerleyebilir.

Yalnızca devreye alma işleminden

Bu senaryo, yalnızca Matter cihazlar (Cloud-to-cloud cihaz yok) üreten ve kendi Matter kumaşları olmayan iş ortakları için uygundur. Kullanıcının giriş noktası, Matter cihazlarının paylaşımının (Commissioning API aracılığıyla) ve uygulama izinlerinin (Permissions API aracılığıyla) aynı kullanıcı deneyimi akışının parçası olduğu kutudan çıkarma türü bir ekrandan hemen sonra gelebilir.

Paylaşım mantığı

Kullanıcı istemleriyle ilgili bazı öneriler:

• Genellikle kullanıcılardan yalnızca platforma ilk katılım için gereken eksik adımları tamamlamalarını istemeniz gerekir. Örneğin, uzun süredir müşteri olan kullanıcılar bir OEM'nin cihazlarını Google ile paylaşıyor olabilir. Bu durumda, uygulamanın Google Home'larına erişmesi için yalnızca Home API'leri izin verme sürecini tamamlamaları gerekir.

• Birden fazla Google Home yöneticisi bir Google Home yapısını paylaşıyor olabilir ve bazı durumlarda cihazları Google ile paylaşmak için yalnızca bir hesap kullanılıyor olabilir. Bu nedenle, Cloud-to-cloud bağlama işleminin tamamlanması, Home API'leri izinlerinin istenmesi için ön koşul olmamalıdır.

Görsel tasarım önerileri

• Google Home'a ilk katılımın net bir avantajı (ör. "Google Home tarafından desteklenen gelişmiş otomasyonlar oluşturun" veya "Seçtiğiniz uygulamaları kullanarak cihazları kontrol edin").

• Bir harekete geçirici mesaj (ör. "Başlayın") ve kullanıcı devam etmek istemiyorsa iptal etmenin bir yolu.

• Alan varsa kullanıcı ekranlar arasında ilerlerken ne olacağını açıklayan bir açıklama.

• Özellikle Matter için, kullanıcı daha önce Home API'leri aracılığıyla evine erişim izni verdiğinde, yeni cihazları kullanıma sunarken kullanıcının evinde bulunan cihazları Google Home ile paylaşmasını sağlayabilirsiniz. Örneğin, Matterörgütünüze bir cihaz ekleyebilir ve ardından kullanıcıdan bu cihazı Google'a eklemesini isteyebilirsiniz.

İçerik önerileri

Kullanıcıların anladıkları ve değer katan bir şeye güvenmeleri daha kolaydır. Karşılaştırmalar da dahil olmak üzere bilinçli kararlar almaları için kullanıcılara bilgi sağlayarak onlara destek olun.

Kritik sunum

Kullanıcılar, cihaz paylaşımı için güçlü bir değer teklifi yoksa bu yolu izlemeye devam etmez.

• Teklifi nasıl konumlandırdığınıza özellikle dikkat edin.
• Açıklamanızı ilgi çekici hale getirin ancak aşırı vaatlerde bulunmayın.
• Kullanıcının, sunumunuzda bahsettiğiniz bir cihaza ihtiyacı varsa beklenmedik bir engele takılmaması için bu cihazın açıkça belirtildiğinden emin olun.
• Bu kullanıcıları yakalamak için yalnızca bir fırsatınız olabilir. Bu fırsatı değerlendirin.

En iyi uygulamalar

1. Kullanıcının bakış açısıyla, "Bana ne faydası var?" yaklaşımını benimseyin.
2. Bir bölüm bloğuna dört satırdan fazla içerik yazmayın. Çok fazla kelime kullanıcının dikkatini dağıtabilir. Ancak metnin net ve anlaşılır olması kısa olmasından daha önemli olabilir.
3. Otomasyonlar eğlencelidir. Alan izin veriyorsa heyecan verici ancak faydalı bir örnek seçin.
4. Genel stratejinizle uyumluysa eğlenceli bir ses ve ton kullanmayı deneyin.
5. "Başlayın" gibi işlem yapılabilir ifadeler kullanın.