Mengekspor metrik analisis ke BigQuery

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

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

Mengekspor data metrik ke BigQuery memiliki batasan berikut:

  • Data yang diekspor ke tabel BigQuery di project Vertex AI Search for retail Anda adalah tampilan yang diotorisasi, bukan tampilan yang diwujudkan.

  • Anda tidak dapat mengubah atau memperbarui data dalam tabel ini. Jika Anda perlu mengubah atau memperbarui data, ekspor atau salin tampilan 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

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

Untuk informasi selengkapnya tentang impor, lihat:

Membuat set data di BigQuery

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

Anda harus membuat set data di project yang sama dengan tempat Anda menerapkan Vertex AI Search untuk retail.

  1. Jika Anda belum pernah menggunakan BigQuery dalam 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.

  2. 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, ekspor data ke BigQuery akan gagal. CMEK untuk set data tidak didukung; mengaktifkannya akan menyebabkan ekspor gagal.

    Untuk 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 mengekspor.

Mengekspor metrik analisis ke tabel BigQuery

Gunakan metode exportAnalyticsMetrics untuk mengekspor katalog retail Anda ke dalam tabel BigQuery.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Vertex AI Search for retail API tempat Anda membuat set data BigQuery.
  • DATASET_ID: Nama set data yang Anda buat di 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:

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 ada sedikit penyimpangan untuk beberapa metrik jumlah karena pemfilteran bot mungkin mengecualikan beberapa peristiwa dari komputasi metrik. Pemfilteran bot dapat membantu memberikan 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 yang menjadi dasar metrik. Untuk tujuan metrik analisis, peristiwa penelusuran dan penjelajahan disebut sebagai peristiwa tayangan, dan peristiwa detail_page_view, add_to_cart, dan purchase disebut sebagai peristiwa konversi. Tabel berikut menentukan dimensi metrik.

Dimensi Metrik Deskripsi
date

Tanggal peristiwa 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 peristiwa yang relevan yang menghasilkan metrik.

Untuk metrik tayangan, ini adalah ID eksperimen 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 satu 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 sesi/pengunjung adalah 'test_arm_1,test_arm_2,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 dari peristiwa tayangan.

Untuk metrik sesi dan pengunjung, kolom ini kosong jika sesi/pengunjung memiliki lebih dari satu jenis perangkat yang berbeda, atau satu jenis perangkat 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, kolom ini kosong jika sesi/pengunjung memiliki lebih dari satu konfigurasi penayangan yang berbeda, atau satu konfigurasi jika hanya ada satu konfigurasi penayangan untuk seluruh sesi/pengunjung.
traffic_destination

Sumber peristiwa relevan yang menghasilkan metrik.

Untuk metrik tayangan, nilainya adalah "Google" jika tayangan ditayangkan oleh Google atau "Non-Google" jika tayangan ditayangkan oleh solusi Anda sendiri.

Untuk metrik sesi dan pengunjung, statusnya adalah "Campuran" jika sesi/pengunjung memiliki peristiwa tayangan yang ditayangkan oleh Google dan solusi Anda sendiri. Nilai ini adalah "Google" jika peristiwa tayangan iklan sepenuhnya ditayangkan oleh Google atau "Non-Google" jika peristiwa tayangan iklan sepenuhnya ditayangkan oleh solusi Anda untuk seluruh sesi/pengunjung.
entitas

Ini digunakan oleh retailer yang menayangkan beberapa situs atau wilayah merek dengan satu katalog produk. Entitas biasanya mewakili merek atau lokasi.

Untuk metrik tayangan, ini adalah entity 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), hanya dapat diatribusikan kembali ke peristiwa tayangan jika cocok dengan kriteria berikut.

  • Peristiwa tayangan dan peristiwa konversi memiliki pengunjung yang sama.

  • ID produk peristiwa konversi harus muncul dalam 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 Jumlah peristiwa penelusuran
detail_page_view_from_search Detail jumlah peristiwa kunjungan halaman dari penelusuran
add_to_cart_unit_from_search Jumlah unit tambahkan ke keranjang dari penelusuran
purchase_unit_from_search Jumlah unit pembelian dari penelusuran
revenue_from_search Pendapatan dari penelusuran
search_event_without_result Jumlah peristiwa penelusuran yang tidak menghasilkan hasil
search_request_personalization_enabled Jumlah permintaan penelusuran dengan personalisasi diaktifkan
search_request_personalization_result_served Jumlah permintaan penelusuran yang ditayangkan dengan hasil yang dipersonalisasi

Menjelajahi metrik tayangan

Nama Metrik Deskripsi
browse_event Menjelajahi jumlah peristiwa
detail_page_view_from_browse Detail jumlah peristiwa kunjungan halaman dari penjelajahan
add_to_cart_unit_from_browse Jumlah unit tambahkan ke keranjang dari penjelajahan
purchase_unit_from_browse Jumlah unit pembelian dari penjelajahan
revenue_from_browse Pendapatan dari penjelajahan
browse_event_without_result Menjelajahi jumlah peristiwa yang tidak menghasilkan hasil
browse_request_personalization_enabled Jumlah permintaan jelajah dengan personalisasi diaktifkan
browse_request_personalization_result_served Jumlah permintaan jelajah 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 ditandai saat tidak ada peristiwa lain yang terjadi selama 30 menit ke depan. Sesi akan diperpanjang 30 menit lagi setiap kali peristiwa pengguna terjadi dalam sesi yang dimulai. Setelah sesi berakhir, sesi baru akan dimulai saat pengguna berinteraksi dengan sistem lagi.

Dimensi yang mencirikan metrik sesi ditentukan bersama oleh semua peristiwa pengguna dalam sesi. Lihat dimensi metrik sebagai cara menetapkan nilai dimensi untuk sesi.

Nama Metrik Deskripsi
session Jumlah sesi

Metrik sesi penelusuran

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

Nama Metrik Deskripsi
search_session Jumlah sesi yang melibatkan penelusuran
search_event_in_search_session Jumlah peristiwa penelusuran dalam sesi penelusuran
browse_event_in_search_session Menjelajahi jumlah peristiwa dalam sesi penelusuran
detail_page_view_in_search_session Mendetailkan jumlah kunjungan halaman dalam sesi penelusuran
add_to_cart_in_search_session Jumlah peristiwa tambahkan ke keranjang dalam sesi penelusuran
add_to_cart_unit_in_search_session Jumlah unit tambahkan ke keranjang dalam sesi penelusuran
purchase_order_in_search_session Jumlah pesanan pembelian 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 jelajah juga dapat berupa sesi penelusuran seperti yang ditentukan oleh metrik sesi penelusuran.

Nama Metrik Deskripsi
browse_session Jumlah sesi yang melibatkan penjelajahan
search_event_in_browse_session Jumlah peristiwa penelusuran dalam sesi penjelajahan
browse_event_in_browse_session Menjelajahi jumlah peristiwa dalam sesi penjelajahan
detail_page_view_in_browse_session Jumlah kunjungan halaman detail dalam sesi penjelajahan
add_to_cart_in_browse_session Jumlah peristiwa tambahkan ke keranjang dalam sesi penjelajahan
add_to_cart_unit_in_browse_session Jumlah unit tambahkan ke 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 hanya melihat satu halaman dalam sesi penjelajahan

Metrik pengunjung

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

Dimensi yang mencirikan metrik pengunjung ditentukan bersama oleh semua peristiwa pengguna untuk pengunjung. Lihat dimensi metrik sebagai cara nilai dimensi ditetapkan untuk pengunjung.

Nama Metrik Deskripsi
pengunjung Jumlah pengunjung

Metrik pengunjung penelusuran

Pengunjung penelusuran adalah pengunjung yang melakukan minimal satu peristiwa penelusuran. Perhatikan bahwa pengunjung penelusuran juga dapat berupa pengunjung jelajah seperti yang ditentukan oleh metrik pengunjung jelajah.

Nama Metrik Deskripsi
search_visitor Jumlah pengunjung yang melakukan minimal 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 penayangan 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 Jumlah unit tambahkan ke 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 jelajah adalah pengunjung yang melakukan minimal satu peristiwa jelajah. Perhatikan bahwa pengunjung jelajah juga dapat berupa pengunjung penelusuran seperti yang ditentukan oleh metrik pengunjung penelusuran.

Nama Metrik Deskripsi
browse_visitor Jumlah pengunjung yang melakukan minimal satu penjelajahan
search_event_from_browse_visitor Jumlah peristiwa penelusuran dari pengunjung jelajah
browse_event_from_browse_visitor Jumlah peristiwa jelajah dari pengunjung jelajah
detail_page_view_from_browse_visitor Mendetailkan jumlah kunjungan halaman dari pengunjung yang menjelajahi
add_to_cart_from_browse_visitor Jumlah peristiwa tambahkan ke keranjang dari pengunjung jelajah
add_to_cart_unit_from_browse_visitor Jumlah unit tambahkan ke keranjang dari pengunjung jelajah
purchase_order_from_browse_visitor Jumlah pesanan pembelian dari pengunjung jelajah
purchase_unit_from_browse_visitor Jumlah unit pembelian dari pengunjung yang menjelajahi
revenue_from_browse_visitor Pendapatan dari pengunjung yang menjelajahi

Contoh penggunaan

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

Menghitung rasio klik-tayang (CTR)

Menghitung 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

Mendapatkan jumlah kunjungan halaman detail yang didorong oleh penjelajahan

Dapatkan peristiwa kunjungan halaman detail yang berasal dari peristiwa jelajah untuk traffic Google dengan external_experiment_ids yang berisi test_arm, dan tampilkan 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 penayangan yang paling sering digunakan

Dapatkan konfigurasi penayangan yang paling sering digunakan antara '2023-10-01' dan '2023-11-01' 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