Visualizzare ed esportare i dati di analisi

Analytics ti offre informazioni dettagliate sulle tendenze di utilizzo, sulla qualità della ricerca e sul coinvolgimento degli utenti finali della tua app. La console offre un'esperienza di dashboard interattiva basata su Looker. Questa pagina descrive come visualizzare le analisi per le tue app.

Prima di iniziare

Assicurati che l'app sia connessa a un archivio dati. Le metriche delle app sono disponibili solo dal momento in cui un datastore viene collegato a un'app.

Se non hai un datastore, devi collegare un'origine dati Google o un'origine dati di terze parti alla tua app.

Eventi utente per Analytics

Questa sezione descrive gli eventi utente utilizzati da Gemini Enterprise per generare le metriche correlate alla ricerca, come il conteggio delle ricerche e la percentuale di clic. Non sono necessarie configurazioni aggiuntive se utilizzi l'interfaccia utente per cercare e ottenere risposte tramite l'assistente Gemini Enterprise. Tuttavia, se utilizzi le API Gemini Enterprise nelle tue app, devi configurare la ricerca nella tua app per acquisire gli eventi utente e poi importarli nella tua app.

Le app Gemini Enterprise richiedono i seguenti eventi utente per ottenere le metriche:

  • Cerca eventi. Obbligatorio per la percentuale di clic.
  • Eventi di visualizzazione articolo. Obbligatorio per la percentuale di clic.

Le seguenti informazioni vengono utilizzate anche per alcune analisi:

  • Impressioni. Puoi fornire impressioni (visualizzazioni o clic sugli articoli) attribuibili a Google includendo l'articolo associato in UserEvent.Documents durante l'importazione degli eventi utente. Queste informazioni sono necessarie per l'attribuzione e per calcolare le metriche per ricerca.
  • Token di attribuzione. I token di attribuzione sono ID univoci generati da Google e restituiti con ogni richiesta di ricerca. Assicurati di includere questo token di attribuzione come UserEvent.attributionToken con qualsiasi evento utente risultante da una ricerca. Questo è necessario per identificare se una ricerca viene gestita dall'API. Per calcolare le metriche vengono utilizzati solo gli eventi utente con un token di attribuzione generato da Google.
  • Log di ricerca. I log di ricerca si basano sulle richieste di ricerca. Per consentire a Google di identificare le sessioni utente in modo da poter fornire analisi per sessione e risultati di ricerca di qualità superiore, Google consiglia vivamente di impostare il campo facoltativo SearchRequest.UserPseudoId.

Se non sono presenti log di ricerca o eventi utente, vengono visualizzati i valori predefiniti per tutte le metriche.

Visualizzare le analisi di Gemini Enterprise

Puoi visualizzare le analisi della ricerca per la tua app. Vedrai le metriche relative alle chiamate di ricerca effettuate alla tua app. Se la tua app è connessa a più archivi di dati, è consigliabile effettuare chiamate di ricerca all'app specificando la risorsa engine in modo da ottenere risultati da tutti gli archivi di dati connessi.

Segui queste istruzioni per visualizzare le analisi relative alla tua app.

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic sul nome dell'app per cui vuoi visualizzare le analisi.

  3. Fai clic su Analytics.

  4. Fai clic su una scheda per visualizzare il gruppo di metriche:

    • Adozione: metriche sullo stato di adozione degli utenti.

    • Utilizzo e qualità: metriche sul feedback degli utenti e sull'utilizzo dell'app.

    • Agente: metriche per gli agenti nell'app web Gemini Enterprise, inclusi gli agenti creati da Google, NotebookLM Enterprise e gli agenti che la tua organizzazione ha creato e registrato con Gemini Enterprise.

    • Valore: metriche sul risparmio sui costi ottenuto dagli utenti che eseguono query sui dati con l'app.

    • Livello utente: le metriche includono gli ID email degli utenti dell'organizzazione e le loro interazioni con gli agenti creati da Google e con quelli creati e registrati dall'organizzazione con Gemini Enterprise.

    Visualizza i dati di analisi per l'adozione.
    Visualizza i dati di analisi per l'adozione

  5. Per filtrare le metriche, specifica i filtri disponibili per la scheda delle metriche e poi fai clic sul pulsante Aggiorna per applicarli.

Definizioni delle metriche

La seguente tabella descrive come vengono definite le metriche.

Gruppo di metriche Nome metrica Definizione della metrica Note
Adozione Utenti attivi giornalieri Conteggio degli utenti attivi al giorno Un utente viene considerato attivo se esegue l'accesso e attiva chiamate API, ad esempio quando arriva alla home page.
Utenti attivi settimanali Conteggio degli utenti attivi per settimana. La settimana inizia di lunedì e termina di domenica.
Utenti attivi ogni mese Conteggio degli utenti attivi al mese
Tasso di fidelizzazione dopo 7 giorni Conteggio degli utenti di ritorno nel periodo di 7 giorni corrente / conteggio degli utenti attivi nel periodo di 7 giorni precedente Un utente è considerato di ritorno se è attivo durante il periodo di 7 giorni corrente e il periodo di 7 giorni precedente.
Tasso di crescita a 7 giorni La differenza percentuale tra il numero di utenti attivi nel periodo di sette giorni attuale e nel periodo di sette giorni precedente
Tasso di abbandono a 7 giorni Conteggio degli utenti che hanno abbandonato il servizio nel periodo di 7 giorni corrente / conteggio degli utenti attivi nel periodo di 7 giorni precedente Un utente viene considerato perso se è stato attivo nel periodo di 7 giorni precedente, ma non nel periodo di 7 giorni attuale.
Tasso di fidelizzazione a 28 giorni Conteggio degli utenti di ritorno nel periodo attuale di 28 giorni / conteggio degli utenti attivi nel periodo precedente di 28 giorni
Tasso di crescita a 28 giorni La differenza percentuale tra il numero di utenti attivi nel periodo attuale di 28 giorni e il periodo precedente di 28 giorni
Tasso di abbandono a 28 giorni Conteggio degli utenti che hanno abbandonato il servizio nel periodo attuale di 28 giorni / conteggio degli utenti attivi nel periodo precedente di 28 giorni
Utenze acquistate Il numero di licenze (posti) acquistate dall'organizzazione Include tutti i posti acquistati dalla registrazione a Gemini Enterprise.
Posti rivendicati Il numero di licenze utente assegnate e accettate da persone all'interno della tua organizzazione Include tutti i posti rivendicati dalla registrazione a Gemini Enterprise.
Utilizzo e qualità Numero di ricerche Numero totale di ricerche
Numero di risposte Numero totale di query per cui Gemini Enterprise ha generato una risposta Le risposte generate da un agente non sono incluse in questo conteggio.
Conteggio azioni Numero totale di query a cui ha risposto Gemini Enterprise Include azioni come la creazione di un modello di email.
Percentuale di clic (CTR) per ricerca Numero totale di clic sulla ricerca / numero di ricerche I clic sulla ricerca includono i clic sui risultati di ricerca e sui riferimenti interni.
Visualizzazione di pagina per categoria Numero totale di visualizzazioni per ogni pagina di categoria
Conteggio dei Mi piace e Non mi piace del feedback Conteggio dei Mi piace e dei Non mi piace inviati dagli utenti Un record delle risposte di feedback Mi piace/Non mi piace inviate dagli utenti dell'app.
Suddivisione dei motivi del Non mi piace al feedback Percentuale dei motivi di non mi piace Quando un utente non apprezza una risposta generata, può selezionare più motivi per spiegare il suo disappunto. La percentuale indica la frequenza con cui è stato selezionato ogni motivo.
Tasso di ricerca riuscita Conteggio delle ricerche riuscite / conteggio delle ricerche
Tasso di risposta riuscita Numero di risposte riuscite / numero di risposte
Agenti Utenti attivi mensili dell'agente Il numero totale di utenti attivi che hanno utilizzato l'agente al mese.
Sessioni di chat mensili con agenti Numero totale di sessioni di chat avviate dagli utenti che interagiscono con un agente specifico al mese. Una sessione di chat è definita come l'interazione di un utente con un agente all'interno dello stesso thread di chat in un singolo giorno. Se l'utente continua la conversazione nello stesso thread di chat in un giorno successivo, verrà considerata una nuova sessione.
Agenti utilizzati mensilmente Numero totale di agenti che hanno avuto almeno un utente attivo al mese.
Sessioni di chat totali mensili Il numero totale di sessioni di chat avviate dagli utenti che interagiscono con gli agenti al mese. Una sessione di chat è definita come l'interazione di un utente con un agente all'interno dello stesso thread di chat in un singolo giorno. Se l'utente continua la conversazione nello stesso thread di chat in un giorno successivo, verrà considerata una nuova sessione.
Agenti creati mensilmente Numero totale di agenti creati nell'ultimo mese di calendario.
Utenti attivi giornalieri di NotebookLM Enterprise Conteggio degli utenti attivi di NotebookLM Enterprise al giorno. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook giornalieri creati in NotebookLM Enterprise Conteggio dei notebook NotebookLM Enterprise creati al giorno. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook giornalieri di NotebookLM Enterprise creati per utente Conteggio dei notebook NotebookLM Enterprise creati per utente al giorno. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook giornalieri condivisi di NotebookLM Enterprise Conteggio dei notebook NotebookLM Enterprise condivisi al giorno. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Overview audio giornaliere create in NotebookLM Enterprise Conteggio delle overview audio di NotebookLM Enterprise create al giorno. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Utenti attivi mensili di NotebookLM Enterprise Conteggio degli utenti attivi di NotebookLM Enterprise al mese. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook mensili creati in NotebookLM Enterprise Conteggio dei notebook NotebookLM Enterprise creati al mese. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook mensili creati per utente in NotebookLM Enterprise Numero medio di blocchi note NotebookLM Enterprise creati per utente al mese. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook condivisi mensilmente di NotebookLM Enterprise Conteggio dei notebook NotebookLM Enterprise condivisi al mese. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Overview audio mensili create in NotebookLM Enterprise Conteggio delle overview audio di NotebookLM Enterprise create al mese. Le metriche di NotebookLM Enterprise vengono calcolate a livello di progetto e non per motore.
Valore
(anteprima pubblica)
Ricerca riuscita Conteggio delle ricerche riuscite. Il numero di ricerche riuscite è determinato dal comportamento dell'utente dopo una ricerca. Una ricerca viene considerata riuscita se si verifica una delle seguenti condizioni:
  • Se viene fatto clic su un risultato di ricerca prima di avviare una nuova ricerca.
  • Se la risposta a una ricerca include un risultato di ricerca di persone e non è seguita da un'altra ricerca entro due minuti. Questo perché i risultati della ricerca di persone vengono visualizzati nella pagina dei risultati di ricerca e in genere non richiedono un clic.
Risposta riuscita Conteggio delle risposte corrette Il successo di una risposta è determinato dal comportamento degli utenti dopo la sua generazione. Il successo è misurato in base al feedback fornito o alla rapidità con cui è stata posta una domanda di follow-up.
  • Se l'utente mette Mi piace alla risposta, la query viene considerata riuscita.
  • Se non viene fornito alcun feedback e l'utente non pone un'altra domanda entro 30 secondi, la query viene considerata riuscita.
Ore dei dipendenti salvate per le date selezionate (Conteggio ricerche riuscite + Conteggio risposte riuscite) x Minuti risparmiati per risposta riuscita
Valore salvato per le date selezionate Ore risparmiate entro le date selezionate ✕ Tasso orario medio dei dipendenti Per visualizzare questa metrica, nella scheda Valore, specifica una tariffa oraria per il campo Tariffa oraria dipendente.
Ore annue stimate risparmiate dai dipendenti (Numero di ricerche riuscite + Numero di risposte riuscite) x Minuti risparmiati per ricerca riuscita Il conteggio delle ricerche riuscite annue proiettate viene calcolato a partire dal conteggio delle ricerche riuscite nell'intervallo di date scelto. Si stima che ogni query faccia risparmiare tre minuti, una stima basata sulla ricerca interna di Google.
Valore annuo previsto salvato Ore annue stimate risparmiate dai dipendenti × Tasso orario medio dei dipendenti Per visualizzare questa metrica, nella scheda Valore, specifica una tariffa oraria per il campo Tariffa oraria dipendente.
Livello utente
ID email utente L'ID email di ogni utente all'interno della tua organizzazione.
Totale messaggi Il numero totale di messaggi inviati da un utente all'app web Gemini Enterprise. Include tutti i messaggi inviati dall'utente e non è limitato alle conversazioni con gli agenti Gemini Enterprise.
Messaggi agli agenti creati da Google Il numero totale di messaggi che un utente ha inviato agli agenti creati da Google nell'intervallo di date e ore selezionato.
Messaggi ai nostri agenti Il numero totale di messaggi inviati da un utente agli agenti creati dall'organizzazione e registrati con Gemini Enterprise nell'intervallo di date e ore selezionato.

Esportazione delle metriche

Segui questi passaggi per esportare le metriche in una tabella BigQuery nel tuo progettoGoogle Cloud :

  1. Verifica di disporre delle autorizzazioni e dei ruoli necessari.

  2. Crea un set di dati BigQuery:

    1. Apri la pagina BigQuery nella console Google Cloud .

      Vai alla pagina BigQuery

    2. Nel riquadro Explorer, seleziona lo stesso progetto in cui si trova la tua app Gemini Enterprise per creare il set di dati.

    3. Fai clic sull'opzione e poi su Crea set di dati.

    4. Nella pagina Crea set di dati:

      • In ID set di dati, inserisci un nome univoco per il set di dati. Per esportare le metriche tramite l'API, devi conoscere il nome del set di dati.

      • Per Tipo di località, la tabella seguente mostra come mappare le località BigQuery alle località dell'app Gemini Enterprise:

        Località multiregionale dell'app Gemini Enterprise Località multiregionale BigQuery
        Globale Stati Uniti (più regioni negli Stati Uniti)
        Stati Uniti (più regioni negli Stati Uniti) Stati Uniti (più regioni negli Stati Uniti)
        UE (più regioni nell'Unione Europea) UE (più regioni nell'Unione Europea)

    5. Fai clic su Crea set di dati.

  3. Crea una tabella BigQuery vuota per il set di dati che hai creato.

    1. Nel riquadro Explorer, espandi il progetto e seleziona il set di dati che hai creato.
    2. Nella sezione Informazioni sul set di dati, fai clic su Crea tabella.
    3. Nel riquadro Crea tabella, specifica un nome per la tabella nel campo Tabella. Per esportare le metriche tramite l'API, devi conoscere il nome della tabella.
    4. Fai clic su Crea tabella.

  4. Chiama il metodo analytics:exportMetrics per recuperare i dati delle metriche degli ultimi 30 giorni, incluso il giorno corrente.

    REST

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
-d '{
   "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
   "outputConfig":
      {
         "bigqueryDestination":
         {
            "datasetId": "BIGQUERY_DATASET_ID",
            "tableId": "BIGQUERY_TABLE_ID"
         }
      }
   }' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"

    Sostituisci quanto segue:

    • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
      • us- per la multiregione Stati Uniti
      • eu- per la multiregione EU
      • global- per la località globale
      Per saperne di più, consulta Specifica una regione multipla per il datastore.
    • LOCATION: la multiregione del datastore: global, us o eu
    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app da cui vuoi esportare le metriche.
    • BIGQUERY_DATASET_ID: l'ID del set di dati BigQuery che hai creato.
      L'ID del set di dati segue il formato <PROJECT_ID>.<DATASET_ID>. Devi solo fornire il <DATASET_ID>.
    • BIGQUERY_TABLE_ID: l'ID della tabella BigQuery che hai creato.
      Nella visualizzazione Esplora tabelle classico, l'ID tabella segue il formato <PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. Devi solo fornire il <TABLE_ID>.

    La risposta include il nome e l'ID dell'operazione. Prendi nota dell'ID operazione da utilizzare nel passaggio successivo.
    Ad esempio:

    {
   "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID",
   "metadata": {
      "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
   }
}

  5. Per visualizzare lo stato dell'operazione di esportazione delle metriche, chiama il metodo engines.operations.get:

    REST

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"

    Sostituisci quanto segue:

    • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
      • us- per la multiregione Stati Uniti
      • eu- per la multiregione EU
      • global- per la località globale
      Per saperne di più, consulta Specifica una regione multipla per il datastore.
    • LOCATION: la multiregione del datastore: global, us o eu
    • APP_ID: l'ID dell'app di cui vuoi recuperare le operazioni a lunga esecuzione.
    • OPERATION_ID: l'ID dell'operazione di esportazione delle metriche restituito nella risposta quando hai eseguito il comando per esportare le metriche.