Esportare le metriche di analisi in BigQuery

Questa pagina descrive come esportare le metriche di analisi di Vertex AI Search per il retail in BigQuery. L'esportazione delle metriche di analisi ti consente di conservare le metriche e scrivere SQL per le tue analisi.

Le metriche di analisi di Vertex AI Search per il retail vengono generate automaticamente. Per ulteriori informazioni su come misurare l'impatto commerciale di Vertex AI Search for Retail con le metriche di analisi, consulta Visualizzare i dati e le analisi.

L'esportazione dei dati delle metriche in BigQuery presenta le seguenti limitazioni:

  • I dati esportati nelle tabelle BigQuery del progetto Vertex AI Search per la vendita al dettaglio sono visualizzazioni autorizzate, non visualizzazioni materializzate.

  • Non puoi modificare o aggiornare i dati in queste tabelle. Se devi modificare o aggiornare i dati, esporta o copia la visualizzazione in un'altra destinazione.

  • Non puoi esportare le metriche relative agli eventi utente che risalgono a più di 180 giorni fa o le metriche generate più di 180 giorni fa. Le metriche generate prima del periodo di 180 giorni non sono recuperabili.

Prima di iniziare

Prima di poter esportare le metriche in BigQuery, devi aver completato le procedure descritte in Prima di iniziare. Ciò include l'importazione degli eventi utente e, facoltativamente, delle informazioni del catalogo.

Per ulteriori informazioni sull'importazione, vedi:

Creare un set di dati in BigQuery

Devi creare un set di dati in BigQuery per contenere i dati delle metriche di analisi.

Devi creare i set di dati nello stesso progetto in cui hai implementato Vertex AI Search per la vendita al dettaglio.

  1. Se non hai mai utilizzato BigQuery nel tuo progetto, abilita l'API BigQuery e assicurati di disporre del ruolo IAM che ti consente di creare set di dati e tabelle.

    Consulta Prima di iniziare e Controllo dell'accesso con IAM

    nella documentazione di BigQuery.

  2. Crea un set di dati in BigQuery nella regione multipla US (più regioni negli Stati Uniti). Ad esempio, retail_data. Se crei il set di dati in una regione diversa, l'esportazione dei dati in BigQuery non va a buon fine. CMEK per il set di dati non è supportato. La sua attivazione causa il fallimento dell'esportazione.

    Per informazioni sulla creazione di un set di dati, consulta Creare set di dati nella documentazione di BigQuery.

    Questo set di dati verrà utilizzato per contenere le tabelle di dati che esporti. Le seguenti procedure descrivono come eseguire l'esportazione.

Esportare le metriche di analisi in una tabella BigQuery

Utilizza il metodo exportAnalyticsMetrics per esportare il tuo catalogo di vendita al dettaglio in una tabella BigQuery.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID del progetto dell'API Vertex AI Search per la vendita al dettaglio in cui hai creato il set di dati BigQuery.
  • DATASET_ID: il nome del set di dati che hai creato in Crea un set di dati in BigQuery. Ad esempio, utilizza retail_data o retail_metrics_data.
  • TABLE_ID_PREFIX: un prefisso per l'ID tabella. Questo prefisso non può essere una stringa vuota. Viene aggiunto un suffisso di retail_analytics_metrics per completare il nome della tabella. Ad esempio, se il prefisso è test, la tabella si chiama test_retail_analytics_metrics.

Corpo JSON della richiesta: 

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

Definizioni delle metriche

Le metriche esportate sono le metriche di conteggio. Potrebbe verificarsi un leggero slittamento per alcune metriche di conteggio perché il filtro dei bot potrebbe escludere alcuni eventi dal calcolo delle metriche. Il filtro dei bot può contribuire a fornire misurazioni del rendimento più accurate. Ciò non influisce sui test A/B, che dipendono dalla dimensioneexternal_experiment_ids, mentre il filtro dei bot viene applicato a tutto il traffico.

Dimensioni delle metriche

Le metriche di conteggio sono i conteggi non elaborati aggregati direttamente dagli eventi utente pertinenti con le stesse dimensioni. Per interpretare le metriche, devi sapere su quali le dimensioni si basano. Ai fini delle metriche di analisi, gli eventi di ricerca e di navigazione sono definiti eventi di impressione, mentre gli eventi detail_page_view, add_to_cart e purchase sono definiti eventi di conversione. La tabella seguente definisce le dimensioni delle metriche.

Dimensione metrica Descrizione
data

La data degli eventi pertinenti che hanno generato le metriche.

Per le metriche sulle impressioni, si tratta della data degli eventi di impressione.

Per le metriche relative a sessioni e visitatori, si tratta della data dell'evento della prima impressione della sessione/del visitatore.
external_experiment_ids

Gli ID esperimento degli eventi pertinenti che hanno generato le metriche.

Per le metriche sulle impressioni, si tratta dell'ID esperimento dell'evento di impressione.

Per le metriche relative a sessioni e visitatori, si tratta della concatenazione degli ID esperimento esterni univoci di tutti gli eventi di impressione visualizzati all'interno della sessione/del visitatore. Ad esempio, se in una sessione/in un visitatore sono presenti due eventi di ricerca, il primo evento di ricerca ha external_experiment_ids "test_arm_1,test_arm_2" e il secondo evento di ricerca ha external_experiment_ids "test_arm_1,test_arm_3", quindi external_experiment_ids della sessione/del visitatore è "test_arm_1,test_arm_2,test_arm_3"
device_type

Il tipo di dispositivo degli eventi pertinenti che hanno generato le metriche, ad esempio se l'evento viene generato da un dispositivo mobile o desktop.

Per le metriche sulle impressioni, si tratta del tipo di dispositivo dell'evento di impressione.

Per le metriche relative a sessioni e visitatori, questo valore è vuoto se la sessione/il visitatore ha più di un tipo di dispositivo distinto o se esiste un solo tipo di dispositivo per l'intera sessione/per il visitatore.
serving_config

La configurazione di pubblicazione degli eventi pertinenti che hanno generato le metriche.

Per le metriche sulle impressioni, si tratta della configurazione di pubblicazione dell'evento Impressione.

Per le metriche relative a sessioni e visitatori, questo valore è vuoto se la sessione/il visitatore ha più di una configurazione di pubblicazione distinta o se esiste una sola configurazione di pubblicazione per l'intera sessione/per il visitatore.
traffic_destination

La sorgente degli eventi pertinenti che hanno generato le metriche.

Per le metriche sulle impressioni, il valore è "Google" se l'impressione viene pubblicata da Google o "Non Google" se l'impressione viene pubblicata dalla tua soluzione.

Per le metriche relative alle sessioni e ai visitatori, il valore è "Misto" se la sessione/il visitatore ha sia eventi impressioni pubblicati da Google sia dalla tua soluzione. "Google" se gli eventi impressioni vengono pubblicati esclusivamente da Google o "Non Google" se gli eventi impressioni vengono pubblicati esclusivamente dalla tua soluzione per l'intera sessione/per il visitatore.
entità

Viene utilizzato dai rivenditori che pubblicano più siti o regioni di brand con un unico catalogo di prodotti. L'entità in genere rappresenta i brand o le sedi.

Per le metriche sulle impressioni, si tratta dell'entità dell'evento impressione.

Per le metriche relative a sessioni e visitatori, si tratta delle cinque entità conteggiate più importanti degli eventi impressione per la sessione/il visitatore.

Metriche sulle impressioni

Le metriche sulle impressioni vengono calcolate in base ai prerequisiti. Gli eventi di conversione (eventi detail_page_view, add_to_cart e purchase) possono essere attribuiti a un evento di impressione solo se soddisfano i seguenti criteri.

  • L'evento impressione e l'evento di conversione hanno lo stesso visitatore.

  • L'ID prodotto dell'evento di conversione deve essere visualizzato nei risultati dell'evento impressione.

  • L'evento di conversione rientra nella finestra temporale richiesta dopo l'evento impressione. A seconda del tipo di evento di conversione, vengono applicate finestre di tempo di conversione diverse.

    Percorso di conversione Finestra di tempo di conversione
    Impressione -> Visualizzazione pagina dei dettagli 60 secondi
    Impressione -> Aggiungi al carrello 24 ore
    Impressione -> Acquisto 48 ore

Metriche sulle impressioni della rete di ricerca

Nome metrica Descrizione
search_event Conteggio eventi di ricerca
detail_page_view_from_search Conteggio eventi di visualizzazione di pagina dei dettagli dalla ricerca
add_to_cart_unit_from_search Conteggio delle unità aggiunte al carrello dalla ricerca
purchase_unit_from_search Conteggio delle unità di acquisto dalla ricerca
revenue_from_search Entrate generate dalla rete di ricerca
search_event_without_result Conteggio eventi di ricerca che non restituisce risultati
search_request_personalization_enabled Conteggio delle richieste di ricerca con la personalizzazione attivata
search_request_personalization_result_served Conteggio delle richieste di ricerca a cui vengono mostrati risultati personalizzati

Sfogliare le metriche sulle impressioni

Nome metrica Descrizione
browse_event Conteggio eventi di navigazione
detail_page_view_from_browse Conteggio eventi di visualizzazione pagina dei dettagli dalla navigazione
add_to_cart_unit_from_browse Conteggio delle unità aggiunte al carrello dalla navigazione
purchase_unit_from_browse Conteggio delle unità di acquisto dalla visualizzazione
revenue_from_browse Entrate generate dalla navigazione
browse_event_without_result Conteggio eventi di navigazione che non restituisce risultati
browse_request_personalization_enabled Conteggio delle richieste di consultazione con la personalizzazione abilitata
browse_request_personalization_result_served Conteggio delle richieste di navigazione pubblicate con risultati personalizzati

Metriche sulle sessioni

Una sessione è definita come un periodo continuo di interazione tra un utente e il sistema. Qualsiasi evento utente indica l'inizio di una sessione e la fine di una sessione viene contrassegnata quando non si verificano altri eventi nei 30 minuti successivi. La sessione viene estesa di altri 30 minuti ogni volta che si verifica un evento utente all'interno di una sessione avviata. Al termine di una sessione, ne inizia una nuova quando l'utente interagisce di nuovo con il sistema.

Le dimensioni che caratterizzano le metriche delle sessioni sono definite congiuntamente da tutti gli eventi utente all'interno della sessione. Fai riferimento a metrics dimensions per informazioni su come vengono impostati i valori delle dimensioni per la sessione.

Nome metrica Descrizione
sessione Conteggio sessioni

Metriche sulle sessioni di ricerca

Una sessione di ricerca è una sessione contenente almeno un evento di ricerca. Tieni presente che una sessione di ricerca può essere anche una sessione di navigazione, come definito dalle metriche di sessione di navigazione.

Nome metrica Descrizione
search_session Numero di sessioni che hanno coinvolto una ricerca
search_event_in_search_session Conteggio eventi di ricerca all'interno delle sessioni di ricerca
browse_event_in_search_session Esplorare il conteggio degli eventi nelle sessioni di ricerca
detail_page_view_in_search_session Conteggio delle visualizzazioni di pagine dei dettagli all'interno delle sessioni di ricerca
add_to_cart_in_search_session Conteggio degli eventi di aggiunta al carrello nelle sessioni di ricerca
add_to_cart_unit_in_search_session Conteggio delle unità aggiunte al carrello nelle sessioni di ricerca
purchase_order_in_search_session Numero di ordini di acquisto nelle sessioni di ricerca
purchase_unit_in_search_session Conteggio delle unità di acquisto all'interno delle sessioni di ricerca
revenue_in_search_session Entrate generate dalle sessioni di ricerca
bounce_count_in_search_session Conteggio delle sessioni del visitatore che esce dal sito dopo aver visualizzato una sola pagina all'interno delle sessioni di ricerca

Sfogliare le metriche relative alle sessioni

Una sessione di navigazione è una sessione che contiene almeno un evento di navigazione. Tieni presente che una sessione di navigazione può essere anche una sessione di ricerca, come definito dalle metriche delle sessioni di ricerca.

Nome metrica Descrizione
browse_session Conteggio delle sessioni che includono la navigazione
search_event_in_browse_session Conteggio eventi di ricerca nelle sessioni di navigazione
browse_event_in_browse_session Conteggio eventi di navigazione all'interno delle sessioni di navigazione
detail_page_view_in_browse_session Conteggio delle visualizzazioni di pagina dei dettagli all'interno delle sessioni di navigazione
add_to_cart_in_browse_session Conteggio degli eventi Aggiungi al carrello nelle sessioni di navigazione
add_to_cart_unit_in_browse_session Conteggio delle unità aggiunte al carrello nelle sessioni di navigazione
purchase_order_in_browse_session Conteggio degli ordini di acquisto nelle sessioni di navigazione
purchase_unit_in_browse_session Conteggio delle unità di acquisto nelle sessioni di navigazione
revenue_in_browse_session Entrate generate dalle sessioni di navigazione
bounce_count_in_browse_session Numero di sessioni del visitatore che esce dal sito dopo aver visualizzato una sola pagina all'interno delle sessioni di navigazione

Metriche sui visitatori

Un visitatore viene identificato in modo univoco dall'ID visitatore. Le metriche sui visitatori aggregano tutte le informazioni sugli eventi utente per il visitatore.

Le dimensioni che caratterizzano le metriche dei visitatori sono definite congiuntamente da tutti gli eventi utente per il visitatore. Consulta le dimensioni delle metriche per informazioni su come vengono impostati i valori delle dimensioni per il visitatore.

Nome metrica Descrizione
visitatore Numero di visitatori

Metriche sui visitatori della rete di ricerca

Un visitatore della rete di ricerca è un visitatore che esegue almeno un evento di ricerca. Tieni presente che un visitatore proveniente da ricerca può essere anche un visitatore di passaggio, come definito dalle metriche relative ai visitatori di passaggio.

Nome metrica Descrizione
search_visitor Numero di visitatori che eseguono almeno una ricerca
search_event_from_search_visitor Conteggio eventi di ricerca da visitatori con ricerche
browse_event_from_search_visitor Visualizza il conteggio degli eventi dei visitatori provenienti dalla rete di ricerca
detail_page_view_from_search_visitor Conteggio delle visualizzazioni di pagine dei dettagli da parte dei visitatori provenienti dalla rete di ricerca
add_to_cart_from_search_visitor Conteggio degli eventi di aggiunta al carrello provenienti dai visitatori della rete di ricerca
add_to_cart_unit_from_search_visitor Conteggio delle unità aggiunte al carrello dai visitatori provenienti dalla rete di ricerca
purchase_order_from_search_visitor Conteggio degli ordini di acquisto provenienti dai visitatori della rete di ricerca
purchase_unit_from_search_visitor Unità di conteggio degli acquisti dai visitatori della rete di ricerca
revenue_from_search_visitor Entrate generate dai visitatori provenienti dalla rete di ricerca

Sfogliare le metriche sui visitatori

Un visitatore che effettua una ricerca è un visitatore che esegue almeno un evento di ricerca. Tieni presente che un visitatore di navigazione può essere anche un visitatore di ricerca, come definito dalle metriche dei visitatori di ricerca.

Nome metrica Descrizione
browse_visitor Numero di visitatori che eseguono almeno una ricerca
search_event_from_browse_visitor Conteggio eventi di ricerca da visitatori che effettuano ricerche
browse_event_from_browse_visitor Conteggio eventi di navigazione dai visitatori che effettuano una ricerca
detail_page_view_from_browse_visitor Conteggio delle visualizzazioni di pagina dei dettagli dei visitatori con navigazione
add_to_cart_from_browse_visitor Conteggio degli eventi Aggiungi al carrello dai visitatori che hanno eseguito una ricerca
add_to_cart_unit_from_browse_visitor Conteggio delle unità aggiunte al carrello da parte dei visitatori che hanno effettuato una ricerca
purchase_order_from_browse_visitor Conteggio degli ordini di acquisto provenienti dai visitatori che hanno effettuato una ricerca
purchase_unit_from_browse_visitor Conteggio delle unità di acquisto dai visitatori che effettuano una ricerca
revenue_from_browse_visitor Entrate generate dai visitatori che effettuano una ricerca

Esempio di utilizzo

Se copi o esporti i dati delle metriche in un'altra destinazione, puoi utilizzare SQL per ottenere informazioni generali o specifiche sulle metriche esportate. Alcune metodi comuni per esplorare le metriche esportate utilizzando SQL sono riportate nelle sezioni seguenti.

Calcolare la percentuale di clic (CTR)

Calcola il CTR per la ricerca per data, per tipo di dispositivo e per destinazione del traffico.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

Ottenere il conteggio delle visualizzazioni di pagine dei dettagli basate sulla navigazione

Visualizza gli eventi di visualizzazione di pagina dettagliati provenienti dagli eventi di navigazione per il traffico Google con external_experiment_ids contenente test_arm e visualizza tutte le informazioni sulle dimensioni. external_experiment_ids è ripetuto string.

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

Ottenere le configurazioni di pubblicazione più utilizzate

Ottieni le configurazioni di pubblicazione più utilizzate tra il giorno 1° ottobre 2023 e il giorno 1° novembre 2023 per il traffico Google. A ogni evento di ricerca deve essere associata una configurazione di pubblicazione.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count