Esporta le metriche di analisi in BigQuery

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

Le metriche di Vertex AI Search for Retail Analytics vengono generate automaticamente per te. 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 Il progetto Vertex AI Search for Retail è viste autorizzate, non viste materializzate.

  • Non puoi modificare o aggiornare i dati in queste tabelle. Se hai bisogno di modificare o aggiornare i dati, esportare o copiare la vista in un'altra destinazione.

  • Non puoi esportare le metriche per eventi utente risalenti a più di 180 giorni fa 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:

crea un set di dati in BigQuery

Devi creare un set di dati in BigQuery per conservare le tue analisi dei dati delle metriche.

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.

    Vedi Prima di iniziare e Controllo dell'accesso con IAM

    nella documentazione di BigQuery.

  2. Crea un set di dati in BigQuery negli Stati Uniti (più regioni in Stati Uniti) multiregionale. Ad esempio, assegnagli il nome retail_data. Se crei il tuo set di dati in una regione diversa, esportando i dati in BigQuery non funziona. CMEK per il set di dati non è supportati; se lo attivi, l'esportazione non riuscirà.

    Per informazioni sulla creazione di un set di dati, consulta la sezione Creazione di 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.

Esporta le metriche di analisi in una tabella BigQuery

Utilizza il metodo exportAnalyticsMetrics per esportare il catalogo di vendita al dettaglio in un Tabella BigQuery.

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

  • PROJECT_ID: l'ID del Progetto API Vertex AI Search for Retail in cui hai creato BigQuery del set di dati.
  • DATASET_ID: il nome del creato in Creare 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. Il suffisso di retail_analytics_metrics è stato aggiunto per completare il nome della tabella. Per Ad esempio, se il prefisso è test, la tabella viene denominata 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 delle seguenti 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. In alcuni casi, si può notare una leggera deviazione conteggia le metriche perché il filtro dei bot potrebbe escludere alcuni eventi dalle metriche calcolo. Il filtro dei bot può aiutare a migliorare il rendimento le misurazioni. Questo non influisce sul test A/B, che dipende dalla dimensione external_experiment_ids, mentre il filtro dei bot viene applicato a tutto il traffico.

Dimensioni metriche

Le metriche di conteggio sono conteggi non elaborati direttamente aggregati dagli eventi utente pertinenti con le stesse dimensioni. Per interpretare le metriche, devi sapere quali dimensioni su cui si basano le metriche. Ai fini delle metriche di analisi, Gli eventi di ricerca e esplorazione sono chiamati eventi relativi alle impressioni. Gli eventi detail_page_view, add_to_cart e purchase sono definiti come eventi di conversione. La tabella seguente definisce le dimensioni delle metriche.

Dimensione metrica Descrizione
data

La data dell'evento o degli eventi pertinenti che hanno generato le metriche.

Per le metriche relative alle impressioni, si tratta della data degli eventi relativi alle impressioni.

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 degli esperimenti esterni univoci di tutti gli eventi relativi alle impressioni visualizzati all'interno della sessione o del visitatore. Ad esempio, se sono presenti due eventi di ricerca in una sessione/un visitatore, 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", poi gli external_experiment_ids della sessione/del visitatore è "test_arm_1,test_arm_1,"test_arm
device_type

Il tipo di dispositivo dell'evento o degli eventi pertinenti che ha generato le metriche, ad esempio se l'evento è stato generato da un dispositivo mobile o computer.

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

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

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

Per le metriche relative alle impressioni, questa è la configurazione di pubblicazione dell'evento di impressione.

Per le metriche di sessione e visitatori, questo campo è vuoto se per la sessione/visitatore sono presenti più configurazioni di pubblicazione distinte o se è presente una sola configurazione di pubblicazione per l'intera sessione/visitatore.
traffic_destination

L'origine degli eventi pertinenti che hanno generato le metriche.

Per le metriche relative alle impressioni, il valore è "Google" se l'impressione è 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 gli eventi di impressione pubblicati da Google sia quelli pubblicati dalla tua soluzione. Questo è "Google" Se gli eventi relativi alle impressioni sono pubblicati esclusivamente da Google o da "Non Google" se gli eventi di impressione sono pubblicati esclusivamente dalla tua soluzione per l'intera sessione/visitatore.
entità

Viene utilizzato dai rivenditori che gestiscono più siti o regioni del brand con un solo catalogo di prodotti. L'entità di solito rappresenta i brand o le sedi.

Per le metriche relative alle impressioni, questa è l'entità dell'evento relativo alle impressioni.

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 delle impressioni

Le metriche relative alle impressioni vengono calcolate in base a dei prerequisiti. Eventi di conversione (detail_page_view, add_to_cart e purchase eventi), può essere attribuito a un evento impressione solo se soddisfano i seguenti criteri.

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

  • L'ID prodotto dell'evento di conversione deve apparire nella che consentono di analizzare i dati e visualizzare i risultati.

  • L'evento di conversione rientra nell'intervallo di tempo richiesto dopo l'occorrenza di l'evento di impressione. Finestre temporali di conversione diverse si applicano a tipi di eventi di conversione.

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

Metriche delle impressioni sulla rete di ricerca

Nome metrica Descrizione
search_event Cerca conteggio eventi
detail_page_view_from_search Conteggio degli eventi di visualizzazione della pagina dei dettagli dalla ricerca
add_to_cart_unit_from_search Conteggio unità Aggiungi al carrello dalla ricerca
purchase_unit_from_search Conteggio unità di acquisto dalla ricerca
revenue_from_search Entrate generate dalla ricerca
search_event_without_result Conteggio eventi di ricerca che non restituisce risultati
search_request_personalization_enabled Numero di richieste di ricerca con personalizzazione abilitata
search_request_personalization_result_served Numero di richieste di ricerca elaborate con risultati personalizzati

Sfoglia le metriche relative alle impressioni

Nome metrica Descrizione
browse_event Conteggio eventi di navigazione
detail_page_view_from_browse Conteggio degli eventi di visualizzazione della 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 navigazione
revenue_from_browse Entrate derivanti dalla navigazione
browse_event_without_result Conteggio degli eventi di navigazione che non restituisce risultati
browse_request_personalization_enabled Numero di richieste di navigazione con personalizzazione abilitata
browse_request_personalization_result_served Numero di richieste di navigazione gestite con risultati personalizzati

Metriche di sessione

Per sessione si intende un periodo continuo di interazione tra un utente e all'interno del sistema. Qualsiasi evento utente segna l'inizio e la fine di una sessione la sessione viene contrassegnata quando non si verifica nessun altro evento per i successivi 30 minuti. La sessione viene estesa di altri 30 minuti ogni volta che un evento utente si verifica all'interno di 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 di sessione sono definite congiuntamente da tutti eventi utente nella 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 che contiene almeno un evento di ricerca. Tieni presente che La sessione di ricerca può anche essere una sessione di navigazione come definita dalla sessione di navigazione metriche.

Nome metrica Descrizione
search_session Numero di sessioni che prevede una ricerca
search_event_in_search_session Conteggio degli eventi di ricerca nelle sessioni di ricerca
browse_event_in_search_session Conteggio degli eventi di navigazione all'interno delle sessioni di ricerca
detail_page_view_in_search_session Conteggio delle visualizzazioni della pagina dei dettagli nelle 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 Conteggio degli ordini di acquisto nelle sessioni di ricerca
purchase_unit_in_search_session Conteggio delle unità di acquisto nelle sessioni di ricerca
revenue_in_search_session Entrate generate dalle sessioni di ricerca
bounce_count_in_search_session Numero di sessioni del visitatore che esce dal sito dopo aver visualizzato solo una pagina nelle sessioni di ricerca

Sfogliare le metriche relative alle sessioni

Una sessione di consultazione è una sessione contenente almeno un evento di consultazione. Tieni presente che La sessione di navigazione può anche essere una sessione di ricerca, come definita dalla sessione di ricerca metriche.

Nome metrica Descrizione
browse_session Numero di sessioni che prevede la navigazione
search_event_in_browse_session Conteggio degli eventi di ricerca all'interno delle 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 della pagina dei dettagli all'interno delle sessioni di navigazione
add_to_cart_in_browse_session Conteggio degli eventi di aggiunta 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 all'interno delle sessioni di navigazione
revenue_in_browse_session Entrate all'interno delle sessioni di navigazione
bounce_count_in_browse_session Conteggio delle sessioni del visitatore che esce dal sito dopo aver visualizzato solo una pagina all'interno delle sessioni di navigazione

Metriche relative ai visitatori

Un visitatore è 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. come vengono impostati i valori delle dimensioni per il visitatore.

Nome metrica Descrizione
visitatore Numero di visitatori

Cerca metriche sui visitatori

Un visitatore di ricerca è un visitatore che esegue almeno un evento di ricerca. Tieni presente che il visitatore della ricerca può anche essere un visitatore della navigazione come definito dal parametro visitatore della navigazione metriche.

Nome metrica Descrizione
search_visitor Numero di visitatori che esegue almeno una ricerca
search_event_from_search_visitor Conteggio eventi di ricerca dai visitatori della rete di ricerca
browse_event_from_search_visitor Conteggio eventi di navigazione dai visitatori della ricerca
detail_page_view_from_search_visitor Conteggio delle visualizzazioni della pagina dei dettagli da parte dei visitatori che fanno ricerche
add_to_cart_from_search_visitor Conteggio degli eventi di aggiunta al carrello dei visitatori della rete di ricerca
add_to_cart_unit_from_search_visitor Conteggio unità Aggiungi al carrello dai visitatori della 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 della rete di ricerca

Sfoglia le metriche dei visitatori

Un visitatore di navigazione è un visitatore che esegue almeno un evento di consultazione. Tieni presente che il visitatore della navigazione può anche essere un visitatore che effettua una ricerca come definito dal visitatore della rete di ricerca metriche.

Nome metrica Descrizione
browse_visitor Numero di visitatori che eseguono almeno una navigazione
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 della pagina dei dettagli da parte dei visitatori della navigazione
add_to_cart_from_browse_visitor Conteggio degli eventi di aggiunta al carrello dai visitatori della pagina di navigazione
add_to_cart_unit_from_browse_visitor Conteggio unità di aggiunta al carrello dei visitatori della navigazione
purchase_order_from_browse_visitor Conteggio degli ordini di acquisto da visitatori della navigazione
purchase_unit_from_browse_visitor Conteggio unità di acquisto dai visitatori della navigazione
revenue_from_browse_visitor Entrate generate dai visitatori della navigazione

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 i modi più comuni per esplorare le metriche esportate utilizzando SQL sono disponibili nel le sezioni seguenti.

Calcola la percentuale di clic (CTR)

Calcola il CTR per la ricerca per data per tipo di dispositivo e destinazione di 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

Ottieni il numero di visualizzazioni della pagina dei dettagli basata sulla navigazione

Visualizza i dettagli degli eventi di visualizzazione di pagina provenienti da eventi di navigazione per il traffico Google con external_experiment_ids con test_arm e mostra tutte le dimensioni informazioni. external_experiment_ids viene 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