Visualizzare ed esportare i dati di analisi

L'analisi ti fornisce insight 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 l'analisi per le tue app.

Prima di iniziare

Assicurati che l'app sia connessa a un datastore. Le metriche dell'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 l'analisi

Questa sezione descrive gli eventi utente utilizzati da Gemini Enterprise per generare le metriche relative 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 nell'app per acquisire gli eventi utente e poi importarli nell'app.

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

  • Eventi di ricerca. Obbligatorio per la percentuale di clic.
  • Eventi view_item. Obbligatorio per la percentuale di clic.

Le seguenti informazioni vengono utilizzate anche per alcune analisi:

  • Impressioni. Puoi fornire le 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 in tutti gli eventi utente risultanti da una ricerca. Questo è necessario per identificare se una ricerca viene pubblicata dall'API. Per calcolare le metriche vengono utilizzati solo gli eventi utente con un token di attribuzione generato da Google.
  • Cerca nei log. 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.

Visualizza i dati di analisi di Gemini Enterprise

Puoi visualizzare l'analisi della ricerca per la tua app. Vedrai le metriche relative alle chiamate di ricerca effettuate alla tua app. Se la tua app è collegata a più datastore, ti consigliamo di effettuare chiamate di ricerca all'app specificando la risorsa engine in modo da ottenere risultati da tutti i datastore collegati.

Segui queste istruzioni per visualizzare i dati di analisi relativi 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 i dati di analisi.

  3. Fai clic su Analytics.

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

    • Adozione: metriche sullo stato di adozione da parte 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, Gemini Notebook Enterprise e gli agenti creati e registrati dalla tua organizzazione con Gemini Enterprise.

    • Valore: metriche sui risparmi sui costi ottenuti dagli utenti che eseguono query sui dati con l'app.

    • Livello utente: le metriche includono gli ID utente (indirizzo email o identificatore univoco) degli utenti dell'organizzazione e le loro interazioni con gli agenti creati da Google e con gli agenti 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 della metrica e poi fai clic sul pulsante Aggiorna per applicarli.

Definizioni delle metriche

La tabella seguente descrive come vengono definite le metriche.

Gruppo di metriche Nome metrica Definizione delle metriche Note
Adozione Utenti totali Numero di utenti attivi unici di Gemini Enterprise durante l'intervallo di date selezionato. Un utente è considerato attivo se accede e attiva chiamate API, ad esempio quando arriva alla home page. Poiché il conteggio è univoco, un utente che chiama i metodi API dell'assistente, della risposta e della ricerca viene conteggiato una sola volta nel totale.
Assistente chiamate per gli utenti Numero di utenti che hanno chiamato i metodi AssistantService o hanno utilizzato l'assistente per generare risposte.
Risposta alle chiamate degli utenti Numero di utenti che hanno chiamato i metodi ConversationalSearchService e GenerativeSearchAnswerService per generare risposte.
Utenti che chiamano la ricerca Numero di utenti che hanno chiamato i metodi SearchService per ottenere i risultati di ricerca.
Utenti che chiamano altri metodi API Numero di utenti che hanno chiamato metodi API diversi da streamAssist, streamAnswer e engines.servingConfigs.search. Ad esempio, gli utenti che chiamano i metodi API di autenticazione.
Utenti attivi giornalieri Numero di utenti attivi al giorno Un utente è considerato attivo se accede e attiva chiamate API, ad esempio quando arriva alla home page.
Utenti attivi settimanali Numero di utenti attivi alla settimana. La settimana inizia di lunedì e termina di domenica.
Utenti attivi ogni mese Numero di utenti attivi al mese
Tasso di fidelizzazione dopo 7 giorni Numero di utenti di ritorno nel periodo di 7 giorni corrente / numero di 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 negli ultimi 7 giorni La differenza percentuale tra il numero di utenti attivi nel periodo di sette giorni corrente e nel periodo di sette giorni precedente
Tasso di abbandono in 7 giorni Numero di utenti che hanno abbandonato l'app nel periodo di 7 giorni corrente / numero di utenti attivi nel periodo di 7 giorni precedente Un utente viene considerato abbandonato se era attivo nel periodo di 7 giorni precedente, ma non lo è nel periodo di 7 giorni corrente.
Tasso di fidelizzazione dopo 28 giorni Numero di utenti di ritorno nel periodo di 28 giorni corrente / numero di utenti attivi nel periodo di 28 giorni precedente
Tasso di crescita a 28 giorni La differenza percentuale tra il numero di utenti attivi nel periodo di 28 giorni corrente e nel periodo di 28 giorni precedente
Tasso di abbandono a 28 giorni Numero di utenti che hanno abbandonato l'app nel periodo di 28 giorni corrente / numero di utenti attivi nel periodo di 28 giorni precedente
Utenze acquistate Il numero di licenze (utenze) acquistate dall'organizzazione Include tutte le utenze acquistate dalla registrazione a Gemini Enterprise.
Posti richiesti Il numero di licenze utente assegnate e accettate da persone all'interno della tua organizzazione Include tutte le utenze richieste dalla registrazione a Gemini Enterprise.
Utilizzo e qualità Numero di ricerche Il numero totale di query di ricerca degli utenti in Gemini Enterprise.
Numero di risposte Il numero totale di volte in cui Gemini Enterprise ha generato una risposta alla query di un utente. Le risposte generate da un agente non sono incluse in questo conteggio.
Conteggio azioni Interazioni totali, come il caricamento di file, la creazione di cartelle o l'utilizzo di azioni del connettore in Gemini Enterprise. Include azioni come la creazione di un modello di email.
Percentuale di clic (CTR) per ricerca Numero totale di clic di ricerca / numero di ricerche I clic di 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 dei feedback Numero di Mi piace e 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 feedback negativo Percentuale dei motivi per cui non piace Quando un utente non gradisce una risposta generata, può selezionare più motivi per spiegare il suo giudizio. La percentuale indica la frequenza con cui è stato selezionato ciascun motivo.
Tasso di ricerche riuscite Numero di ricerche riuscite / numero di ricerche
Tasso di risposte riuscite Numero di risposte riuscite / numero di risposte
Agenti Utenti agenti attivi mensili Il numero totale di utenti attivi che hanno utilizzato l'agente al mese. Un utente viene conteggiato come attivo per un agente ogni volta che effettua una chiamata dell'assistente a quell'agente in modalità agente, ricerca o idea forge. Sono incluse le attività del creator dell'agente durante le anteprime o i test in Workflow Builder, perché queste azioni generano chiamate regolari dell'assistente con l'ID dell'agente, simili a qualsiasi interazione dell'utente finale. Solo le interazioni con bozze non salvate a cui non è stato assegnato un ID agente sono escluse da questo conteggio.
Sessioni di chat con l'agente mensili Numero totale di sessioni di chat avviate dagli utenti che interagiscono con un agente specifico al mese. Una sessione di chat è definita come un utente che interagisce 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. Le sessioni di anteprima e di test avviate da Workflow Builder vengono conteggiate perché seguono lo stesso percorso dell'API Assistant delle sessioni degli utenti finali e ricevono un ID sessione.
Agenti utilizzati mensilmente Numero totale di agenti che hanno avuto almeno un utente attivo al mese. Utilizza la stessa definizione di utente attivo di Utenti attivi mensili dell'agente.
Sessioni di chat totali mensili Numero totale di sessioni di chat avviate dagli utenti che interagiscono con gli agenti al mese. Una sessione di chat è definita come un utente che interagisce 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. Le sessioni di anteprima e di test avviate da Workflow Builder vengono conteggiate perché seguono lo stesso percorso dell'API Assistant delle sessioni degli utenti finali e ricevono un ID sessione.
Agenti mensili creati Numero totale di agenti creati nell'ultimo mese di calendario.
Nome agente Il nome visualizzato dell'agente, mostrato nella colonna Nome agente della Classifica accanto all'ID agente nella colonna ID agente. Se un agente è stato rinominato, la classifica mostra il nome visualizzato più recente. Se non è disponibile un nome visualizzato per un agente, la colonna Nome agente mostra l'ID agente.
Utenti attivi giornalieri di Gemini Notebook Enterprise Numero di utenti attivi di Gemini Notebook Enterprise al giorno. Le metriche di Gemini Notebook Enterprise vengono calcolate a livello di progetto e non per motore.
Notebook giornalieri di Gemini Notebook Enterprise creati Numero di notebook Gemini Notebook Enterprise creati al giorno. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Notebook giornalieri di Gemini Notebook Enterprise creati per utente Numero di notebook Gemini Notebook Enterprise creati per utente al giorno. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Notebook giornalieri di Gemini Notebook Enterprise condivisi Numero di notebook Gemini Notebook Enterprise condivisi al giorno. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Overview audio giornaliere create in Gemini Notebook Enterprise Numero di overview audio di Gemini Notebook Enterprise create al giorno. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Utenti attivi mensili di Gemini Notebook Enterprise Numero di utenti attivi di Gemini Notebook Enterprise al mese. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Notebook mensili creati in Gemini Notebook Enterprise Numero di notebook Gemini Notebook Enterprise creati al mese. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Notebook mensili di Gemini Notebook Enterprise creati per utente Numero medio di notebook Gemini Notebook Enterprise creati per utente al mese. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Notebook mensili di Gemini Notebook Enterprise condivisi Numero di notebook Gemini Notebook Enterprise condivisi al mese. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Overview audio mensili di Gemini Notebook Enterprise create Numero di overview audio di Gemini Notebook Enterprise create al mese. Le metriche di Gemini Notebook Enterprise vengono calcolate per l'intero progetto e non per motore.
Valore
(anteprima pubblica)
Ricerca riuscita Numero di 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 che venga avviata una nuova ricerca.
  • Se la risposta di una ricerca include un risultato di ricerca di persone e non è seguita da un'altra ricerca entro due minuti. Questo perché i risultati di ricerca di persone vengono visualizzati nella pagina dei risultati di ricerca e in genere non richiedono un clic.
Risposta corretta Numero di risposte corrette Il successo di una risposta è determinato dal comportamento dell'utente dopo la sua generazione. Il successo viene 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 query entro 30 secondi, si presume che la query sia andata a buon fine.
Ore di lavoro dei dipendenti risparmiate per le date selezionate (Numero di ricerche riuscite + Numero di risposte riuscite) x Minuti risparmiati per risposta riuscita
Valore salvato per le date selezionate Ore risparmiate nelle date selezionate ✕ Tariffa oraria media dei dipendenti Per visualizzare questa metrica, nella scheda Valore, specifica una tariffa oraria per il campo Tariffa oraria dipendente.
Ore di lavoro annuali risparmiate previste per i dipendenti (Numero di ricerche riuscite + Numero di risposte riuscite) x Minuti risparmiati per ricerca riuscita Il numero di ricerche riuscite annuali previste viene calcolato in base al numero di ricerche riuscite nell'intervallo di date scelto. Si stima che ogni query consenta di risparmiare tre minuti, una stima basata su ricerche interne di Google.
Valore annuale risparmiato previsto Ore annuali previste risparmiate dai dipendenti ✕ Tariffa oraria media dei dipendenti Per visualizzare questa metrica, nella scheda Valore, specifica una tariffa oraria per il campo Tariffa oraria dipendente.
Livello utente
ID utente L'indirizzo email di ogni utente della tua organizzazione. Se l'indirizzo email non è disponibile, viene visualizzato l'identificatore univoco originale dell'utente.
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 inviati da un utente 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 richiesti.

  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 avere il nome del set di dati.

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

        Località multiregionale dell'app Gemini Enterprise Località multiregionale di BigQuery
        Globale US (più regioni negli Stati Uniti)
        US (più regioni negli Stati Uniti) US (più regioni negli Stati Uniti)
        EU (più regioni nell'Unione Europea) EU (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. Il nome della tabella è necessario per esportare le metriche tramite l'API.
    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 località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multi-regione UE
      • global per la località globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la località multiregionale del datastore: global, us o eu
    • PROJECT_ID: l'ID del tuo progetto Google Cloud .
    • 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 Explorer 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 località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multi-regione UE
      • global per la località globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la località multiregionale del datastore: global, us o eu
    • APP_ID: l'ID dell'app di cui vuoi ottenere 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.