Dopo che hai pubblicato una versione dell'azione su un canale di rilascio (alpha, beta o di produzione) e che gli utenti hanno richiamato l'azione, inizierai a visualizzare i dati di analisi nella console di Actions, in genere entro 24 ore. Questi dati forniscono informazioni su utilizzo, integrità, rilevamento e elenco di directory dell'azione.
Utilizzo
La pagina Utilizzo mostra tre grafici relativi ai dati sull'utilizzo della tua azione. Puoi esportare i dati nei seguenti grafici in formato CSV.
Tendenze di utilizzo
Questo grafico mostra l'utilizzo nel tempo.
Personalizza i dati visualizzati nei seguenti modi:
Fai clic sul pulsante corrispondente nella parte superiore del grafico per visualizzare l'utilizzo giornaliero, settimanale e mensile.
Fai clic sull'intervallo di date nell'angolo in basso a sinistra del grafico per impostare intervalli di tempo specifici da visualizzare.
- Il numero totale di utenti unici per l'intervallo di date selezionato è riportato nella parte inferiore del grafico.
Fai clic su Filtra per modificare il grafico utilizzando i seguenti dati:
- Superficie: filtra l'utilizzo in base alla superficie utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabile, auto, feature phone e così via).
- Azione: filtra l'utilizzo in base a un intent specifico.
- Lingua: filtra l'utilizzo in base alle lingue specifiche in cui è disponibile l'azione.
- Paese / area geografica: filtra l'utilizzo per paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. Per farlo, fai clic sul pulsante Esporta.
Fidelizzazione utenti
Questo grafico mostra la fidelizzazione degli utenti nelle ultime cinque settimane. Sono inclusi tutti gli utenti (inclusi i nuovi utenti) che hanno utilizzato la tua azione.
Personalizza i dati visualizzati nei seguenti modi:
Fai clic su Filtra per modificare il grafico utilizzando i seguenti dati:
- Superficie: filtra l'utilizzo in base alla superficie utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabile, auto, feature phone e così via).
- Azione: filtra l'utilizzo in base a un intent specifico.
- Lingua: filtra l'utilizzo in base alle lingue specifiche in cui è disponibile l'azione.
- Paese / area geografica: filtra l'utilizzo per paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. Per farlo, fai clic sul pulsante Esporta.
Dati relativi alle conversazioni
Questo grafico mostra i dati colloquiali relativi alla tua azione e include le seguenti schede:
- Conversazioni: il numero di conversazioni effettuate dagli utenti con la tua azione. Una conversazione è una singola interazione completa con l'azione, a partire dalla chiamata e fino all'uscita dell'utente dal contesto dell'azione.
- Messaggi: il numero di conversazioni svolte in tutte le conversazioni.
- Lunghezza media: la durata media in secondi degli utenti che hanno interagito con la tua azione prima di uscire dalla conversazione.
- Percentuale di interruzione: la percentuale di volte in cui gli utenti sono usciti o hanno interrotto una conversazione con la tua azione.
Personalizza i dati visualizzati nei seguenti modi:
- Fai clic sull'intervallo di date nell'angolo in basso a sinistra del grafico per impostare intervalli di tempo specifici da visualizzare.
Fai clic su Filtra per modificare il grafico utilizzando i seguenti dati:
- Superficie: filtra l'utilizzo in base alla superficie utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabile, auto, feature phone e così via).
- Azione: filtra l'utilizzo in base a un intent specifico.
- Lingua: filtra l'utilizzo in base alle lingue specifiche in cui è disponibile l'azione.
- Paese / area geografica: filtra l'utilizzo per paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. Per farlo, fai clic sul pulsante Esporta.
Coinvolgimento degli utenti
Il grafico sul coinvolgimento degli utenti mostra in che modo gli utenti hanno interagito con la tua azione durante un mese selezionato. Questo grafico, comunemente noto come curva degli utenti avanzati, ti consente di vedere quanti dei tuoi utenti sono "utenti esperti", ovvero utenti dedicati che interagiscono con la tua azione, tracciando la percentuale di utenti che interagiscono con la tua azione in base ai giorni del mese.
Ogni numero sull'asse X indica il numero di giorni di un mese in cui gli utenti hanno interagito con la tua azione. Ad esempio, la colonna 4 rappresenta la percentuale di utenti che hanno interagito con la tua azione quattro giorni nel mese. Se passi il mouse sopra una colonna, viene visualizzato un popup con queste informazioni, come mostrato nel seguente screenshot:
Puoi personalizzare i dati visualizzati nel seguente modo:
- Fai clic sull'intervallo di date nell'angolo del grafico per specificare il mese per il quale visualizzare i dati.
Puoi esportare i dati dai grafici in formato CSV. Per esportare questi dati, fai clic su Esporta.
Salute
La sezione Salute ti aiuta a monitorare le seguenti metriche relative alla qualità e all'integrità dell'azione:
Errori: il numero di errori restituiti dall'endpoint cloud dell'azione in un determinato giorno. Se hai un numero elevato di errori, puoi esaminare i tuoi log per identificare la causa dell'arresto anomalo o del comportamento imprevisto dell'endpoint.
- Seleziona il link Visualizza log per visualizzare i log del progetto nella console Google Cloud. Puoi scoprire di più sulla lettura di questi log alla pagina Risoluzione dei problemi.
Latenza azione: la latenza dell'endpoint dell'azione. Se la latenza è molto alta o si verifica un picco costante, gli utenti potrebbero riscontrare ritardi durante l'interazione con l'azione.
Latenza sperimentata dall'utente: la latenza percepita da un utente in ogni richiesta alla tua azione. Questa metrica illustra l'esperienza degli utenti quando interagiscono con la tua azione.
Richieste API (solo generatore di azioni): questo grafico mostra l'analisi delle richieste API totali e dei relativi stati. Una richiesta API non riuscita indica che non sono stati restituiti i dati corretti.
I dati possono essere esportati dai grafici e viceversa in formato CSV.
Se fai clic su Filtro, vengono visualizzate le seguenti opzioni di visualizzazione aggiuntive:
- Superficie: filtra per dispositivi mobili, smart speaker e smart display.
- Azione. Filtra in base a Azioni specifiche.
- Lingua: filtra in base alle lingue supportate dalla tua azione.
- Paese/area geografica: consente di applicare un filtro basato su paese/area geografica in cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. Per farlo, fai clic sul pulsante Esporta.
Scoperta
La sezione Discovery mostra informazioni sulla modalità di rilevamento della tua azione da parte degli utenti.
Quando gli utenti dicono una frase correlata alla tua azione, a volte Google consiglia loro di provare l'azione, anche se non hanno specificato esplicitamente il nome di chiamata dell'azione. La pagina di scoperta mostra una tabella delle frasi che hanno portato Google a consigliare la tua azione. Le colonne in questa tabella sono i seguenti:
Chiamata: la query dell'utente che ha portato Google a consigliare la tua azione. Oltre alle query effettive degli utenti, l'elenco include i seguenti valori:
BUILT_IN_INTENT
: questa scheda indica che l'azione è stata richiamata tramite un intent integrato.AUTO_MATCHED_BY_GOOGLE
- Questa scheda indica quando è stata usata la chiamata implicita.ACTION_LINK
: questa scheda indica quando l'azione è stata richiamata tramite un link dell'assistente.
Intent: l'intent per cui è stata trovata la corrispondenza con la query dell'utente.
Impressione: il numero di volte in cui questa frase ha portato Google a consigliare la tua azione.
Selezione: il numero di volte in cui un utente ha richiamato l'azione dopo che Google lo ha consigliato. Il numero non può superare il numero di impressioni ricevute da questa frase.
Tasso di selezione: la percentuale di impressioni che hanno portato a una selezione. Una percentuale bassa indica che molti utenti scelgono di utilizzare altre azioni per questa query specifica, mentre una percentuale elevata indica che la tua azione è popolare per questa query.
Puoi esportare i dati dai grafici in formato CSV. Per farlo, fai clic sul pulsante Esporta.
Directory
La sezione Directory mostra traffico e valutazioni per la tua azione nella directory dell'assistente.
- Riepilogo valutazioni: la valutazione media dell'azione, il numero totale di valutazioni e il numero di utenti che hanno valutato la tua azione a ciascun punteggio.
- Valutazione media: la valutazione media cumulativa dell'azione nel tempo o la media di tutte le recensioni in un determinato giorno.
- Valutazioni nel tempo: la distribuzione dei punteggi cumulativi della tua azione nel tempo o in un determinato giorno.
- Visualizzazioni di pagina della directory dell'assistente: il numero di volte che la pagina della directory delle azioni è stata visitata al giorno. Le visualizzazioni possono essere filtrate in base a paese/area geografica, lingua e altre utili opzioni di categorizzazione.
- Chiamate avviate dalla directory dell'assistente: il numero di volte in cui l'azione è stata richiamata dall'utente premendo il pulsante "Prova" nella directory. Le chiamate possono essere filtrate per Azione, paese/regione e altre utili opzioni di categorizzazione.
Esporta in BigQuery
BigQuery è la soluzione di data warehousing serverless completamente gestita di Google. Puoi configurare l'esportazione giornaliera dei dati di analisi dell'azione nel tuo account BigQuery. Una volta inseriti i dati in BigQuery, puoi eseguire ulteriori analisi dei dati, tra cui la creazione di dashboard e la visualizzazione dei dati.
Connettersi a BigQuery
Per collegare l'azione a BigQuery, segui questi passaggi:
- Nella pagina Analytics, fai clic su Esporta nel menu a sinistra.
- Fai clic su Inizia.
Scegli la data da cui vuoi iniziare l'esportazione.
Fai clic su Esporta.
Una pagina di riepilogo mostrerà lo stato giornaliero del processo di esportazione come In attesa, Non riuscito o Completato.
La procedura di esportazione risulterà In attesa fino al completamento dell'esportazione.
Esegui backfill dei dati storici
Per esportare i dati a partire da una data precedente, puoi scegliere di eseguire il backfill dei dati storici. Per farlo, segui questi passaggi:
- Nella pagina Analytics, fai clic su Esporta.
- Fai clic sull'icona a forma di ingranaggio.
- Fai clic su Dati storici di backfill.
- Scegli l'opzione di data che preferisci.
- Fai clic su Esporta.
La procedura di backfill risulterà In attesa fino al completamento dell'esportazione.
Interrompi esportazione
Per interrompere l'esportazione in BigQuery:
- Nella pagina Analytics, fai clic su Esporta.
- Fai clic sull'icona a forma di ingranaggio.
- Fai clic su Disconnetti da BigQuery.
- Fai clic su Disconnetti per confermare.
Strumenti di analisi aggiuntivi
Dopo aver eseguito il deployment dell'azione, puoi monitorare elementi come adozione, utilizzo e qualità per analizzare lo stato attuale delle azioni e rispondere a domande come:
- Quanti sono i miei utenti? I miei utenti stanno aumentando?
- Gli utenti sono confusi su cosa fare o dicono cose che la mia azione non comprende?
- Gli utenti trascorrono molto tempo con la mia azione o annullano regolarmente la conversazione?
- Quali sono le mie azioni più popolari e quali hanno un basso coinvolgimento?
Questi dati ti aiutano a identificare opportunità per migliorare il successo a lungo termine delle tue azioni. Per consentirti di ottenere questi dati, abbiamo consentito ai fornitori di strumenti di analisi di integrarsi con Actions on Google e puoi configurarli in soli cinque minuti:
![]() |
![]() |
![]() |
Strumenti di monitoraggio aggiuntivi
Durante lo sviluppo e il deployment delle azioni, potresti trovare utile aggiungere logging, monitoraggio e avvisi. Gli strumenti di monitoraggio e avvisi monitorano il tempo di attività e ti inviano una notifica di errori ed eccezioni. Con questi strumenti puoi anche eseguire il debug e testare azioni con richieste reali dall'assistente. I seguenti strumenti di monitoraggio sono integrati con Actions on Google:
![]() |