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

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengekspor data ke BigQuery

Halaman ini menjelaskan cara mengupload data peristiwa pengguna dan produk retail ke BigQuery. Setelah data berada di BigQuery, Anda akan dapat menggunakannya untuk melakukan perkiraan penjualan dengan Vertex AI dan melihat data di dasbor Looker bawaan.

Jika data e-commerce Anda sudah ada di tabel peristiwa produk dan pengguna di BigQuery, dalam format Vertex AI Search for commerce, Anda dapat melewati halaman ini dan langsung membuka Mendapatkan dasbor yang menampilkan indikator performa utama dan Membuat perkiraan penjualan dari data retail. Untuk informasi selengkapnya tentang format, lihat Skema produk dan Tentang peristiwa pengguna.

Sebelum memulai

Sebelum dapat mengekspor data Commerce ke BigQuery, Anda harus menyelesaikan prosedur di Sebelum memulai. Hal ini mencakup impor informasi katalog dan peristiwa pengguna.

Untuk informasi selengkapnya tentang impor, lihat:

Membuat set data di BigQuery

Anda perlu membuat satu atau dua set data di BigQuery untuk menyimpan data peristiwa pengguna dan produk.

Anda dapat menggunakan satu set data untuk menyimpan kedua jenis data tersebut atau membuat dua set data, satu untuk setiap jenis data.

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

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.
Buat set data di BigQuery di multi-region AS. Misalnya, beri nama retail_data.

Catatan: Data peristiwa pengguna Vertex AI Search untuk commerce tidak dapat diekspor ke region non-AS. Perlu diingat bahwa Vertex AI Search untuk commerce tidak menggunakan PII. Jika Anda memilih region yang berbasis di Uni Eropa untuk lokasi set data, Data Pelanggan BigQuery Inti Anda akan berada di Uni Eropa. Data Pelanggan BigQuery Inti dijelaskan dalam Persyaratan Khusus Layanan BigQuery.
Opsional: Untuk menempatkan data peristiwa pengguna dalam set data terpisah dari data produk, buat set data kedua. Misalnya, beri nama retail_user_event_data.

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

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

Mengekspor katalog Vertex AI Search untuk commerce ke tabel BigQuery

Gunakan metode ExportProducts 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 commerce API tempat Anda membuat set data BigQuery.
BRANCH_ID: ID cabang katalog. Gunakan default_branch untuk mendapatkan data dari cabang default. Untuk mengetahui informasi selengkapnya, lihat Cabang katalog.
DATASET_ID: Nama set data yang Anda buat di Membuat set data di BigQuery. Misalnya, gunakan retail_data atau retail_product_data. Set data harus berada dalam project yang sama. Jangan tambahkan project ID ke kolom datasetId di sini.
TABLE_ID_PREFIX: Awalan untuk ID tabel. Awalan ini tidak boleh berupa string kosong. Akhiran retail_products ditambahkan untuk melengkapi nama tabel. Misalnya, jika awalan adalah test, tabel akan diberi nama test_retail_products.

Meminta isi JSON:

{
  "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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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'
{
  "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 print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/locations/global/catalogs/default_catalog/branches/BRANCH_ID/products:export"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

@'
{
  "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 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/v2alpha/projects/PROJECT_ID/locations/global/catalogs/default_catalog/branches/BRANCH_ID/products:export" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/operations/17986570020347019923",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ExportProductsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_products"
        }
      ]
    }
  }
}

Mengekspor peristiwa pengguna ke tabel BigQuery

Gunakan metode userEvents.export untuk mengekspor peristiwa pengguna retail ke dalam tabel BigQuery:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project Vertex AI Search for commerce 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_product_data.
TABLE_ID_PREFIX: Awalan untuk ID tabel. Awalan ini tidak boleh berupa string kosong. Akhiran retail_products ditambahkan untuk melengkapi nama tabel. Misalnya, jika awalan adalah test, tabel akan diberi namatest_retail_products.

Meminta isi JSON:

{
  "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'
{
  "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 print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:export"

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:

@'
{
  "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 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/v2alpha/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:export" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/17203443067109586170",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2alpha.ExportUserEventsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_user_events"
        }
      ]
    }
  }
}

Tentang data yang diekspor

Berikut adalah hal-hal yang perlu diketahui tentang data Commerce yang Anda ekspor ke tabel BigQuery:

Data yang diekspor ke tabel BigQuery dalam project Anda adalah tampilan yang diotorisasi, bukan tampilan terwujud.
Anda tidak dapat mengubah atau memperbarui data dalam tabel ini.
Produk diperbarui setiap jam.
Peristiwa pengguna diperbarui hampir secara real time.

Tentang data peristiwa pengguna yang diekspor

Berikut adalah hal-hal yang perlu diketahui tentang informasi produk yang disertakan dengan data peristiwa pengguna yang diekspor.

Informasi harga produk

Cara informasi harga produk ditampilkan oleh metode userEvents.export bergantung pada hal berikut:

Anda menyertakan informasi harga dalam data peristiwa pengguna pada saat penyerapan. Saat Anda memanggil metode userEvents.export, harga yang ditampilkan dengan peristiwa pengguna adalah harga produk pada saat peristiwa.
Anda tidak menyertakan informasi harga dengan data peristiwa pengguna, tetapi menyertakan informasi harga dalam data produk pada saat penyerapan. Saat Anda memanggil metode userEvents.export, harga yang ditampilkan dengan peristiwa pengguna belum tentu merupakan harga produk pada saat peristiwa. Ini adalah harga yang ditemukan di data produk Anda pada saat penyerapan.
Anda tidak menyertakan informasi harga dengan data peristiwa pengguna dan tidak ada informasi harga yang tersedia di data produk Anda. Saat Anda memanggil metode userEvents.export, tidak ada harga yang ditampilkan dengan peristiwa pengguna.

Informasi produk lainnya

Semua informasi produk (kecuali harga) digabungkan dengan informasi peristiwa pengguna saat Anda memanggil metode userEvents.export. Nilai produk dapat berubah dari waktu peristiwa pengguna hingga waktu Anda memanggil userEvents.export. Karena alasan ini, nilai produk non-harga yang ditampilkan dalam tabel peristiwa pengguna dapat berbeda dari nilai produk pada saat peristiwa pengguna.

Opsional: Pastikan tabel baru ada di BigQuery

Setelah mengekspor data produk dan data peristiwa pengguna ke BigQuery, pastikan tabel baru sudah ada.

Di BigQuery, buka set data yang Anda buat di Membuat set data di BigQuery.
Buka set data dan pastikan Anda melihat dua tabel yang diekspor. Misalnya, cari tabel dengan nama yang diakhiri dengan retail_products dan retail_user_events.

Untuk informasi selengkapnya tentang cara menggunakan tabel BigQuery, lihat Membuat kueri dan melihat data.

Tinjau halaman Tata kelola data untuk mengetahui informasi selengkapnya tentang cara Vertex AI Search untuk commerce menangani data pelanggan.