Visualizza le statistiche

Questa pagina descrive come visualizzare i dati e le analisi per le app di ricerca e di suggerimenti.

I dati e le analisi ti forniscono informazioni dettagliate sulle tendenze di utilizzo, sulla qualità della ricerca e dei suggerimenti e sul coinvolgimento degli utenti finali della tua app. La console di ricerca dell'agente offre un'esperienza di dashboard interattiva basata su Looker.

• Per le app di suggerimenti sui contenuti multimediali: anteprima pubblica. Puoi visualizzare le metriche per suggerimento in base agli eventi utente. Puoi filtrare le metriche in base all'intervallo di date e al tipo di dispositivo.
• Per le app di ricerca personalizzata e di ricerca di contenuti multimediali: puoi visualizzare le metriche per ricerca e per sessione di ricerca in base ai log di ricerca e agli eventi utente. Puoi filtrare le metriche in base all'intervallo di date, alla query e al tipo di dispositivo.
• Per le app di ricerca nel settore sanitario: anteprima pubblica. Puoi visualizzare le metriche per ricerca in base ai log di ricerca.

Le metriche vengono aggiornate ogni sei ore circa, quindi potrebbero essere necessarie diverse ore prima di poter utilizzare la pagina Dati e analisi dopo aver creato l'app.

Origini dati per dati e analisi

Questa sezione descrive le origini dati per i dati e le analisi a seconda del tipo di app.

Per poter visualizzare i dati e le analisi degli eventi utente, devi completare l'integrazione degli eventi utente.

Gli eventi utente che carichi influiscono sui dati e sulle analisi generati.

Le app di suggerimenti sui contenuti multimediali richiedono i seguenti eventi utente per visualizzare alcune metriche:

• Eventi di visualizzazione articolo. Obbligatori per la percentuale di clic.
• Eventi di completamento dei contenuti multimediali. Obbligatori per la percentuale di completamento per riproduzione e la percentuale di completamento per suggerimento.
• Eventi di riproduzione dei contenuti multimediali. Obbligatori per il conteggio delle riproduzioni dei contenuti multimediali suggeriti, la percentuale di riproduzione, la percentuale di completamento per riproduzione e il tempo di visualizzazione medio per riproduzione.

Le app di ricerca richiedono i seguenti eventi utente per visualizzare alcune metriche:

• Eventi di ricerca. Obbligatori per la percentuale di clic.
• Eventi di visualizzazione articolo. Obbligatori per la percentuale di clic.

Per alcuni dati e analisi vengono utilizzate anche le seguenti informazioni:

• Impressioni. Puoi fornire le impressioni (visualizzazioni o clic sugli articoli) attribuibili alla ricerca dell'agente includendo l'articolo associato in UserEvent.Documents durante l'acquisizione 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 dalla ricerca dell'agente e restituiti con ogni richiesta di ricerca. Assicurati di includere questo token di attribuzione come UserEvent.attributionToken con tutti gli eventi utente risultanti da una ricerca. È 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.
• User agent. Includi UserInfo.userAgent con gli eventi utente in modo da poter filtrare le metriche degli eventi utente in base al tipo di dispositivo.

Log di ricerca

Le app di ricerca utilizzano i log di ricerca come origini dati per alcune metriche.

I log di ricerca si basano sulle richieste di ricerca. Per consentire alla ricerca dell'agente di identificare le sessioni utente in modo da poter fornire dati e analisi per sessione e risultati di ricerca di qualità superiore, Google consiglia vivamente di impostare il campo facoltativo campo userPseudoId.

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

Visualizzare i dati e le analisi dei suggerimenti sui contenuti multimediali

Nota :i dati e le analisi dei suggerimenti sui contenuti multimediali sono in anteprima pubblica.

Segui queste istruzioni per visualizzare i dati e le analisi dei suggerimenti sui contenuti multimediali.

1. Nella Google Cloud console, vai alla pagina AI Applications.

   AI Applications

2. Fai clic sul nome dell'app di cui vuoi visualizzare i dati e le analisi.

3. Fai clic su Dati e analisi.

4. Per filtrare le metriche, specifica uno dei seguenti filtri e poi fai clic sul pulsante Aggiorna per applicarli:

   • Intervallo di date. Seleziona un intervallo di date preimpostato o, se disponibile, inserisci un intervallo di date personalizzato.
   • Tipo di dispositivo. Seleziona un tipo di dispositivo su cui si sono verificate le query.

Visualizzare i dati e le analisi della ricerca

Note

:
• Per i datastore nelle regioni multiple Stati Uniti ed Europa, la visualizzazione dei dati e delle analisi della ricerca è in anteprima pubblica.
• Poiché la ricerca dell'agente per la ricerca nel settore sanitario fornisce servizi di ricerca solo nella regione multipla Stati Uniti (us), i dati e le analisi per la ricerca nel settore sanitario sono in anteprima pubblica.
• I dati e le analisi della ricerca sono in GA per i datastore globali.

Segui queste istruzioni per visualizzare i dati e le analisi delle app di ricerca.

1. Nella Google Cloud console, vai alla pagina AI Applications.

   AI Applications

2. Fai clic sul nome dell'app di cui vuoi visualizzare i dati e le analisi.

3. Fai clic su Dati e analisi.

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

   • Per ricerca. Le metriche sono raggruppate per ricerche. Per la ricerca nel settore sanitario, questo è l'unico gruppo di metriche disponibile.
   • Per sessione. Le metriche sono raggruppate per sessioni di ricerca.
   • Confronta. Le metriche di base vengono visualizzate insieme alle metriche di un periodo di confronto. Seleziona gli intervalli di date per le metriche di base (un intervallo di tempo precedente) e le metriche di confronto (un intervallo di tempo successivo). Questi intervalli di tempo non possono sovrapporsi.

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

   Per le app di contenuti multimediali e per le app di ricerca personalizzata sono disponibili i seguenti filtri:

   • Intervallo di date. Seleziona un intervallo di date preimpostato o, se disponibile, inserisci un intervallo di date personalizzato.
   • Query di ricerca. Seleziona una condizione e un valore della query di ricerca. Puoi aggiungere più filtri per le query di ricerca. Disponibile per le metriche Per ricerca e Confronta.
   • Tipo di dispositivo. Seleziona un tipo di dispositivo su cui si sono verificate le query.

   Per le app di ricerca nel settore sanitario sono disponibili i seguenti filtri:

   • Intervallo di date. Seleziona un intervallo di date preimpostato o, se disponibile, inserisci un intervallo di date personalizzato. Quando selezioni una data specifica per l'intervallo di date personalizzato, questa è la data in cui è stata eseguita la ricerca nel fuso orario UTC-08:00.
   • Query di ricerca. Seleziona una condizione e un valore della query di ricerca. Puoi aggiungere più filtri per le query di ricerca.
   • Località dell'utente. Seleziona la località dell'ospedale, della clinica o del fornitore di servizi sanitari impostata nella richiesta di ricerca. Questo filtro è disponibile solo se è stato impostato nella richiesta di ricerca.
   • Ruolo utente. Seleziona la categoria di lavoro dell'utente che ha inviato la richiesta di ricerca. Questo filtro è disponibile solo se è stato impostato nella richiesta di ricerca.
   • Impostazione utente. Seleziona l'impostazione sanitaria impostata nella richiesta di ricerca, ad esempio trattamento in regime di ricovero, ambulatoriale o ibrido. Questo filtro è disponibile solo se è stato impostato nella richiesta di ricerca.

Definizioni delle metriche

Le seguenti tabelle descrivono come vengono definite le metriche.

Metriche dei suggerimenti sui contenuti multimediali

Nome metrica	Definizione delle metriche	Note
Conteggio suggerimenti	Numero totale di suggerimenti
Conteggio riproduzioni dei suggerimenti	Numero di volte in cui sono stati riprodotti gli elementi multimediali suggeriti
Conteggio dei clic sui suggerimenti	Numero di volte in cui è stato fatto clic sugli elementi multimediali suggeriti
Percentuale di clic	Conteggio dei clic sui suggerimenti / conteggio suggerimenti	I clic sui suggerimenti sono eventi di visualizzazione articolo che possono essere attribuiti a un suggerimento
Conteggio completamenti dei contenuti multimediali suggeriti	Numero di volte in cui gli elementi multimediali suggeriti sono stati riprodotti fino al completamento
Percentuale di riproduzione per suggerimento	Numero di volte in cui sono stati riprodotti gli elementi multimediali suggeriti / conteggio suggerimenti
Percentuale di completamento per riproduzione	Numero di volte in cui gli elementi multimediali suggeriti sono stati riprodotti fino al completamento / numero di volte in cui sono stati riprodotti gli elementi multimediali
Tempo di visualizzazione medio per riproduzione	Tempo in secondi in cui sono stati riprodotti gli elementi multimediali suggeriti / numero di volte in cui sono stati riprodotti gli elementi multimediali suggeriti
Percentuale di completamento per suggerimento	Numero di volte in cui gli elementi multimediali sono stati riprodotti fino al completamento / conteggio suggerimenti
Tempo di visualizzazione medio per suggerimento	Tempo in secondi in cui sono stati guardati gli elementi multimediali suggeriti / conteggio suggerimenti

Metriche di ricerca personalizzata e di contenuti multimediali

Nome metrica	Definizione delle metriche	Note
Conteggio ricerche	Conteggio degli eventi di ricerca	In base ai log di ricerca.
Percentuale di nessun risultato	Conteggio degli eventi di ricerca senza risultati/conteggio ricerche	In base ai log di ricerca.
Percentuale di clic (CTR) per ricerca	Conteggio dei clic di ricerca/conteggio ricerche	I clic di ricerca sono eventi di visualizzazione articolo che possono essere attribuiti a un evento di ricerca precedente. In base agli eventi utente.
Conteggio Mi piace e Non mi piace del feedback	Conteggio dei Mi piace e dei Non mi piace	Un record delle risposte di feedback Mi piace/Non mi piace inviate dagli utenti dell'app.
Suddivisione dei motivi dei Non mi piace del feedback	Percentuale dei motivi dei Non mi piace	Quando a un utente non piace una risposta generata, può selezionare più motivi per spiegare il perché. La percentuale mostra la frequenza con cui è stato selezionato ogni motivo.
Conteggio sessioni di ricerca	Conteggio delle sessioni di ricerca	Una sessione di ricerca è una sessione utente che contiene almeno un evento di ricerca. Una sessione utente, chiamata anche visita, è un insieme continuo di eventi utente. Quando si verificano 30 minuti di inattività, la sessione termina. In base ai log di ricerca.
Visualizzazioni di pagina per visita di ricerca	Conteggio degli eventi di visualizzazione articolo nelle sessioni di ricerca / conteggio sessioni di ricerca	Questa metrica include tutte le visualizzazioni di pagina nelle visite di ricerca, indipendentemente dal fatto che possano essere attribuite alla ricerca dell'agente. In base agli eventi utente.
Frequenza di rimbalzo	Conteggio dei rimbalzi nelle sessioni di ricerca/conteggio sessioni di ricerca	Un rimbalzo della sessione di ricerca è definito come una sessione con una singola ricerca, in cui l'utente ha abbandonato la sessione dopo aver effettuato una sola ricerca. In base agli eventi utente.

Metriche di ricerca nel settore sanitario

Per le app di ricerca nel settore sanitario sono disponibili le seguenti metriche di ricerca.

Nome metrica	Definizione delle metriche	Note
Conteggio ricerche	Numero di eventi di ricerca
Conteggio nessun risultato	Numero di eventi di ricerca senza risultati
Percentuale di nessun risultato per ricerca	Numero di eventi di ricerca senza risultati per ricerca
Conteggio pazienti	Conteggio degli ID paziente per i quali sono state eseguite le ricerche	Questo valore viene deduplicato per utente di ricerca, ma non per paziente. Ad esempio, se l'utente 1 cerca i pazienti A e B e l'utente 2 cerca solo il paziente B, il conteggio è tre.
Conteggio sessioni di ricerca dei clienti	Numero di sessioni definite dall'utente di ricerca	Puoi inviare un ID sessione nella ricerca. Per saperne di più, consulta session.
Conteggio visitatori di ricerca	Numero di utenti che hanno inviato una richiesta di ricerca	Gli utenti vengono conteggiati in base al userInfo campo.
Conteggio sessioni di ricerca sintetiche	Numero di sessioni di ricerca definite da Google	Una sessione di ricerca è una sessione utente che contiene almeno un evento di ricerca. Una sessione utente, chiamata anche visita, è un insieme continuo di eventi utente. Quando si verificano 30 minuti di inattività, la sessione termina.

Disattivare i dati e le analisi

Non puoi disattivare i dati e le analisi per un'app esistente, ma quando crei un'app puoi scegliere di crearla con i dati e le analisi disattivati.

Per creare un'app di ricerca che non raccolga dati e analisi:

1. Segui le istruzioni REST riportate in Creare un'app di ricerca, aggiungendo quanto segue al comando curl:

      "disableAnalytics": true
   

   Comando di esempio

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   Questo comando crea un'app che non raccoglierà i dati e le analisi della ricerca.