Questa pagina descrive come esportare le metriche di analisi di Vertex AI Search per il commercio in BigQuery. L'esportazione delle metriche di analisi ti consente di conservare le metriche e scrivere SQL per la tua analisi.
Le metriche di analisi di Vertex AI Search for Commerce vengono generate automaticamente. Per ulteriori informazioni sulla misurazione dell'impatto aziendale di Vertex AI Search for Commerce con le metriche di Analytics, consulta Visualizzare Analytics.
L'esportazione dei dati delle metriche in BigQuery presenta le seguenti limitazioni:
I dati esportati nelle tabelle BigQuery nel tuo progetto Vertex AI Search for commerce sono viste autorizzate, non viste 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 per gli 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:
- Importare le informazioni del catalogo
- Registrare eventi utente in tempo reale
- Importare gli eventi utente storici
Crea un set di dati in BigQuery
Devi creare un set di dati in BigQuery per archiviare i dati delle metriche di analisi.
Devi creare i set di dati nello stesso progetto in cui hai implementato Vertex AI Search for Commerce.
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.
Crea un set di dati in BigQuery nella multiregione US (più regioni negli Stati Uniti). Ad esempio, chiamalo
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; l'attivazione causa l'esportazione non riuscita.Per informazioni sulla creazione di un set di dati, consulta Creazione di set di dati nella documentazione di BigQuery.
Questo set di dati verrà utilizzato per contenere le tabelle di dati che esporti. Le procedure seguenti descrivono come eseguire l'esportazione.
Esportare le metriche di analisi in una tabella BigQuery
Utilizza il metodo exportAnalyticsMetrics per esportare il catalogo Retail 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 for commerce 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_dataoretail_metrics_data. -
TABLE_ID_PREFIX: Un prefisso
per l'ID tabella. Questo prefisso non può essere una stringa vuota. Viene aggiunto un suffisso
retail_analytics_metricsper completare il nome della tabella. Ad esempio, se il prefisso ètest, la tabella si chiamatest_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 esserci una leggera deriva 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 sul test A/B, che dipende dalla dimensione
external_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
dimensioni si basano. Ai fini delle metriche di analisi,
gli eventi di ricerca e navigazione sono denominati eventi impressione, mentre
gli eventi detail_page_view, add_to_cart e purchase sono denominati
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, questa è la data del primo evento impressione della sessione/del visitatore. |
| external_experiment_ids |
Gli ID esperimento degli eventi pertinenti che hanno generato le metriche. Per le metriche sulle impressioni, questo è l'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 impressione visualizzati nella sessione/nel visitatore. Ad esempio, se in una sessione/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", allora external_experiment_ids della sessione/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 è generato da un dispositivo mobile o desktop. Per le metriche sulle impressioni, si tratta del tipo di dispositivo dell'evento impressione. Per le metriche relative a sessioni e visitatori, questo campo è vuoto se la sessione/il visitatore ha più di un tipo di dispositivo distinto oppure è pari a 1 se è presente un solo tipo di dispositivo per l'intera sessione/il visitatore. |
| serving_config |
La configurazione di pubblicazione degli eventi pertinenti che hanno generato le metriche. Per le metriche sulle impressioni, questa è la configurazione di pubblicazione dell'evento di impressione. Per le metriche relative a sessioni e visitatori, questo campo è vuoto se la sessione/il visitatore ha più di una configurazione di pubblicazione distinta oppure contiene il valore 1 se esiste una sola configurazione di pubblicazione per l'intera sessione/il visitatore. |
| traffic_destination |
L'origine 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 a sessioni e visitatori, il valore è "Misto" se la sessione/il visitatore ha eventi impressione pubblicati sia da Google che dalla tua soluzione. "Google" se gli eventi impressione vengono pubblicati esclusivamente da Google o "Non Google" se gli eventi impressione vengono pubblicati esclusivamente dalla tua soluzione per l'intera sessione/visitatore. |
| entità |
Viene utilizzato dai rivenditori che gestiscono più siti o regioni di brand con un unico catalogo 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 prime cinque entità conteggiate degli eventi impressione per la sessione/il visitatore. |
Metriche delle impressioni
Le metriche delle 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 impressione solo se corrispondono ai 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'occorrenza dell'evento impressione. Per i diversi tipi di eventi di conversione vengono applicate finestre temporali di conversione diverse.
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 | Conteggio eventi di ricerca |
| detail_page_view_from_search | Conteggio eventi di visualizzazione della pagina dei dettagli dalla ricerca |
| add_to_cart_unit_from_search | Conteggio unità aggiunte al carrello dalla ricerca |
| purchase_unit_from_search | Numero di unità acquistate dalla ricerca |
| revenue_from_search | Entrate generate dalla ricerca |
| search_event_without_result | Conteggio eventi di ricerca che non restituiscono risultati |
| search_request_personalization_enabled | Conteggio delle richieste di ricerca con la personalizzazione attivata |
| search_request_personalization_result_served | Conteggio delle richieste di ricerca pubblicate con risultati personalizzati |
Sfoglia le metriche delle impressioni
| Nome metrica | Descrizione |
|---|---|
| browse_event | Sfogliare il conteggio degli eventi |
| detail_page_view_from_browse | Conteggio eventi di visualizzazione della pagina dei dettagli dalla navigazione |
| add_to_cart_unit_from_browse | Conteggio unità Aggiungi al carrello dalla navigazione |
| purchase_unit_from_browse | Conteggio delle unità acquistate dalla navigazione |
| revenue_from_browse | Entrate generate dalla navigazione |
| browse_event_without_result | Conteggio eventi di navigazione che non produce risultati |
| browse_request_personalization_enabled | Conteggio delle richieste di navigazione con la personalizzazione abilitata |
| browse_request_personalization_result_served | Conteggio delle richieste di navigazione pubblicate con risultati personalizzati |
Metriche delle sessioni
Una sessione è definita come un periodo continuo di interazione tra un utente e il sistema. Qualsiasi evento utente segna l'inizio di una sessione, mentre la fine di una sessione viene contrassegnata quando non si verifica nessun altro evento per i 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 di sessione sono definite congiuntamente da tutti gli eventi utente all'interno della sessione. Fai riferimento a metriche dimensioni per scoprire come vengono impostati i valori delle dimensioni per la sessione.
| Nome metrica | Descrizione |
|---|---|
| sessione | Conteggio sessioni |
Metriche delle sessioni di ricerca
Una sessione di ricerca è una sessione che contiene almeno un evento di ricerca. Tieni presente che una sessione di ricerca può essere anche una sessione di navigazione, come definita dalle metriche della sessione di navigazione.
| Nome metrica | Descrizione |
|---|---|
| search_session | Numero di sessioni che includono una ricerca |
| search_event_in_search_session | Conteggio eventi di ricerca all'interno delle sessioni di ricerca |
| browse_event_in_search_session | Conteggio eventi di navigazione all'interno delle sessioni di ricerca |
| detail_page_view_in_search_session | Conteggio delle visualizzazioni della pagina dei dettagli all'interno delle sessioni di ricerca |
| add_to_cart_in_search_session | Conteggio degli eventi di aggiunta al carrello all'interno delle sessioni di ricerca |
| add_to_cart_unit_in_search_session | Conteggio delle unità Aggiungi al carrello nelle sessioni di ricerca |
| purchase_order_in_search_session | Conteggio degli ordini di acquisto all'interno delle sessioni di ricerca |
| purchase_unit_in_search_session | Conteggio delle unità di acquisto all'interno delle sessioni di ricerca |
| revenue_in_search_session | Entrate nelle sessioni di ricerca |
| bounce_count_in_search_session | Numero di sessioni del visitatore che esce dal sito dopo aver visualizzato una sola pagina all'interno delle sessioni di ricerca |
Sfoglia 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 sessioni che coinvolgono 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 della pagina dei dettagli all'interno delle sessioni di navigazione |
| add_to_cart_in_browse_session | Conteggio degli eventi Aggiungi al carrello all'interno delle sessioni di navigazione |
| add_to_cart_unit_in_browse_session | Aggiungi al conteggio delle unità del 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à acquistate nelle sessioni di navigazione |
| revenue_in_browse_session | Entrate nelle 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. Fai riferimento alle dimensioni delle metriche per scoprire come vengono impostati i valori delle dimensioni per il visitatore.
| Nome metrica | Descrizione |
|---|---|
| visitatore | Conteggio visitatori |
Metriche sui visitatori con ricerche
Un visitatore della ricerca è un visitatore che esegue almeno un evento di ricerca. Tieni presente che un visitatore della ricerca può essere anche un visitatore della navigazione, come definito dalle metriche dei visitatori della navigazione.
| Nome metrica | Descrizione |
|---|---|
| search_visitor | Conteggio dei visitatori che eseguono almeno una ricerca |
| search_event_from_search_visitor | Conteggio eventi di ricerca dei visitatori che hanno eseguito ricerche |
| browse_event_from_search_visitor | Conteggio eventi di navigazione dei visitatori della ricerca |
| detail_page_view_from_search_visitor | Conteggio delle visualizzazioni della pagina dei dettagli da parte dei visitatori della ricerca |
| add_to_cart_from_search_visitor | Conteggio degli eventi Aggiungi al carrello dei visitatori della ricerca |
| add_to_cart_unit_from_search_visitor | Conteggio unità aggiunte al carrello dai visitatori della ricerca |
| purchase_order_from_search_visitor | Conteggio degli ordini di acquisto dei visitatori della ricerca |
| purchase_unit_from_search_visitor | Unità di conteggio degli acquisti dai visitatori della ricerca |
| revenue_from_search_visitor | Entrate generate dai visitatori della rete di ricerca |
Sfoglia le metriche sui visitatori
Un visitatore di navigazione è un visitatore che esegue almeno un evento di navigazione. Tieni presente che un visitatore di navigazione può essere anche un visitatore di ricerca, come definito dalle metriche relative ai visitatori di ricerca.
| Nome metrica | Descrizione |
|---|---|
| browse_visitor | Conteggio dei visitatori che eseguono almeno una navigazione |
| search_event_from_browse_visitor | Conteggio eventi di ricerca dei visitatori che sfogliano |
| browse_event_from_browse_visitor | Conteggio eventi di navigazione dei visitatori |
| detail_page_view_from_browse_visitor | Conteggio delle visualizzazioni di pagina dei dettagli dei visitatori che navigano |
| add_to_cart_from_browse_visitor | Conteggio degli eventi Aggiungi al carrello dei visitatori che navigano |
| add_to_cart_unit_from_browse_visitor | Conteggio unità aggiunte al carrello dai visitatori della navigazione |
| purchase_order_from_browse_visitor | Conteggio degli ordini di acquisto dei visitatori della navigazione |
| purchase_unit_from_browse_visitor | Conteggio delle unità acquistate dai visitatori della navigazione |
| revenue_from_browse_visitor | Entrate generate dai visitatori che navigano |
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. Alcuni modi comuni per esplorare le metriche esportate utilizzando SQL sono forniti nelle sezioni seguenti.
Calcolare la percentuale di clic (CTR)
Calcola il CTR per la ricerca in base a data, tipo di dispositivo e 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
Visualizzare il conteggio delle visualizzazioni della pagina dei dettagli basate sulla navigazione
Visualizza gli eventi di visualizzazione della pagina dei dettagli provenienti dagli eventi di navigazione per il traffico Google con
external_experiment_ids contenente test_arm e mostra tutte le informazioni
sulle dimensioni. external_experiment_ids si ripete 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)
Ottieni le configurazioni di pubblicazione più utilizzate
Ottieni le configurazioni di gestione più utilizzate tra il 1° ottobre 2023 e il 1° novembre 2023 per il traffico Google. Ogni evento di ricerca deve avere una configurazione di pubblicazione associata.
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