Mengekspor metrik analisis ke BigQuery

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

Metrik analisis Vertex AI Search untuk commerce dibuat secara otomatis untuk Anda. Untuk mengetahui informasi selengkapnya tentang mengukur dampak bisnis Vertex AI Search untuk commerce 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 Commerce Anda adalah tampilan yang diizinkan, bukan tampilan terwujud.

  • 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 lebih lama dari 180 hari atau metrik yang dibuat lebih dari 180 hari yang lalu. Metrik apa pun yang dihasilkan sebelum jangka waktu 180 hari tidak dapat diambil.

Sebelum memulai

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

Untuk mengetahui informasi selengkapnya tentang pengimporan, 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 tempat Anda menerapkan Vertex AI Search untuk commerce.

  1. Jika Anda belum pernah menggunakan BigQuery di project Anda, 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 (multiple regions in the United States). 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; mengaktifkannya akan menyebabkan ekspor 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 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 API Vertex AI Search untuk e-commerce 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 perbedaan untuk beberapa metrik jumlah karena pemfilteran bot dapat mengecualikan beberapa peristiwa dari penghitungan 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 diagregasi langsung dari peristiwa pengguna yang relevan dengan dimensi yang sama. Untuk menafsirkan metrik, Anda perlu mengetahui dimensi yang mendasari metrik tersebut. Untuk tujuan metrik analisis, peristiwa penelusuran dan penjelajahan disebut sebagai peristiwa tayangan iklan, dan 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 peristiwa tayangan.

Untuk metrik sesi dan pengunjung, ini adalah gabungan ID eksperimen eksternal unik dari semua peristiwa tayangan iklan 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 sesi/pengunjung adalah 'test_arm_1,test_arm_2,test_arm_3'
device_type

Jenis perangkat dari peristiwa relevan yang menghasilkan metrik, misalnya, jika peristiwa dihasilkan dari perangkat seluler atau desktop.

Untuk metrik tayangan iklan, ini adalah jenis perangkat dari peristiwa tayangan iklan.

Untuk metrik sesi dan pengunjung, kolom ini kosong jika sesi/pengunjung memiliki lebih dari satu jenis perangkat yang berbeda, atau satu jika hanya ada satu jenis perangkat untuk seluruh sesi/pengunjung.
serving_config

Konfigurasi penayangan peristiwa yang 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 jika hanya ada satu konfigurasi penayangan untuk seluruh sesi/pengunjung.
traffic_destination

Sumber peristiwa relevan yang menghasilkan metrik.

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

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

Ini digunakan oleh retailer yang melayani beberapa situs merek atau wilayah 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 iklan 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 iklan hanya jika peristiwa tersebut cocok dengan kriteria berikut.

  • Peristiwa tayangan iklan dan peristiwa konversi memiliki pengunjung yang sama.

  • ID produk peristiwa konversi harus muncul dalam hasil peristiwa tayangan iklan.

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

    Jalur konversi Periode waktu konversi
    Tayangan Iklan -> Lihat Halaman Detail 60 detik
    Tayangan Iklan -> 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 Jumlah peristiwa penayangan halaman detail 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 Menelusuri jumlah peristiwa 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

Metrik tayangan iklan penjelajahan

Nama Metrik Deskripsi
browse_event Menjelajahi jumlah peristiwa
detail_page_view_from_browse Jumlah peristiwa penayangan halaman detail 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 penjelajahan dengan personalisasi 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 ditandai jika tidak ada peristiwa lain yang terjadi selama 30 menit berikutnya. 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 mencirikan metrik sesi ditentukan bersama oleh semua peristiwa pengguna dalam sesi. Lihat metrik dimensi sebagai cara nilai dimensi ditetapkan untuk sesi.

Nama Metrik Deskripsi
sesi Jumlah sesi

Metrik sesi penelusuran

Sesi penelusuran adalah sesi yang berisi setidaknya satu peristiwa penelusuran. Perhatikan bahwa sesi penelusuran juga dapat menjadi 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 Jumlah penayangan halaman detail 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 penjelajahan 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 acara dalam sesi penjelajahan
detail_page_view_in_browse_session Jumlah penayangan 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 setidaknya satu peristiwa penelusuran. Perhatikan bahwa pengunjung penelusuran juga dapat menjadi pengunjung penjelajahan seperti yang ditentukan oleh metrik pengunjung penjelajahan.

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 Jelajahi 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 penjelajahan adalah pengunjung yang melakukan setidaknya satu peristiwa penjelajahan. Perhatikan bahwa pengunjung penjelajahan 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 penjelajahan
detail_page_view_from_browse_visitor Jumlah penayangan halaman detail dari pengunjung penjelajahan
add_to_cart_from_browse_visitor Jumlah peristiwa tambahkan ke keranjang dari pengunjung penjelajahan
add_to_cart_unit_from_browse_visitor Jumlah unit tambahkan ke keranjang dari pengunjung penjelajahan
purchase_order_from_browse_visitor Jumlah pesanan pembelian dari pengunjung penjelajahan
purchase_unit_from_browse_visitor Jumlah unit pembelian dari pengunjung penjelajahan
revenue_from_browse_visitor Pendapatan dari pengunjung penjelajahan

Contoh penggunaan

Jika Anda 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 menjelajahi 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

Mendapatkan jumlah penayangan halaman detail yang didorong penjelajahan

Dapatkan peristiwa penayangan halaman detail yang berasal dari peristiwa penjelajahan 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 inferensi yang paling sering digunakan

Dapatkan konfigurasi penayangan yang paling banyak 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