Dopo che hai pubblicato una versione dell'azione in un canale di rilascio (alpha, beta o 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. Queste analisi forniscono informazioni sull'utilizzo, lo stato, l'individuazione e l'elenco delle directory della tua azione.
Utilizzo
Nella pagina Utilizzo sono visualizzati 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 è visualizzato nella parte inferiore del grafico.
Fai clic su Filtro per modificare il grafico utilizzando i seguenti dati:
- Piattaforma: filtra l'utilizzo in base alla piattaforma utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabili, 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 in base a paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. A tale scopo, fai clic sul pulsante Esporta.
Fidelizzazione utenti
Questo grafico mostra la fidelizzazione degli utenti per le ultime cinque settimane. Sono inclusi tutti gli utenti che hanno utilizzato l'azione (inclusi i nuovi).
Personalizza i dati visualizzati nei seguenti modi:
Fai clic su Filtro per modificare il grafico utilizzando i seguenti dati:
- Piattaforma: filtra l'utilizzo in base alla piattaforma utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabili, 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 in base a paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. A tale scopo, 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 degli utenti con la tua azione. Per conversazione si intende una singola interazione completa con l'azione, a partire dalla chiamata per terminare quando l'utente esce dal contesto dell'azione.
- Messaggi: il numero di conversazioni che si alternano in tutte le conversazioni.
- Durata media: la durata media, in secondi, che gli utenti hanno interagito con l'azione prima di uscire dalla conversazione.
- Percentuale di interruzione: la percentuale di volte in cui gli utenti sono usciti o sono stati interrotti da una conversazione con l'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 Filtro per modificare il grafico utilizzando i seguenti dati:
- Piattaforma: filtra l'utilizzo in base alla piattaforma utilizzata (ad esempio: dispositivo mobile, altoparlante smart, smart display, TV, indossabili, 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 in base a paesi e aree geografiche specifici per cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. A tale scopo, fai clic sul pulsante Esporta.
Coinvolgimento degli utenti
Il grafico sul coinvolgimento degli utenti mostra in che modo gli utenti hanno interagito con l'azione durante il mese selezionato. Questa metrica, comunemente nota come curva di utenti esperti, ti consente di vedere quanti dei tuoi utenti sono "utenti esperti", ovvero utenti dedicati che interagiscono regolarmente con la tua azione, tracciando la percentuale di utenti che interagiscono con l'azione in base ai giorni del mese.
Ogni numero sull'asse x rappresenta 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 per 4 giorni nel mese. Se passi il cursore 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 cui vuoi visualizzare i dati.
Puoi esportare i dati dai grafici in formato CSV. Per esportare questi dati, fai clic su Esporta.
Salute
La sezione Stato della salute ti consente di monitorare le seguenti metriche relative alla qualità e all'integrità della tua azione:
Errori: il numero di errori restituiti dall'endpoint cloud della tua azione in un determinato giorno. Se hai un numero elevato di errori, puoi esaminare i log per identificare la causa del blocco 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 dell'azione: la latenza dell'endpoint dell'azione. Se la latenza è molto elevata o aumenta costantemente, gli utenti potrebbero riscontrare ritardi durante l'interazione con l'azione.
Latenza riscontrata dall'utente: la latenza percepita da un utente in ogni richiesta alla tua azione. Questa metrica mostra l'esperienza degli utenti quando interagiscono con la tua azione.
Richieste API (solo per il generatore di azioni): questo grafico mostra una suddivisione delle richieste API totali e dei relativi stati. Una richiesta API non riuscita significa che non sono stati restituiti i dati corretti.
I dati possono essere esportati dai grafici in formato CSV
Se fai clic su Filtro, sono disponibili le seguenti opzioni di visualizzazione aggiuntive:
- Piattaforma: filtra in base a dispositivo mobile, 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: filtra in base al paese o all'area geografica in cui è disponibile l'azione.
Puoi esportare i dati dai grafici in formato CSV. A tale scopo, fai clic sul pulsante Esporta.
Scoperta
La sezione di scoperta mostra informazioni su come gli utenti stanno scoprendo la tua azione.
Quando gli utenti pronunciano una frase correlata alla tua azione, a volte Google consiglia loro di provare l'azione, anche se non hanno specificato esplicitamente il nome della tua azione. La pagina di scoperta mostra una tabella delle frasi che hanno indotto Google a consigliare l'azione. Le colonne in questa tabella sono le seguenti:
Chiamata: la query dell'utente che ha portato Google a consigliare la tua azione. Oltre alle query degli utenti, questo elenco include i seguenti valori:
BUILT_IN_INTENT
: questa scheda indica che l'azione è stata richiamata tramite un intent integrato.AUTO_MATCHED_BY_GOOGLE
: questo elenco indica quando è stata utilizzata la chiamata implicita.ACTION_LINK
: questa scheda indica quando l'azione è stata richiamata tramite un link dell'assistente.
Intent: l'intent corrispondente alla 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 l'ha consigliata. Questo numero non può superare il numero di impressioni ricevute dalla frase.
Tasso di selezione: la percentuale di impressioni che hanno generato una selezione. Una percentuale bassa indica che molti utenti stanno scegliendo di utilizzare altre azioni per questa query, mentre una percentuale alta indica che l'azione è popolare per questa query.
Puoi esportare i dati dai grafici in formato CSV. A tale scopo, fai clic sul pulsante Esporta.
Directory
La sezione della directory mostra il traffico e le valutazioni per la tua azione nella directory dell'assistente.
- Riepilogo delle 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 di valutazione cumulativi dell'azione nel tempo o in un giorno specifico.
- Visualizzazioni di pagina della directory dell'assistente: il numero di volte in cui la pagina di directory delle azioni è stata visitata ogni giorno. Le visualizzazioni possono essere filtrate in base a paese/area geografica, lingua e altre utili opzioni di classificazione.
- 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 in base ad azione, paese/area geografica e altre utili opzioni di classificazione.
Esporta in BigQuery
BigQuery è la soluzione di data warehousing serverless completamente gestita di Google. Puoi configurare i dati di analisi delle azioni da esportare ogni giorno nel tuo account BigQuery. Una volta che i dati sono in BigQuery, puoi eseguirne un'ulteriore analisi, compresa la creazione delle tue dashboard e la visualizzazione dei dati.
Connettiti a BigQuery
Per collegare l'azione a BigQuery:
- Nella pagina Analytics, fai clic su Esporta nel menu a sinistra.
- Fai clic su Inizia.
Scegli la data a partire da quando vuoi iniziare l'esportazione.
Fai clic su Esporta.
Una pagina di riepilogo mostra lo stato giornaliero del processo di esportazione come In attesa, Non riuscito o Completato.
Il processo di esportazione verrà visualizzato come In attesa fino al completamento dell'esportazione.
Esegui backfill dei dati storici
Per esportare i dati di 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 Esegui il backfill dei dati storici.
- Scegli l'opzione della data che preferisci.
- Fai clic su Esporta.
Il processo di backfill verrà visualizzato come 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, potresti voler tenere traccia, ad esempio, dell'adozione, dell'utilizzo e della qualità per analizzare lo stato attuale delle azioni e rispondere a domande quali:
- Quanti sono i miei utenti? I miei utenti stanno aumentando?
- Gli utenti non sanno bene cosa fare o dicono qualcosa che la mia Azione non comprende?
- Gli utenti trascorrono molto tempo con la mia azione o annullano regolarmente la conversazione?
- Quali delle mie azioni sono le più popolari e quali hanno un basso coinvolgimento?
Questi dati ti aiutano a identificare le 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 potrai configurarli in soli cinque minuti:
![]() |
![]() |
![]() |
Strumenti di monitoraggio aggiuntivi
Durante lo sviluppo e il deployment delle azioni, puoi usufruire dell'aggiunta del logging, del monitoraggio e degli avvisi. Gli strumenti di monitoraggio e avvisi monitorano il tempo di attività e ti avvisano in caso di errori ed eccezioni. Con questi strumenti, puoi anche eseguire il debug e testare le azioni con richieste reali dall'assistente. I seguenti strumenti di monitoraggio sono stati integrati con Actions on Google:
![]() |