Il nome del retail verrà rinominato Vertex AI Search per il retail. Stiamo aggiornando i contenuti per riflettere il nuovo branding.

Esporta le tue metriche di analisi in BigQuery

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

Le metriche di analisi di Vertex AI Search per la vendita al dettaglio vengono generate automaticamente. Per ulteriori informazioni sulla misurazione dell'impatto aziendale di Vertex AI Search per il retail con metriche di analisi, consulta Visualizza dati e analisi.

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

I dati esportati in tabelle BigQuery nel progetto Vertex AI Search per la vendita al dettaglio sono visualizzazioni 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 vista in un'altra destinazione.
Non puoi esportare le metriche per gli eventi utente antecedenti a 180 giorni o le metriche generate più di 180 giorni fa. Eventuali metriche generate prima della finestra di 180 giorni non possono essere recuperate.

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, consulta:

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 il retail.

Se non hai mai utilizzato BigQuery nel progetto, abilita l'API BigQuery e assicurati di disporre del ruolo IAM che 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 negli Stati Uniti (più regioni negli Stati Uniti). Ad esempio, chiamalo retail_data. Se crei il set di dati in un'altra regione, l'esportazione dei dati in BigQuery non va a buon fine. La CMEK per il set di dati non è supportata. Se viene abilitata, l'esportazione non riuscirà.

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 seguenti procedure descrivono come eseguire l'esportazione.

Esporta 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, effettua le seguenti sostituzioni:

PROJECT_ID: l'ID del progetto dell'API Vertex AI Search for Retail in cui hai creato il set di dati BigQuery.
DATASET_ID: il nome del set di dati 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. Viene aggiunto un suffisso retail_analytics_metrics per completare il nome della tabella. Ad esempio, se il prefisso è test, la tabella è 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 di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

cat > request.json << 'EOF'
{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog:exportAnalyticsMetrics"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

@'
{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog:exportAnalyticsMetrics" | Select-Object -Expand Content

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 una leggera deviazione per alcune metriche di conteggio, perché il filtro dei bot potrebbe escludere alcuni eventi dal calcolo delle metriche. I filtri bot possono contribuire a fornire misurazioni delle prestazioni più accurate. Ciò non influisce sui 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 direttamente aggregati 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 indicati come eventi di impressione, mentre gli eventi detail_page_view, add_to_cart e purchase sono indicati come eventi di conversione. La tabella seguente definisce le dimensioni della metrica.

Dimensione metrica	Descrizione
date	La data 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, corrisponde alla data della prima impressione della sessione/visitatore.
external_experiment_ids	Gli ID esperimento degli eventi pertinenti che hanno generato le metriche. Per le metriche relative alle impressioni, corrisponde all'ID esperimento dell'evento di impressione. Per le metriche su sessioni e visitatori, si tratta della concatenazione degli ID esperimento esterni univoci di tutti gli eventi relativi alle impressioni visualizzati all'interno della sessione/visitatore. Ad esempio, se sono presenti due eventi di ricerca all'interno di una sessione/visitatore, il primo evento di ricerca ha external_experiment_id "test_arm_1,test_arm_2", mentre il secondo contiene external_experiment_id "test_arm_1,test_arm_3", quindi external_experiment_id della sessione/il visitatore è "test_arm_1,test_arm_3",
device_type	Il tipo di dispositivo degli eventi pertinenti che hanno generato le metriche, ad esempio se l'evento è stato generato da un dispositivo mobile o desktop. Per le metriche relative alle impressioni, indica il tipo di dispositivo dell'evento di impressione. Per le metriche relative a sessioni e visitatori, il valore è vuoto se la sessione/visitatore ha più di un tipo di dispositivo distinto o se esiste 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, si tratta della configurazione di pubblicazione dell'evento relativo alle impressioni. Per le metriche relative a sessioni e visitatori, il valore è vuoto se la sessione/visitatore ha più di una configurazione di pubblicazione distinta o quella se esiste 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, può essere "Google" se l'impressione è pubblicata da Google o "Non Google" se viene pubblicata dalla tua soluzione. Per le metriche sessione e visitatore, il valore è "Misto" se la sessione/visitatore ha entrambi gli eventi di impressione pubblicati sia da Google sia dalla tua soluzione. Questo valore è "Google" se gli eventi di impressione sono pubblicati esclusivamente da Google o "Non Google" se sono pubblicati esclusivamente dalla soluzione per l'intera sessione/visitatore.
entità	È utilizzato dai rivenditori che gestiscono più siti o regioni di brand con un unico catalogo dei prodotti. L'entità di solito rappresenta i brand o le sedi. Per le metriche relative alle impressioni, si tratta dell'entità dell'evento di impressione. Per le metriche relative a sessioni e visitatori, si tratta delle prime cinque entità conteggiate degli eventi di impressioni per sessione/visitatore.

Metriche delle impressioni

Le metriche delle impressioni vengono calcolate in base a prerequisiti. Gli eventi di conversione (eventi detail_page_view, add_to_cart e purchase) possono essere attribuiti 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 essere visualizzato nei risultati dell'evento di impressione.

L'evento di conversione rientra nella finestra temporale richiesta dopo il verificarsi dell'evento di impressione. A seconda dei tipi di eventi di conversione, si applicano finestre temporali diverse.

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

Metriche relative alle 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	Aggiungi al carrello del numero di unità dalla ricerca
purchase_unit_from_search	Conteggio unità acquistate dalla ricerca
revenue_from_search	Entrate dalla ricerca
search_event_without_result	Conteggio degli eventi di ricerca che non restituisce risultati
search_request_personalization_enabled	Conteggio delle richieste di ricerca con personalizzazione abilitata
search_request_personalization_result_served	Numero di richieste di ricerca visualizzate con risultati personalizzati

Sfogliare le metriche relative alle impressioni

Nome metrica	Descrizione
browse_event	Conteggio eventi di navigazione
detail_page_view_from_browse	Conteggio eventi di visualizzazione della pagina dei dettagli dall'esplorazione
add_to_cart_unit_from_browse	Aggiungi al carrello delle unità da sfogliare
purchase_unit_from_browse	Conteggio unità acquistate dalla consultazione
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	Numero di richieste di navigazione mostrate con risultati personalizzati

Metriche relative alle sessioni

Per sessione si intende un periodo continuo di interazione tra un utente e il sistema. Qualsiasi evento utente contrassegna l'inizio di una sessione e la fine di una 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 si verifica un evento utente all'interno di una sessione avviata. Al termine di una sessione, inizia quando l'utente interagisce con il sistema.

Le dimensioni che caratterizzano le metriche di sessione sono definite congiuntamente da tutti gli eventi utente all'interno della sessione. Consulta la sezione Dimensioni delle metriche per sapere come vengono impostati i valori delle dimensioni per la sessione.

Nome metrica	Descrizione
sessione	Conteggio sessioni

Cerca metriche relative alle sessioni

Per sessione di ricerca si intende almeno un evento di ricerca. Tieni presente che una sessione di ricerca può essere anche una sessione di navigazione, come definito dalle metriche della sessione di navigazione.

Nome metrica	Descrizione
search_session	Conteggio sessioni che coinvolgono una ricerca
search_event_in_search_session	Conteggio eventi di ricerca nelle sessioni di ricerca
browse_event_in_search_session	Conteggio eventi di navigazione nelle sessioni di ricerca
detail_page_view_in_search_session	Numero di visualizzazioni della pagina dei dettagli all'interno delle sessioni di ricerca
add_to_cart_in_search_session	Conteggio eventi Aggiungi 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	Numero di unità acquistate nelle sessioni di ricerca
revenue_in_search_session	Entrate nelle sessioni di ricerca
bounce_count_in_search_session	Conteggio delle sessioni del visitatore che esce dal sito dopo aver visualizzato una sola pagina in sessioni di ricerca

Sfogliare le metriche relative alle sessioni

Per sessione si intende una sessione contenente almeno un evento di consultazione. Tieni presente che una sessione di navigazione può essere anche una sessione di ricerca, come definito dalle metriche della sessione di ricerca.

Nome metrica	Descrizione
browse_session	Conteggio sessioni che include l'esplorazione
search_event_in_browse_session	Conteggio eventi di ricerca nelle sessioni di navigazione
browse_event_in_browse_session	Conteggio eventi di navigazione nelle sessioni di navigazione
detail_page_view_in_browse_session	Numero di visualizzazioni della pagina dei dettagli all'interno delle sessioni di navigazione
add_to_cart_in_browse_session	Conteggio eventi Aggiungi al carrello nelle sessioni di navigazione
add_to_cart_unit_in_browse_session	Aggiungi il conteggio delle unità al carrello nelle sessioni di navigazione
purchase_order_in_browse_session	Numero di ordini di acquisto nelle sessioni di navigazione
purchase_unit_in_browse_session	Numero di unità acquistate nelle sessioni di consultazione
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 una sola pagina in sessioni di navigazione

Metriche relative ai visitatori

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

Le dimensioni che caratterizzano le metriche visitatore sono definite congiuntamente da tutti gli eventi utente per il visitatore. Fai riferimento alle dimensioni delle metriche come al modo in cui vengono impostati i valori delle dimensioni per il visitatore.

Nome metrica	Descrizione
visitatore	Numero di visitatori

Cerca metriche sui visitatori

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

Nome metrica	Descrizione
search_visitor	Numero di visitatori che eseguono almeno una ricerca
search_event_from_search_visitor	Conteggio eventi di ricerca dei visitatori della ricerca
browse_event_from_search_visitor	Conteggio eventi di navigazione dei visitatori della ricerca
detail_page_view_from_search_visitor	Numero di visualizzazioni della pagina dei dettagli dai visitatori della ricerca
add_to_cart_from_search_visitor	Conteggio eventi Aggiungi al carrello dei visitatori della ricerca
add_to_cart_unit_from_search_visitor	Aggiungi al carrello delle unità dei visitatori della ricerca
purchase_order_from_search_visitor	Conteggio degli ordini di acquisto dai 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 ricerca

Sfogliare le metriche sui visitatori

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

Nome metrica	Descrizione
browse_visitor	Numero di visitatori che eseguono almeno una consultazione
search_event_from_browse_visitor	Conteggio eventi di ricerca dai visitatori della 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 dai visitatori della navigazione
add_to_cart_from_browse_visitor	Conteggio eventi Aggiungi al carrello dai visitatori della navigazione
add_to_cart_unit_from_browse_visitor	Conteggio delle unità aggiunte al carrello dai visitatori della navigazione
purchase_order_from_browse_visitor	Conteggio ordini di acquisto dai visitatori della navigazione
purchase_unit_from_browse_visitor	Conteggio unità acquistate 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 specifiche o generali sulle metriche esportate. Nelle sezioni seguenti sono riportati alcuni modi comuni per esplorare le metriche esportate utilizzando SQL.

Calcola la percentuale di clic (CTR)

Calcola il CTR per la ricerca in base alla 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

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

Visualizza gli eventi di visualizzazione della pagina dei dettagli provenienti da eventi di navigazione per il traffico Google con external_experiment_ids contenenti 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)

Visualizza le configurazioni di pubblicazione più utilizzate

Ottieni le configurazioni di pubblicazione più utilizzate tra il 1°/10/2023 e il 1°/11/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