Esse conjunto de painéis e alertas ajuda você a manter proativamente uma integração de alta qualidade com o ecossistema do Google Home. O Google tem o compromisso de apoiar os parceiros no desenvolvimento de um ecossistema de alta qualidade para todos os clientes.
O painel tem três seções, cada uma abordando uma parte fundamental que contribui para a qualidade de uma integração geral.
Métricas do Google para parceiro: medem a integridade das chamadas do Google para seu back-end da nuvem.
Integridade do sistema: métricas de parceiro para Google: mede a integridade das chamadas do seu sistema para o Google.
Integridade do dispositivo: precisão do estado: mede a precisão dos estados armazenados nos sistemas do Google, que são usados para atender às consultas dos usuários.
Quando as métricas não atingem os valores desejados, elas são destacadas em vermelho para indicar um problema que pode afetar a experiência do usuário. As informações a seguir fornecem detalhes sobre cada meta e por que ela é importante para seus usuários.
Métricas do Google para o parceiro
A métrica Taxa de sucesso de consulta/execução >= 99,5% mede a frequência com que os comandos dos usuários são atendidos corretamente, o que ajuda a evitar respostas do Google Assistente como "Não consigo acessar o dispositivo" ou a confirmação incorreta de um comando que não foi atendido.
O que define um "sucesso"?
Uma transação é marcada como bem-sucedida se a plataforma Google Home receber uma resposta válida indicando que a ação pretendida foi concluída ou que o estado solicitado foi recuperado.
As respostas que incluem exceções sem bloqueio (por exemplo, um status SUCCESS acompanhado de uma exceção lowBattery) são contadas como transações bem-sucedidas.
O comando chegou ao dispositivo e a intent foi atendida apesar do aviso.
O que define uma "falha"?
Os erros encontrados em Códigos de erro comuns da plataforma, marcados como Ação do parceiro necessária, são considerados "Falhas" ao calcular as taxas de sucesso de QUERY e EXECUTE.
A métrica Latência de consulta/execução (p90) <= 1.000 ms mede o tempo de espera da ação solicitada e ajuda a garantir que os usuários não precisem esperar muito tempo, por exemplo, alguns segundos para que a luz se apague.
Métricas de latência
A latência é um indicador essencial de como sua integração responde ao usuário final. O painel acompanha a latência do 90º percentil (P90), que representa a experiência dos usuários "mais lentos". Por exemplo, um P90 de 800 ms significa que 90% das solicitações são reconhecidas em 800 ms ou menos.
O Google mede a latência de maneira diferente para verificações de status e comandos de dispositivo para garantir a precisão técnica.
1. Latência da CONSULTA (interrogativa)
Isso mede o tempo de ida e volta Cloud-to-cloud quando o Google pede o estado atual de um dispositivo.
- Início: o Google envia uma solicitação
action.devices.QUERYpara o URL de fulfillment. - Janela de medição: o tempo necessário para que sua nuvem receba, processe e transmita a resposta HTTP completa de volta ao Google.
- Fim: o Google recebe e confirma o payload da resposta final do seu serviço.
2. Latência de EXECUTE (ação)
Isso mede o tempo de confirmação do comando quando o Google envia uma solicitação de controle a um dispositivo.
- Início: o Google envia uma solicitação
action.devices.EXECUTEpara o URL de fulfillment. - Janela de medição: o tempo necessário para que sua nuvem receba o comando e retorne uma resposta de confirmação.
- Fim: o Google recebe a resposta de status
SUCCESS,PENDINGouOFFLINE. - Escopo técnico: essa métrica mede o tempo de "confirmação de resposta" entre a nuvem do Google e a sua. Ele não mede o tempo necessário para que o hardware físico (por exemplo, uma lâmpada) conclua a mudança de estado físico, já que isso geralmente envolve a latência da rede mesh local fora do caminho de nuvem para nuvem.
Integridade do sistema: métricas de parceiros para o Google
Manter uma taxa de sucesso >= 99, 5% ajuda a garantir que os estados dos dispositivos estejam corretos no Google Home, que os dispositivos sejam adicionados e removidos, que as automações sejam acionadas e que os eventos do histórico apareçam na guia "Atividade" do Google Home app (GHA).
A taxa de sucesso é calculada com base nos códigos de resposta HTTP retornados pelo Google quando seus pushs na nuvem enviam atualizações de estado. Para garantir que os parceiros não sejam penalizados por problemas de infraestrutura do Google, a métrica exclui erros internos do Google da contagem de falhas.
O que define um "sucesso"?
- 2xx (sucesso): a atualização de estado foi recebida e processada pela Home Graph.
O que define uma "falha"?
- 4xx (erro do parceiro): representam falhas e indicam um problema com a solicitação enviada da sua nuvem. Alguns códigos comuns:
- 400 Bad Request: o servidor não conseguiu processar a solicitação devido a uma sintaxe inválida. As causas comuns incluem JSON malformado ou o uso de "null" em vez de "" para um valor de string.
- 404 Não encontrado: não foi possível encontrar o recurso solicitado. Normalmente, isso significa que o Google não consegue encontrar o dispositivo solicitado. Também pode significar que a conta de usuário não está vinculada ou que um
agentUserIdinválido foi recebido. Verifique se oagentUserIdcorresponde ao valor fornecido na resposta SYNC e se você está processando corretamente as intentsDISCONNECT. - 429 Recurso esgotado: sua integração excedeu a cota alocada. Consulte as instruções na seção "Etapa 1" mais acima no painel para gerenciar cotas.
Integridade do dispositivo: acurácia do estado
Manter ou exceder uma acurácia de estado >= 99,5% ajuda a garantir que os usuários vejam resultados corretos ao visualizar os estados do dispositivo ou usar recursos de IA, como o recurso Perguntar ao Google Home. Se a acurácia do estado for baixa, as automações poderão não ser acionadas, e as entradas do histórico poderão não aparecer na guia "Atividade" do GHA no momento certo. Para mais informações, consulte Report State.
O painel de qualidade acompanha isso a cada hora usando duas métricas distintas: Acurácia geral e Combinação de tipo/característica mais baixa.
1. Componentes de acurácia
A métrica é derivada de "amostras" em que o Google pode verificar o estado informado em relação a um resultado de intenção conhecido.
2. Métricas do painel (cálculo por hora)
O painel calcula a acurácia com base em um intervalo de uma hora. Se uma hora tiver menos de 100 amostras totais (S_Total < 100), a acurácia dessa hora será definida como N/A.
Visualização 1: acurácia geral (média global)
Isso representa a acurácia total da sua integração em todos os tipos de dispositivos e características combinadas. Ele fornece uma média ponderada da integridade de todo o seu ecossistema.
- Cálculo: total de acurácia de estado em todos os dispositivos / total de estado em todos os dispositivos.
Visualização 2: combinação de tipo/característica mais baixa
Isso identifica a categoria específica menos confiável na sua integração. Isso evita que dispositivos de alto volume e alta qualidade ocultem dispositivos de baixo volume e baixa qualidade. Por exemplo, se você tiver um volume alto de luzes com acurácia de estado acima de 99,5%, mas um volume baixo de interruptores com acurácia de estado baixa, isso vai destacar a melhoria necessária nos interruptores, que pode ser perdida em um valor médio.
- Cálculo: mínimo de acurácia do estado / total do estado para todas as combinações de traço/dispositivo.