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 aziendale Vertex AI Search for Retail con metriche di analisi, consulta Visualizzare dati e 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. Qualsiasi metrica generata prima della finestra 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. Questo include l'importazione degli eventi utente e, facoltativamente, del catalogo informazioni.
Per ulteriori informazioni sull'importazione, vedi:
- Importare le informazioni del catalogo
- Registrare eventi utente in tempo reale
- Importare la cronologia degli eventi utente
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 i set di dati Vertex AI Search for Retail.
Se non hai utilizzato BigQuery abilitare l'API BigQuery e assicurarti che disponi 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.
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. La 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, usa
retail_data
oretail_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 denominatatest_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 del primo evento di impressione della sessione/visitatore. |
external_experiment_ids |
Gli ID esperimento degli eventi pertinenti che hanno generato le metriche. Per le metriche relative alle impressioni, si tratta dell'ID esperimento dell'evento 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", mentre 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 a sessioni e visitatori, questo valore è "Misto". se la sessione/il visitatore ha entrambi gli eventi di impressione pubblicati sia da Google che 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 prime cinque entità conteggiate degli eventi di 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 -> Acquista 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 degli 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 | Aggiungi al conteggio delle unità del carrello dalla navigazione |
purchase_unit_from_browse | Conteggio 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. Consulta le metriche dimensioni come vengono impostati i valori delle dimensioni durante la sessione.
Nome metrica | Descrizione |
---|---|
sessione | Conteggio sessioni |
Cerca metriche della sessione
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 | Numero 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 della sessione
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 degli eventi di navigazione all'interno delle sessioni di consultazione |
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 viene identificato in modo univoco dall'ID visitatore. Aggregazione delle metriche dei visitatori tutte le informazioni sugli eventi utente per il visitatore.
Le dimensioni che caratterizzano le metriche relative ai visitatori sono definite congiuntamente da tutti 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 eventi aggiunti al carrello dai 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 dai visitatori della rete di ricerca |
purchase_unit_from_search_visitor | Unità conteggio 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 dai visitatori durante la navigazione |
browse_event_from_browse_visitor | Conteggio eventi di navigazione dai visitatori della navigazione |
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 dei visitatori che sfogliano le pagine |
add_to_cart_unit_from_browse_visitor | Conteggio unità di aggiunta al carrello dai 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
è 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)
Scopri le configurazioni di pubblicazione più utilizzate
Ottieni le configurazioni di pubblicazione più utilizzate tra il giorno "01/10/2023" e "2023-11-01" della 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