Migrasi ke Pusat Developer Google Home telah selesai.

Dasbor Pemantauan Kualitas

Rangkaian dasbor dan pemberitahuan ini membantu Anda secara proaktif mempertahankan integrasi berkualitas tinggi dengan ekosistem Google Home. Google berkomitmen untuk mendukung partner dalam mengembangkan ekosistem berkualitas tinggi bagi semua pelanggan

Dasbor ini memiliki tiga bagian, yang masing-masing mencakup bagian penting yang berkontribusi pada kualitas integrasi secara keseluruhan.

Metrik Partner ke Google - Mengukur kualitas panggilan dari Google ke backend cloud Anda.
Kesehatan Sistem - Metrik Partner ke Google - Mengukur kesehatan panggilan dari sistem Anda ke Google.
Kesehatan Perangkat - Akurasi Status - Mengukur akurasi status yang disimpan dalam sistem Google, yang digunakan untuk menayangkan kueri pengguna.

Jika metrik tidak memenuhi nilai targetnya, metrik tersebut akan ditandai dengan warna merah untuk menunjukkan masalah yang dapat memengaruhi pengalaman pengguna. Informasi berikut memberikan detail tentang setiap target dan alasan pentingnya bagi pengguna Anda.

Buka Dasbor

Metrik Google untuk Partner

Metrik Tingkat Keberhasilan Kueri/Eksekusi >= 99,5% mengukur seberapa sering perintah pengguna dipenuhi dengan benar, yang membantu menghindari respons Asisten seperti "Saya tidak dapat menjangkau perangkat" atau salah mengonfirmasi perintah yang tidak dipenuhi.

Apa yang menentukan "Keberhasilan"?

Transaksi ditandai sebagai berhasil jika platform Google Home menerima respons yang valid yang menunjukkan bahwa tindakan yang dimaksud telah dilakukan atau status yang diminta telah diambil.

Respons yang menyertakan pengecualian non-pemblokiran (misalnya, status SUCCESS yang disertai dengan pengecualian lowBattery) dihitung sebagai transaksi yang berhasil. Perintah mencapai perangkat dan maksudnya terpenuhi meskipun ada peringatan.

Apa yang mendefinisikan "Kegagalan"?

Error yang ditemukan di Kode error platform umum yang ditandai sebagai Dapat Ditindaklanjuti Partner dianggap sebagai "Kegagalan" saat menghitung Tingkat Keberhasilan KUERI dan EKSEKUSI.

Metrik Latensi Kueri/Eksekusi (p90) <= 1000 md mengukur waktu tunggu tindakan yang diminta dan membantu memastikan pengguna tidak perlu menunggu terlalu lama, misalnya, menunggu beberapa detik hingga lampu mereka mati.

Metrik latensi

Latensi adalah indikator penting tentang seberapa responsif integrasi Anda terhadap pengguna akhir. Dasbor melacak Latensi Persentil ke-90 (P90), yang mewakili pengalaman pengguna "paling lambat" (misalnya, P90 800 md berarti 90% permintaan diakui dalam 800 md atau kurang).

Google mengukur latensi secara berbeda untuk pemeriksaan status dan perintah perangkat guna memastikan akurasi teknis.

1. Latensi QUERY (Interogatif)

Ini mengukur waktu perjalanan pulang pergi Cloud-to-cloud saat Google meminta status perangkat saat ini.

Mulai: Google mengirimkan permintaan action.devices.QUERY ke URL pemenuhan Anda.
Jendela Pengukuran: Waktu yang diperlukan agar cloud Anda menerima, memproses, dan mengirimkan kembali respons HTTP lengkap ke Google.
Akhir: Google menerima dan mengonfirmasi payload respons akhir dari layanan Anda.

2. Latensi EKSEKUSI (Tindakan)

Metrik ini mengukur waktu konfirmasi perintah saat Google mengirim permintaan kontrol ke perangkat.

Mulai: Google mengirimkan permintaan action.devices.EXECUTE ke URL pemenuhan Anda.
Jendela Pengukuran: Waktu yang diperlukan agar cloud Anda menerima perintah dan mengembalikan respons konfirmasi.
Akhir: Google menerima respons status SUCCESS, PENDING, atau OFFLINE.
Cakupan Teknis: Metrik ini mengukur waktu "Penerimaan Respons" antara cloud Google dan cloud Anda. Metrik ini tidak mengukur waktu yang diperlukan hardware fisik (misalnya, bohlam) untuk menyelesaikan perubahan status fisik, karena sering kali melibatkan latensi jaringan mesh lokal di luar jalur cloud-ke-cloud.

Kesehatan Sistem - Metrik Partner ke Google

Mempertahankan Tingkat Keberhasilan >= 99,5% membantu memastikan bahwa status perangkat benar di Google Home, perangkat ditambahkan dan dihapus, otomatisasi dipicu, dan peristiwa histori muncul di tab Aktivitas Google Home app (GHA).

Tingkat Keberhasilan dihitung berdasarkan kode respons HTTP yang ditampilkan oleh Google saat cloud Anda mengirimkan update status. Untuk memastikan partner tidak dihukum karena masalah infrastruktur di sisi Google, metrik ini mengecualikan error internal Google dari jumlah kegagalan.

Apa yang menentukan "Keberhasilan"?

2xx (Berhasil): Pembaruan status berhasil diterima dan diproses oleh Home Graph.

Apa yang mendefinisikan "Kegagalan"?

4xx (Error Partner): Error ini menunjukkan Kegagalan dan menunjukkan masalah pada permintaan yang dikirim dari cloud Anda. Kode umum meliputi:
- 400 Permintaan Buruk: Server tidak dapat memproses permintaan karena sintaksis tidak valid. Penyebab umum mencakup JSON yang salah format atau menggunakan null, bukan "" untuk nilai string.
- 404 Tidak Ditemukan: Resource yang diminta tidak dapat ditemukan. Biasanya, hal ini berarti Google tidak dapat menemukan perangkat yang diminta. Hal ini juga dapat berarti akun pengguna tidak ditautkan atau agentUserId yang diterima tidak valid. Pastikan agentUserId cocok dengan nilai yang diberikan dalam respons SYNC Anda dan Anda menangani intent DISCONNECT dengan benar.
- 429 Resource Exhausted: Integrasi Anda telah melampaui kuota yang dialokasikan. Lihat petunjuk di bagian "Langkah 1" di bagian atas dasbor untuk pengelolaan kuota.

Kondisi Perangkat - Akurasi status

Memenuhi atau melampaui Akurasi Status >= 99,5% membantu memastikan pengguna melihat hasil yang benar saat mereka melihat status perangkat atau menggunakan fitur AI seperti Tanya Rumah. Jika akurasi status rendah, otomatisasi mungkin tidak berjalan dan entri histori mungkin tidak muncul di tab Aktivitas GHA pada waktu yang tepat. Untuk mengetahui informasi selengkapnya, lihat Status Laporan.

Dasbor kualitas melacaknya setiap jam menggunakan dua metrik yang berbeda: Akurasi Keseluruhan dan Kombinasi Tipe/Ciri Terendah.

1. Komponen Akurasi

Metrik ini berasal dari "sampel" tempat Google dapat memverifikasi status yang dilaporkan terhadap hasil maksud yang diketahui.

2. Metrik Dasbor (Penghitungan Per Jam)

Dasbor menghitung akurasi berdasarkan interval 1 jam. Jika dalam satu jam jumlah total sampel kurang dari 100 (S_Total < 100), akurasi untuk jam tersebut ditetapkan ke N/A.

Tampilan 1: Akurasi Keseluruhan (Rata-Rata Global)

Hal ini menunjukkan total akurasi integrasi Anda di semua jenis perangkat dan gabungan karakteristik. Metrik ini memberikan rata-rata tertimbang dari kesehatan seluruh ekosistem Anda.

Penghitungan: Akurasi Total Status di semua perangkat / Total Status Total di semua perangkat.

Tampilan 2: Kombinasi Tipe/Ciri Terendah

Hal ini mengidentifikasi kategori spesifik yang paling tidak dapat diandalkan dalam integrasi Anda. Hal ini mencegah perangkat bervolume tinggi yang berkualitas tinggi menyembunyikan perangkat bervolume rendah yang berkualitas rendah. Misalnya, jika Anda memiliki volume tinggi lampu dengan Akurasi Status di atas 99,5%, tetapi volume rendah Sakelar dengan Akurasi Status rendah, hal ini menunjukkan peningkatan yang diperlukan pada sakelar yang mungkin hilang dalam nilai rata-rata.