Analytics

Depois que você publicar uma versão da sua ação em um canal de lançamento (alfa, Beta ou de produção) e os usuários invocarem sua ação, você começará a ver dados de análise no Console do Actions, geralmente em 24 horas. Essas análises fornecem informações sobre o uso, a integridade, a descoberta e a listagem de diretórios da sua ação.

Uso

A página Uso exibe três gráficos que pertencem aos dados de uso da sua ação. Você pode exportar dados nos seguintes gráficos no formato CSV.

Este gráfico mostra o uso ao longo do tempo.

Personalize os dados exibidos das seguintes maneiras:

  • Clique no botão correspondente na parte superior do gráfico para ver o uso diário, semanal e mensal.

  • Clique no período no canto inferior esquerdo do gráfico para definir períodos específicos.

    • O número total de usuários únicos no período selecionado é mostrado na parte inferior do gráfico.
  • Clique em Filtrar para alterar o gráfico usando os seguintes dados:

    • Superfície: filtre o uso por superfície usada (por exemplo, dispositivo móvel, alto-falante inteligente, smart display, TV, wearable, automático, feature phone etc.).
    • Ação: filtrar o uso por uma intent específica.
    • Idioma: filtre o uso de acordo com idiomas específicos em que seu Action está disponível.
    • País / região: filtre o uso por países e regiões específicos para os quais a ação está disponível.

Você pode exportar dados dos gráficos no formato CSV. Para isso, clique no botão Exportar.

Retenção de usuários

Este gráfico mostra a retenção de usuários das últimas cinco semanas. Isso inclui todos os usuários (inclusive novos) que usaram a ação.

Personalize os dados exibidos das seguintes maneiras:

  • Clique em Filtrar para alterar o gráfico usando os seguintes dados:

    • Superfície: filtre o uso por superfície usada (por exemplo, dispositivo móvel, alto-falante inteligente, smart display, TV, wearable, automático, feature phone etc.).
    • Ação: filtrar o uso por uma intent específica.
    • Idioma: filtre o uso de acordo com idiomas específicos em que seu Action está disponível.
    • País / região: filtre o uso por países e regiões específicos para os quais a ação está disponível.

Você pode exportar dados dos gráficos no formato CSV. Para isso, clique no botão Exportar.

Dados de conversa

Este gráfico mostra os dados de conversa relacionados à sua ação e inclui as seguintes guias:

  • Conversas: o número de conversas que os usuários tiveram com sua ação. Uma conversa é uma interação única e completa com sua ação, começando pela invocação e terminando com o usuário saindo do contexto da ação.
  • Mensagens: o número de rodadas de conversas em todas as conversas.
  • Duração média: a duração média, em segundos, que os usuários interagiram com sua ação antes de sair da conversa.
  • Taxa de cancelamento: a porcentagem de tempo que os usuários saíram ou foram cancelados em uma conversa com a ação.

Personalize os dados exibidos das seguintes maneiras:

  • Clique no período no canto inferior esquerdo do gráfico para definir períodos específicos.
  • Clique em Filtrar para alterar o gráfico usando os seguintes dados:

    • Superfície: filtre o uso por superfície usada (por exemplo, dispositivo móvel, alto-falante inteligente, smart display, TV, wearable, automático, feature phone etc.).
    • Ação: filtrar o uso por uma intent específica.
    • Idioma: filtre o uso de acordo com idiomas específicos em que seu Action está disponível.
    • País / região: filtre o uso por países e regiões específicos para os quais a ação está disponível.

Você pode exportar dados dos gráficos no formato CSV. Para isso, clique no botão Exportar.

Engajamento do usuário

O gráfico de engajamento do usuário mostra como os usuários interagiram com sua ação durante um mês selecionado. Normalmente conhecido como curva de usuário avançado, esse gráfico mostra quantos usuários são "usuários avançados", ou seja, usuários dedicados que se engajam com sua ação regularmente, traçando a porcentagem de usuários envolvidos com ela nos dias do mês.

Cada número no eixo x representa o número de dias em um mês que os usuários interagiram com sua ação. Por exemplo, a coluna 4 representa a porcentagem de usuários que interagiram com sua ação quatro dias no mês. Se você passar o cursor sobre uma coluna, um pop-up será exibido com essas informações, conforme mostrado na seguinte captura de tela:

Você pode personalizar os dados exibidos da seguinte maneira:

  • Clique no período no canto do gráfico para especificar o mês cujos dados você quer ver.

Você pode exportar dados dos gráficos no formato CSV. Para exportar esses dados, clique em Exportar.

Saúde

A seção de integridade ajuda a acompanhar as seguintes métricas relacionadas à qualidade e à integridade da ação:

  • Errors: o número de erros retornados pelo endpoint da nuvem da ação em um determinado dia. Se você tiver um grande número de erros, analise seus registros para identificar o que está causando falhas ou comportamentos inesperados no endpoint.

    • Selecione o link Ver registros para visualizar os registros do projeto no Console do Google Cloud. Saiba mais sobre como ler esses registros na página Solução de problemas.
  • Latência da ação: a latência do endpoint da ação. Se a latência for muito alta ou aumentar regularmente, talvez os usuários estejam com atraso ao interagir com a ação.

  • Latência observada pelo usuário: a latência sentida pelo usuário em cada solicitação para sua ação. Essa métrica ilustra a experiência dos usuários ao interagir com sua ação.

  • Solicitações de API (somente Actions Builder): esse gráfico mostra o detalhamento do total de solicitações de API e dos status delas. Uma solicitação de API com falha significa que os dados corretos não foram retornados.

Os dados podem ser exportados dos gráficos no formato CSV.

Clique em Filtrar para ver as seguintes opções de visualização:

  • Superfície: filtre por dispositivo móvel, alto-falante inteligente e smart display.
  • Ação: filtre por ações específicas.
  • Idioma: filtre pelos idiomas compatíveis com o Action.
  • País/região: filtre por país/região onde sua ação está disponível.

Você pode exportar dados dos gráficos no formato CSV. Para isso, clique no botão Exportar.

Descoberta

A seção de descoberta mostra informações sobre como os usuários estão descobrindo sua ação.

Quando os usuários dizem uma frase relacionada à sua ação, às vezes o Google recomenda que ela seja usada, mesmo que o usuário não tenha especificado explicitamente o nome de invocação da ação. A página de descoberta exibe uma tabela de quais frases levaram o Google a recomendar sua ação. As colunas nesta tabela são as seguintes:

  • Invocação: a consulta do usuário que levou o Google a recomendar sua ação. Além das consultas reais do usuário, essa lista inclui os seguintes valores:

    • BUILT_IN_INTENT: essa lista indica que sua ação foi invocada por meio de uma intent integrada.
    • AUTO_MATCHED_BY_GOOGLE: esta listagem indica quando a invocação implícita foi usada.
    • ACTION_LINK: esta lista indica quando sua ação foi invocada por meio de um link do Assistente.
  • Intent: a intent correspondente à consulta do usuário.

  • Impressão: o número de vezes que essa frase levou o Google a recomendar sua ação.

  • Seleção: o número de vezes que um usuário invocou sua ação depois que o Google a recomendou. Esse número não pode exceder o número de impressões que a frase tem.

  • Taxa de seleção: a porcentagem de impressões que levaram a uma seleção. Uma taxa percentual baixa indica que muitos usuários estão optando por usar outras ações para essa consulta específica, enquanto uma taxa alta indica que sua ação é popular nessa consulta.

Você pode exportar dados dos gráficos no formato CSV. Para isso, clique no botão Exportar.

Diretório

A seção de diretório mostra o tráfego e as classificações da ação no diretório do Assistente.

  • Resumo das classificações: a avaliação média da ação, número total de classificações e número de usuários que classificaram sua ação a cada pontuação.
  • Avaliação média: exibe a avaliação média cumulativa da sua ação ao longo do tempo ou a média de todas as avaliações em um determinado dia.
  • Classificações ao longo do tempo: a distribuição das pontuações cumulativas da sua ação ao longo do tempo ou em um determinado dia.
  • Visualizações da página do diretório do Assistente: o número de vezes que a página do diretório da ação é visitada por dia. As visualizações podem ser filtradas por país/região, idioma e outras opções úteis de categorização.
  • Invocações iniciadas do diretório do Assistente: o número de vezes que sua ação foi invocada pelo usuário pressionando o botão "Testar" no diretório. As invocações podem ser filtradas por ação, país/região e outras opções úteis de categorização.

Exporte para o BigQuery

O BigQuery é a solução de armazenamento de dados sem servidor totalmente gerenciada do Google. É possível configurar os dados de análise da sua ação para serem exportados diariamente para sua conta do BigQuery. Quando seus dados estiverem no BigQuery, será possível fazer análises adicionais, inclusive criar painéis e visualização de dados próprios.

Conecte-se ao BigQuery

Para conectar sua ação ao BigQuery, siga estas etapas:

  1. Na página Analytics, clique em Exportar no menu à esquerda.
  2. Clique em Começar.
  3. Escolha a data de início da exportação.

  4. Clique em Exportar.

Uma página de resumo mostrará o status diário do processo de exportação como Pendente, Falha ou Concluído.

O processo de exportação aparecerá como Pendente até que a exportação seja concluída.

Preenchimento de dados históricos

Para exportar dados de uma data anterior, você pode optar por preencher os dados históricos. Para isso, siga estas etapas:

  1. Na página Análise, clique em Exportar.
  2. Clique no ícone de roda dentada.
  3. Clique em Preencher dados históricos.
  4. Escolha a opção de data desejada.
  5. Clique em Exportar.

O processo de preenchimento será exibido como Pendente até que a exportação seja concluída.

Interromper exportação

Para interromper a exportação para o BigQuery, siga estas etapas:

  1. Na página Análise, clique em Exportar.
  2. Clique no ícone de roda dentada.
  3. Clique em Desconectar do BigQuery.
  4. Clique em Desconectar para confirmar.

Ferramentas de análise adicionais

Depois de implantar a ação, é possível acompanhar itens como adoção, uso e qualidade para ajudar a analisar o estado atual das ações e responder a perguntas como:

  • Quantos usuários eu tenho? Meus usuários estão aumentando?
  • Os usuários estão confusos sobre o que fazer ou dizem coisas que minha ação não entende?
  • Os usuários passam muito tempo com minha ação ou cancelam a conversa regularmente?
  • Quais das minhas ações são mais populares e quais têm baixo envolvimento?

Esses dados ajudam a identificar oportunidades para melhorar suas ações. Para receber esses dados, permitimos a integração dos provedores de ferramentas de análise com o Actions on Google, e você pode configurar essas ferramentas em apenas cinco minutos:

Ferramentas adicionais de monitoramento

Ao desenvolver e implantar suas ações, você pode se beneficiar da adição de geração de registros, monitoramento e alertas. As ferramentas de monitoramento e alerta rastreiam o tempo de atividade e notificam você sobre erros e exceções. Com essas ferramentas, você também pode depurar e testar ações com solicitações reais do Assistente. As seguintes ferramentas de monitoramento se integraram ao Actions on Google: