Visualizza le statistiche

Questa pagina descrive come visualizzare i dati e le analisi per le tue app di consigli sui contenuti multimediali e di ricerca.

Le analisi ti forniscono informazioni sulle tendenze di utilizzo, sulla qualità della ricerca e dei consigli e sul coinvolgimento degli utenti finali della tua app. La console Vertex AI Agent Builder offre un'esperienza di dashboard interattiva basata su Looker.

• Per le app di suggerimenti sui contenuti multimediali: Anteprima pubblica. Puoi visualizzare le metriche per consiglio 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 generica 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.

Le metriche vengono aggiornate ogni sei ore circa, quindi potrebbero essere necessarie diverse ore prima che tu possa utilizzare la pagina Analytics dopo aver creato l'app.

Origini dati per l'analisi

Questa sezione descrive le origini dati per l'analisi in base al tipo di app.

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

Gli eventi utente che carichi influiscono sugli indicatori generati.

Per visualizzare alcune metriche, le app per suggerimenti sui contenuti multimediali richiedono i seguenti eventi utente:

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

Per visualizzare alcune metriche, le app di ricerca richiedono i seguenti eventi utente:

• 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 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 il token di attribuzione come UserEvent.attributionToken con tutti gli eventi utente derivanti da una ricerca. Questo è necessario per identificare se una ricerca viene eseguita 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 relative agli 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 a Vertex AI Agent Builder 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 mostrati i valori predefiniti per tutte le metriche.

Visualizzare i dati e le analisi dei consigli sui contenuti multimediali

Segui le istruzioni riportate di seguito per visualizzare i dati e le analisi relativi ai consigli sui contenuti multimediali.

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Fai clic sul nome dell'app per cui vuoi visualizzare i dati e 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 di ricerca

Segui le istruzioni riportate di seguito per visualizzare i dati e le analisi per le app di ricerca generica o di ricerca di contenuti multimediali.

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Fai clic sul nome dell'app per cui vuoi visualizzare i dati e 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 sessione. Le metriche sono raggruppate per sessioni di ricerca.
   • Confronta. Le metriche di riferimento vengono mostrate insieme alle metriche di un periodo di confronto. Seleziona gli intervalli di date per le metriche di riferimento (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 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.
   • 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 sono state eseguite le query.

Definizioni delle metriche

Le seguenti tabelle descrivono come vengono definite le metriche.

Metriche relative ai consigli sui contenuti multimediali

Nome metrica	Definizione della metrica	Note
Numero di consigli	Numero totale di consigli
Conteggio dei consigli riprodotti	Numero di volte in cui sono stati riprodotti gli elementi multimediali consigliati
Conteggio dei clic sui consigli	Numero di volte in cui sono stati selezionati tramite clic gli elementi multimediali consigliati
Percentuale di clic	Conteggio dei clic sui consigli / numero di consigli	I clic sui consigli sono eventi di visualizzazione di articoli che possono essere attribuiti a un consiglio
Conteggio dei contenuti multimediali dei consigli 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 / numero di 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 durante il quale sono stati riprodotti gli elementi multimediali consigliati / numero di volte in cui sono stati riprodotti gli elementi multimediali consigliati
Percentuale di completamento per consiglio	Numero di volte in cui gli elementi multimediali sono stati riprodotti fino al completamento / numero di consigli
Tempo di visualizzazione medio per consiglio	Tempo in secondi durante il quale sono stati guardati gli elementi multimediali consigliati / numero di consigli

Metriche di ricerca

Nome metrica	Definizione delle metriche	Note
Numero di ricerche	Conteggio degli eventi di ricerca	In base ai log di ricerca
Nessun tasso di risultati	Conteggio di eventi di ricerca senza risultati/ Conteggio ricerche	In base ai log di ricerca
Percentuale di clic (CTR) per ricerca	Conteggio dei clic sulla rete di ricerca / Conteggio delle ricerche	I clic sulla rete di ricerca sono eventi di visualizzazione di articoli che possono essere attribuiti a un evento di ricerca precedente. In base agli eventi utente
Conteggio delle sessioni di ricerca	Conteggio delle sessioni di ricerca	Una sessione di ricerca è una sessione utente contenente almeno uno evento di ricerca. Una sessione utente, chiamata anche visita, è un insieme continuo di eventi utente. Se passano 30 minuti di inattività, la sessione termina. In base ai log di ricerca
Visualizzazione di pagina per visita della rete di ricerca	Conteggio degli eventi di visualizzazione dell'elemento nelle sessioni di ricerca / Numero di 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 abbandono della sessione di ricerca è definito come una sessione con una singola ricerca in cui l'utente è uscito dopo aver eseguito solo una ricerca. In base agli eventi utente

Disattivare i dati e le analisi

Non puoi disattivare gli analytics per un'app esistente, ma quando ne crei una puoi scegliere di disattivarli.

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

1. Segui le istruzioni REST 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 raccoglie i dati di Dati sulla rete di ricerca.