Visualizza analisi

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

Analytics ti offre informazioni dettagliate sulle tendenze di utilizzo, sulla qualità della ricerca e dei suggerimenti e sul coinvolgimento degli utenti finali della tua app. La console AI Applications 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 per intervallo di date e 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 per intervallo di date, query e 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 circa ogni sei ore, pertanto potrebbero essere necessarie diverse ore prima di poter utilizzare la pagina Analytics dopo aver creato l'app.

Origini dati per l'analisi

Questa sezione descrive le origini dati per l'analisi a seconda del tipo di app.

Devi completare l'integrazione degli eventi utente per poter visualizzare le relative analisi.

Gli eventi utente che carichi influiscono sulle analisi generate.

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

• Eventi di visualizzazione articolo. Obbligatorio per la percentuale di clic.
• Eventi di completamento dei contenuti multimediali. Obbligatorio per il tasso di completamento per riproduzione e il tasso di completamento per consiglio.
• Eventi di riproduzione multimediale. Obbligatorio per il conteggio delle riproduzioni dei contenuti multimediali consigliati, percentuale di riproduzione, percentuale di completamento per riproduzione e tempo di visualizzazione medio per riproduzione.

Le app di ricerca richiedono i seguenti eventi utente per visualizzare alcune 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 elementi) attribuibili a Vertex AI Search includendo l'elemento 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 Vertex AI Search 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. Questo è necessario per identificare se una ricerca viene gestita dall'API. Per il calcolo delle 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 per 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 alle applicazioni AI 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 ancora presenti log di ricerca o eventi utente, vengono visualizzati i valori predefiniti per tutte le metriche.

Visualizzare le analisi dei consigli sui contenuti multimediali

Segui queste istruzioni per visualizzare le analisi per i consigli sui contenuti multimediali.

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

   Applicazioni di AI

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

3. Fai clic su Analytics.

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 sono state eseguite le query.

Visualizzare i dati e le analisi della ricerca

Segui queste istruzioni per visualizzare le analisi per le app di ricerca.

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

   Applicazioni di AI

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:

   • 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 mostrate insieme a quelle 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 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 la query di ricerca. Disponibile per le metriche Per ricerca e Confronto.
   • Tipo di dispositivo. Seleziona un tipo di dispositivo su cui sono state eseguite le query.

   Per le app di ricerca di servizi sanitari, 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 data corrisponde al giorno 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 la query di ricerca.
   • Località dell'utente. Seleziona la posizione dell'ospedale, della clinica o del fornitore di servizi sanitari impostato 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 ospedaliero, ambulatoriale o ibrido. Questo filtro è disponibile solo se è stato impostato nella richiesta di ricerca.

Definizioni delle metriche

Le seguenti tabelle descrivono la definizione delle metriche.

Metriche dei suggerimenti sui contenuti multimediali

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

Metriche personalizzate e relative ai contenuti multimediali

Nome metrica	Definizione delle metriche	Note
Conteggio delle ricerche	Conteggio degli eventi di ricerca	In base ai log di ricerca.
Tasso di nessun risultato	Conteggio degli eventi di ricerca senza risultati / Conteggio delle ricerche	In base ai log di ricerca.
Percentuale di clic (CTR) per ricerca	Conteggio dei clic sulla ricerca / Conteggio delle ricerche	I clic sulla ricerca sono eventi visualizza articolo che possono essere attribuiti a un precedente evento di ricerca. In base agli eventi utente.
Conteggio di Mi piace e Non mi piace del feedback	Conteggio di Mi piace e Non mi piace	Un record delle risposte ai feedback Mi piace/Non mi piace inviate dagli utenti dell'app.
Suddivisione dei motivi di non gradimento del 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 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 ci sono 30 minuti di inattività, la sessione termina. In base ai log di ricerca.
Visualizzazione di pagina per visita di ricerca	Conteggio degli eventi visualizza_elemento 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 a Vertex AI Search. In base agli eventi utente.
Frequenza di rimbalzo	Numero di rimbalzi nelle sessioni di ricerca / Numero di sessioni di ricerca	Un rimbalzo della sessione di ricerca è definito come una sessione con una sola ricerca, in cui l'utente ha abbandonato la pagina dopo aver eseguito una sola ricerca. In base agli eventi utente.

Metriche di ricerca nel settore sanitario

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

Nome metrica	Definizione delle metriche	Note
Conteggio delle ricerche	Numero di eventi di ricerca
Nessun conteggio dei risultati	Numero di eventi di ricerca senza risultati
Tasso 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 ricerche	Questi dati vengono deduplicati per utente della 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.
Numero di sessioni di ricerca dei clienti	Numero di sessioni definite dall'utente	Puoi inviare un ID sessione nella tua ricerca. Per ulteriori informazioni, vedi session.
Cerca conteggio visitatori	Numero di utenti che hanno inviato una richiesta di ricerca	Gli utenti vengono conteggiati in base al campo userInfo.
Conteggio sessioni di ricerca sintetica	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 ci sono 30 minuti di inattività, la sessione termina.

Disattivare i dati e le analisi

Non puoi disattivare Analytics per un'app esistente, ma quando crei un'app puoi scegliere di crearla con Analytics disattivato.

Per creare un'app di ricerca che non raccolga dati di 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à dati di analisi della ricerca.