Retail diganti namanya menjadi Vertex AI Search untuk retail. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Mengekspor metrik analisis ke BigQuery

Halaman ini menjelaskan cara mengekspor Vertex AI Search untuk metrik analisis retail ke BigQuery. Dengan mengekspor metrik analisis, Anda dapat mempertahankan metrik dan menulis SQL untuk analisis Anda sendiri.

Vertex AI Search untuk metrik analisis retail dibuat secara otomatis untuk Anda. Untuk mengetahui informasi selengkapnya tentang mengukur dampak bisnis dari Vertex AI Search untuk retail dengan metrik analisis, lihat Melihat analisis.

Pengeksporan data metrik ke BigQuery memiliki batasan berikut:

Data yang diekspor ke tabel BigQuery di Vertex AI Search Anda untuk project retail merupakan tampilan resmi, bukan tampilan terwujud.
Anda tidak dapat mengubah atau memperbarui data dalam tabel ini. Jika Anda perlu mengubah atau memperbarui data, ekspor atau salin tampilan tersebut ke tujuan lain.
Anda tidak dapat mengekspor metrik untuk peristiwa pengguna yang sudah lebih dari 180 hari atau metrik yang dibuat lebih dari 180 hari yang lalu. Metrik apa pun yang dihasilkan sebelum periode 180 hari tidak dapat diambil.

Sebelum memulai

Agar dapat mengekspor metrik ke BigQuery, Anda harus telah menyelesaikan prosedur di bagian Sebelum memulai. Hal ini termasuk mengimpor peristiwa pengguna dan, secara opsional, informasi katalog Anda.

Untuk informasi selengkapnya tentang pengimporan, lihat:

Membuat set data di BigQuery

Anda perlu membuat set data di BigQuery untuk menyimpan data metrik analisis Anda.

Anda harus membuat set data dalam project yang sama tempat Anda mengimplementasikan Vertex AI Search untuk retail.

Jika Anda belum pernah menggunakan BigQuery di project, aktifkan BigQuery API dan pastikan Anda memiliki peran IAM yang memungkinkan Anda membuat set data dan tabel.

Lihat Sebelum memulai dan Kontrol akses dengan IAM

dalam dokumentasi BigQuery.
Buat set data di BigQuery di multi-region US (beberapa region di Amerika Serikat). Misalnya, beri nama retail_data. Jika Anda membuat set data di region yang berbeda, pengeksporan data ke BigQuery akan gagal. CMEK untuk set data tidak didukung. Jika diaktifkan, ekspor akan gagal.

Untuk mengetahui informasi tentang cara membuat set data, lihat Membuat set data dalam dokumentasi BigQuery.

Set data ini akan digunakan untuk menyimpan tabel data yang Anda ekspor. Prosedur berikut menjelaskan cara melakukan ekspor.

Mengekspor metrik analisis ke tabel BigQuery

Gunakan metode exportAnalyticsMetrics untuk mengekspor katalog retail ke tabel BigQuery.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project Vertex AI Search untuk retail API tempat Anda membuat set data BigQuery.
DATASET_ID: Nama set data yang Anda buat di langkah Membuat set data di BigQuery. Misalnya, gunakan retail_data atau retail_metrics_data.
TABLE_ID_PREFIX: Awalan untuk ID tabel. Awalan ini tidak boleh berupa string kosong. Akhiran retail_analytics_metrics ditambahkan untuk melengkapi nama tabel. Misalnya, jika awalan adalah test, tabel akan diberi nama test_retail_analytics_metrics.

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

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

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

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)

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "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

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$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

Anda akan melihat respons JSON seperti berikut:

{
  "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"
        }
      ]
    }
  }
}

Definisi metrik

Metrik yang diekspor adalah metrik jumlah. Mungkin akan ada sedikit penyimpangan untuk beberapa metrik jumlah karena pemfilteran bot mungkin mengecualikan beberapa peristiwa dari komputasi metrik. Pemfilteran bot dapat membantu menghasilkan pengukuran performa yang lebih akurat. Hal ini tidak memengaruhi pengujian A/B, yang bergantung pada dimensi external_experiment_ids, sedangkan pemfilteran bot diterapkan ke semua traffic.

Dimensi metrik

Metrik jumlah adalah jumlah mentah yang langsung digabungkan dari peristiwa pengguna yang relevan dengan dimensi yang sama. Untuk menafsirkan metrik, Anda perlu mengetahui dimensi mana yang menjadi dasar metrik. Untuk tujuan metrik analisis, peristiwa penelusuran dan penjelajahan disebut sebagai peristiwa tayangan iklan, serta peristiwa detail_page_view, add_to_cart, dan purchase disebut sebagai peristiwa konversi. Tabel berikut menentukan dimensi metrik.

Dimensi Metrik	Deskripsi
tanggal	Tanggal peristiwa yang relevan yang menghasilkan metrik. Untuk metrik tayangan, ini adalah tanggal peristiwa tayangan. Untuk metrik sesi dan pengunjung, ini adalah tanggal peristiwa tayangan pertama sesi/pengunjung.
external_experiment_ids	ID eksperimen dari peristiwa yang relevan yang menghasilkan metrik. Untuk metrik tayangan, ini adalah ID eksperimen dari peristiwa tayangan. Untuk metrik sesi dan pengunjung, ini adalah penyambungan ID eksperimen eksternal unik dari semua peristiwa tayangan yang muncul dalam sesi/pengunjung. Misalnya, jika ada dua peristiwa penelusuran dalam sesi/pengunjung, peristiwa penelusuran pertama memiliki external_experiment_ids 'test_arm_1,test_arm_2', dan peristiwa penelusuran kedua memiliki external_experiment_ids 'test_arm_1,test_arm_3', maka external_experiment_ids dari sesi/pengunjung adalah 'test_arm_1,test_arm_3,'
device_type	Jenis perangkat peristiwa relevan yang menghasilkan metrik, misalnya, jika peristiwa dihasilkan dari perangkat seluler atau desktop. Untuk metrik tayangan, ini adalah jenis perangkat peristiwa tayangan. Untuk metrik sesi dan pengunjung, metrik ini kosong jika sesi/pengunjung memiliki lebih dari satu jenis perangkat yang berbeda, atau metrik jika hanya ada satu jenis perangkat untuk seluruh sesi/pengunjung.
serving_config	Konfigurasi penayangan peristiwa relevan yang menghasilkan metrik. Untuk metrik tayangan, ini adalah konfigurasi penayangan peristiwa tayangan. Untuk metrik sesi dan pengunjung, metrik ini kosong jika sesi/pengunjung memiliki lebih dari satu konfigurasi penayangan yang berbeda, atau jika hanya ada satu konfigurasi penayangan untuk seluruh sesi/pengunjung.
traffic_destination	Sumber peristiwa relevan yang menghasilkan metrik. Untuk metrik tayangan, keterangannya adalah "Google" jika tayangan ditampilkan oleh Google atau "Non-Google" jika tayangan disajikan oleh solusi Anda sendiri. Untuk metrik sesi dan pengunjung, ini disebut "Campuran" jika sesi/pengunjung memiliki peristiwa tayangan yang ditayangkan oleh Google dan solusi Anda sendiri. Ini adalah "Google" jika peristiwa tayangan hanya ditayangkan oleh Google atau "Non-Google" jika peristiwa tayangan hanya ditayangkan oleh solusi Anda untuk seluruh sesi/pengunjung.
entitas	Kategori ini digunakan oleh retailer yang melayani beberapa situs atau wilayah merek dengan satu katalog produk. Entitas biasanya mewakili merek atau lokasi. Untuk metrik tayangan, metrik ini adalah entitas peristiwa tayangan. Untuk metrik sesi dan pengunjung, ini adalah lima entitas teratas yang dihitung dari peristiwa tayangan untuk sesi/pengunjung.

Metrik tayangan

Metrik tayangan dihitung sesuai dengan prasyarat. Peristiwa konversi (peristiwa detail_page_view, add_to_cart, dan purchase) dapat diatribusikan kembali ke peristiwa tayangan hanya jika cocok dengan kriteria berikut.

Peristiwa tayangan dan peristiwa konversi memiliki pengunjung yang sama.
ID produk dari peristiwa konversi harus muncul di hasil peristiwa tayangan.

Peristiwa konversi berada dalam periode waktu yang diperlukan setelah terjadinya peristiwa tayangan. Periode waktu konversi yang berbeda berlaku untuk jenis peristiwa konversi yang berbeda.

Jalur konversi	Periode waktu konversi
Tayangan -> Tampilan Halaman Detail	60 detik
Tayangan -> Tambahkan Ke Keranjang	24 jam
Tayangan -> Pembelian	48 jam

Metrik tayangan iklan Penelusuran

Nama Metrik	Deskripsi
search_event	Telusuri jumlah peristiwa
detail_page_view_from_search	Jumlah peristiwa penayangan halaman detail dari penelusuran
add_to_cart_unit_from_search	Menambahkan ke jumlah unit keranjang dari penelusuran
purchase_unit_from_search	Jumlah unit pembelian dari penelusuran
revenue_from_search	Pendapatan dari penelusuran
search_event_without_result	Telusuri jumlah peristiwa yang tidak memberikan hasil
search_request_personalization_enabled	Jumlah permintaan penelusuran dengan personalisasi yang diaktifkan
search_request_personalization_result_served	Jumlah permintaan penelusuran yang ditayangkan dengan hasil yang dipersonalisasi

Menjelajahi metrik tayangan

Nama Metrik	Deskripsi
browse_event	Lihat jumlah peristiwa
detail_page_view_from_browse	Jumlah peristiwa tayangan halaman detail dari penjelajahan
add_to_cart_unit_from_browse	Menambahkan ke jumlah unit keranjang dari penjelajahan
purchase_unit_from_browse	Jumlah unit pembelian dari penjelajahan
revenue_from_browse	Pendapatan dari penjelajahan
browse_event_without_result	Jelajahi jumlah peristiwa yang tidak memberikan hasil
browse_request_personalization_enabled	Jumlah permintaan penjelajahan dengan personalisasi yang diaktifkan
browse_request_personalization_result_served	Jumlah permintaan penjelajahan yang ditayangkan dengan hasil yang dipersonalisasi

Metrik sesi

Sesi didefinisikan sebagai periode interaksi berkelanjutan antara pengguna dan sistem. Setiap peristiwa pengguna menandai awal sesi, dan akhir sesi akan ditandai saat tidak ada peristiwa lain yang terjadi selama 30 menit ke depan. Sesi diperpanjang 30 menit lagi setiap kali peristiwa pengguna terjadi dalam sesi yang dimulai. Setelah sesi berakhir, sesi baru dimulai saat pengguna berinteraksi dengan sistem lagi.

Dimensi yang menjadi ciri metrik sesi ditentukan bersama-sama oleh semua peristiwa pengguna dalam sesi tersebut. Lihat dimensi metrik untuk mengetahui cara nilai dimensi ditetapkan untuk sesi.

Nama Metrik	Deskripsi
session	Jumlah sesi

Telusuri metrik sesi

Sesi penelusuran adalah sesi yang berisi setidaknya satu peristiwa penelusuran. Perhatikan bahwa sesi penelusuran juga dapat berupa sesi penjelajahan seperti yang didefinisikan oleh metrik sesi penjelajahan.

Nama Metrik	Deskripsi
search_session	Jumlah sesi yang melibatkan penelusuran
search_event_in_search_session	Telusuri jumlah peristiwa dalam sesi penelusuran
browse_event_in_search_session	Menjelajahi jumlah peristiwa dalam sesi penelusuran
detail_page_view_in_search_session	Jumlah kunjungan halaman detail dalam sesi penelusuran
add_to_cart_in_search_session	Menambahkan ke jumlah peristiwa keranjang dalam sesi penelusuran
add_to_cart_unit_in_search_session	Jumlah unit keranjang dalam sesi penelusuran
purchase_order_in_search_session	Jumlah pesanan pembelian (PO) dalam sesi penelusuran
purchase_unit_in_search_session	Jumlah unit pembelian dalam sesi penelusuran
revenue_in_search_session	Pendapatan dalam sesi penelusuran
bounce_count_in_search_session	Jumlah sesi pengunjung yang keluar dari situs setelah hanya melihat satu halaman dalam sesi penelusuran

Menjelajahi metrik sesi

Sesi penjelajahan adalah sesi yang berisi setidaknya satu peristiwa penjelajahan. Perhatikan bahwa sesi penjelajahan juga dapat berupa sesi penelusuran seperti yang ditentukan oleh metrik sesi penelusuran.

Nama Metrik	Deskripsi
browse_session	Jumlah sesi yang mencakup penjelajahan
search_event_in_browse_session	Telusuri jumlah peristiwa dalam sesi penjelajahan
browse_event_in_browse_session	Menjelajahi jumlah peristiwa dalam sesi penjelajahan
detail_page_view_in_browse_session	Jumlah tayangan halaman detail dalam sesi penjelajahan
add_to_cart_in_browse_session	Menambahkan ke jumlah peristiwa keranjang dalam sesi penjelajahan
add_to_cart_unit_in_browse_session	Menambahkan ke jumlah unit keranjang dalam sesi penjelajahan
purchase_order_in_browse_session	Jumlah pesanan pembelian dalam sesi penjelajahan
purchase_unit_in_browse_session	Jumlah unit pembelian dalam sesi penjelajahan
revenue_in_browse_session	Pendapatan dalam sesi penjelajahan
bounce_count_in_browse_session	Jumlah sesi pengunjung yang keluar dari situs setelah melihat hanya satu halaman dalam sesi penjelajahan

Metrik pengunjung

Pengunjung diidentifikasi secara unik berdasarkan ID pengunjung. Metrik pengunjung menggabungkan semua informasi peristiwa pengguna untuk pengunjung.

Dimensi yang menjadi ciri metrik pengunjung ditentukan bersama-sama oleh semua peristiwa pengguna untuk pengunjung. Lihat dimensi metrik untuk mengetahui cara nilai dimensi ditetapkan untuk pengunjung.

Nama Metrik	Deskripsi
pengunjung	Jumlah pengunjung

Telusuri metrik pengunjung

Pengunjung penelusuran adalah pengunjung yang melakukan setidaknya satu peristiwa penelusuran. Perhatikan bahwa pengunjung penelusuran juga dapat berupa pengunjung penjelajahan seperti yang didefinisikan oleh menjelajahi metrik pengunjung.

Nama Metrik	Deskripsi
search_visitor	Jumlah pengunjung yang melakukan setidaknya satu penelusuran
search_event_from_search_visitor	Jumlah peristiwa penelusuran dari pengunjung penelusuran
browse_event_from_search_visitor	Menjelajahi jumlah peristiwa dari pengunjung penelusuran
detail_page_view_from_search_visitor	Jumlah tayangan halaman detail dari pengunjung penelusuran
add_to_cart_from_search_visitor	Jumlah peristiwa tambahkan ke keranjang dari pengunjung penelusuran
add_to_cart_unit_from_search_visitor	Menambahkan ke jumlah unit keranjang dari pengunjung penelusuran
purchase_order_from_search_visitor	Jumlah pesanan pembelian dari pengunjung penelusuran
purchase_unit_from_search_visitor	Unit jumlah pembelian dari pengunjung penelusuran
revenue_from_search_visitor	Pendapatan dari pengunjung penelusuran

Menjelajahi metrik pengunjung

Pengunjung penjelajahan adalah pengunjung yang melakukan setidaknya satu peristiwa penjelajahan. Perhatikan bahwa pengunjung yang menjelajah juga dapat menjadi pengunjung penelusuran seperti yang ditentukan oleh metrik pengunjung penelusuran.

Nama Metrik	Deskripsi
browse_visitor	Jumlah pengunjung yang melakukan setidaknya satu penjelajahan
search_event_from_browse_visitor	Jumlah peristiwa penelusuran dari pengunjung penjelajahan
browse_event_from_browse_visitor	Menjelajahi jumlah peristiwa dari pengunjung jelajah
detail_page_view_from_browse_visitor	Jumlah tampilan halaman detail dari pengunjung penjelajahan
add_to_cart_from_browse_visitor	Jumlah peristiwa menambahkan ke keranjang dari pengunjung jelajah
add_to_cart_unit_from_browse_visitor	Jumlah unit penambahan ke keranjang dari pengunjung jelajah
purchase_order_from_browse_visitor	Jumlah pesanan pembelian dari pengunjung penjelajahan
purchase_unit_from_browse_visitor	Jumlah unit pembelian dari pengunjung jelajah
revenue_from_browse_visitor	Pendapatan dari pengunjung jelajah

Contoh penggunaan

Jika menyalin atau mengekspor data metrik ke tujuan lain, Anda dapat menggunakan SQL untuk mendapatkan informasi tingkat tinggi atau spesifik tentang metrik yang diekspor. Beberapa cara umum untuk mempelajari metrik yang diekspor menggunakan SQL disediakan di bagian berikut.

Menghitung rasio klik-tayang (CTR)

Hitung CTR untuk penelusuran per tanggal per jenis perangkat per tujuan traffic.

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

Dapatkan jumlah tayangan halaman detail berbasis penjelajahan

Mendapatkan peristiwa penayangan halaman detail yang berasal dari peristiwa penjelajahan untuk traffic Google dengan external_experiment_ids yang berisi test_arm, dan menampilkan semua informasi dimensi. external_experiment_ids diulang 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)

Mendapatkan konfigurasi penyajian yang paling sering digunakan

Dapatkan konfigurasi penayangan yang paling sering digunakan antara '01-10-2023' dan '01-11-2023' untuk traffic Google. Setiap peristiwa penelusuran harus memiliki konfigurasi penayangan terkait.

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