Prasyarat penyiapan

Sebelum dapat menyiapkan AI Commerce Search untuk project baru, Anda harus:

1. Membuat project baru atau menyiapkan project yang ada
2. Mengaktifkan AI Commerce Search
3. Mengimpor katalog produk dan peristiwa pengguna

Membuat Google Cloud project

1. Di halaman Kelola resource di Google Cloud konsol, pilih atau buat Google Cloud project.

   Buka halaman Kelola Resource

2. Pastikan penagihan diaktifkan untuk project Cloud Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.

Menyiapkan AI Commerce Search

Untuk menggunakan AI Commerce Search, lakukan langkah-langkah berikut. Selain itu, jika Anda mengaktifkan AI Commerce Search dan menggunakan rekomendasi, ketahui bahwa biaya didasarkan pada jumlah kueri. Untuk mengetahui informasi selengkapnya tentang harga AI Commerce Search, lihat Biaya AI Commerce Search.

**Penting:** Anda harus menyetujui persyaratan Vertex AI Search for Industry untuk setiap project yang ingin Anda gunakan dengan AI Commerce Search.

Untuk project baru Anda

Untuk menyiapkan AI Commerce Search:

1. Buka halaman AI Commerce Search di Google Cloud konsol.

   Buka halaman AI Commerce Search di Gemini Enterprise for Customer Experience

2. Di halaman Siapkan AI Commerce Search, klik Aktifkan API.

3. Saat AI Commerce Search dan Recommendations AI ditampilkan sebagai Aktif, klik Lanjutkan.

4. Baca persyaratan Vertex AI Search for Industry untuk penggunaan data untuk penggunaan data dan klik Setuju jika Anda menyetujui persyaratan penggunaan data. Anda akan menerima konfirmasi dari Google Cloud konsol setelah persyaratan disetujui untuk penelusuran.

5. Jika Anda hanya ingin menggunakan project dengan rekomendasi, klik Mulai.

6. Untuk mengaktifkan penelusuran selain rekomendasi, lakukan hal berikut:

   1. Klik Lanjutkan , lalu klik Aktifkan di halaman Aktifkan penelusuran (Opsional).
   2. Klik Mulai.

   Konsol menampilkan komponen AI Commerce Search yang telah Anda aktifkan. Google Cloud Sekarang Anda dapat mengonfigurasi setelan awal project.

Untuk project yang ada

Untuk melanjutkan project yang ada, selesaikan langkah-langkah berikut:

1. Buka halaman AI Commerce Search di Gemini Enterprise for Customer Experience di Google Cloud konsol untuk project Anda.

   Buka halaman AI Commerce Search di Gemini Enterprise for Customer Experience

2. Di halaman Persyaratan penggunaan data, baca persyaratan penggunaan data Discovery Solutions dan klik Setuju jika Anda menyetujui persyaratan tersebut.

3. Jika Anda hanya ingin menggunakan project dengan rekomendasi, klik Mulai.

4. Jika Anda ingin mengaktifkan penelusuran selain rekomendasi, lakukan hal berikut:

   1. Klik Lanjutkan , lalu klik Aktifkan di halaman Aktifkan penelusuran (Opsional).
   2. Klik Mulai.

Penting: Pastikan Anda memiliki peran Admin Retail atau Pemilik untuk project Anda sebelum menyetujui persyaratan penggunaan data.

Menonaktifkan fitur penelusuran

Jika tidak ingin lagi menggunakan penelusuran, Anda dapat menonaktifkannya dengan mengirimkan tiket dukungan.

Untuk menetapkan tiket ke komponen yang benar, pilih kolom berikut:

• Kategori: Machine Learning
• Komponen: AI Commerce Search: search & browse
• Subkomponen: Account Administration & Billing

Untuk mengetahui informasi selengkapnya tentang cara membuat tiket dukungan, lihat Mendapatkan dukungan.

Menonaktifkan AI Commerce Search

Anda dapat menonaktifkan AI Commerce Search kapan saja dengan menonaktifkannya. Tindakan ini akan menonaktifkan rekomendasi dan penelusuran.

Untuk menonaktifkan AI Commerce Search, selesaikan langkah-langkah berikut:

1. Buka halaman AI Commerce Search API /Detail Layanan di Google Cloud konsol.

   Buka halaman Detail Layanan AI Commerce Search API

2. Klik Nonaktifkan API.

3. Di kotak Nonaktifkan AI Commerce Search API?, klik Nonaktifkan.

Catatan: Saat Anda menonaktifkan AI Commerce Search API, diperlukan waktu beberapa jam agar persyaratan Vertex AI Search for Industry untuk penggunaan data dinonaktifkan untuk project.

Mulai menggunakan AI Commerce Search

Saat Anda menyiapkan AI Commerce Search untuk project baru,Google Cloud konsol akan menampilkan tiga panel berikut untuk membantu Anda mengonfigurasi project AI Commerce Search:

• Data > Katalog: menampilkan katalog produk Anda dan link untuk mengimpor katalog Anda.

• Data > Peristiwa: menampilkan peristiwa pengguna Anda dan link untuk mengimpor peristiwa pengguna historis.

• Konfigurasi inferensi: berisi detail tentang konfigurasi inferensi Anda dan link untuk membuat konfigurasi inferensi baru.

Anda dapat menggunakan panel ini untuk mengimpor data dan membuat konfigurasi awal untuk project AI Commerce Search.

Mengimpor katalog produk

Untuk mengimpor katalog produk, selesaikan serangkaian langkah untuk sumber data Anda. Untuk mengetahui informasi selengkapnya tentang katalog produk, lihat Mengimpor informasi katalog.

Tidak digunakan lagi: Konektor Merchant Center tidak digunakan lagi dan hanya tersedia untuk pengguna saat ini. Pengguna baru harus menggunakan Catalog API atau BigQuery untuk mengimpor katalog.

Sinkronisasi Merchant Center

1. Klik Impor katalog produk untuk membuka panel Impor Data.
2. Pilih Katalog produk.
3. Pilih Sinkronisasi Merchant Center sebagai sumber data Anda.
4. Pilih akun Merchant Center Anda. Periksa Akses Pengguna jika Anda tidak melihat akun Anda.
5. Opsional: Pilih Filter feed Merchant Center untuk mengimpor hanya penawaran dari feed yang dipilih.
   
   Jika tidak ditentukan, penawaran dari semua feed akan diimpor (termasuk feed mendatang).
6. Opsional: Untuk mengimpor hanya penawaran yang ditargetkan ke negara atau bahasa tertentu, luaskan Tampilkan Opsi Lanjutan dan pilih negara penjualan dan bahasa Merchant Center untuk difilter.
7. Pilih cabang tempat Anda akan mengupload katalog.
8. Klik Impor.

Cloud Storage

1. Klik Impor katalog produk untuk membuka panel Impor Data.
2. Pilih Katalog produk sebagai sumber data Anda.
3. Pilih cabang tempat Anda akan mengupload katalog.
4. Pilih Skema Katalog Produk Retail sebagai skema.
5. Masukkan lokasi Cloud Storage data Anda.
6. Jika Anda tidak mengaktifkan penelusuran, pilih tingkat produk.
   
   Anda harus memilih tingkat produk jika ini adalah pertama kalinya Anda mengimpor katalog atau Anda mengimpor ulang katalog setelah menghapusnya. Pelajari lebih lanjut tentang tingkat produk. Mengubah tingkat produk setelah Anda mengimpor data apa pun memerlukan upaya yang signifikan.
   
   Penting: Anda tidak dapat mengaktifkan penelusuran untuk project dengan katalog produk yang telah di-ingest sebagai varian.
7. Klik Impor.

BigQuery

1. Klik Impor katalog produk untuk membuka panel Impor Data.
2. Pilih Katalog produk.
3. Pilih BigQuery sebagai sumber data Anda.
4. Pilih cabang tempat Anda akan mengupload katalog.
5. Pilih salah satu skema berikut:
   • Skema Katalog Produk Retail: Skema Produk untuk AI Commerce Search
   • Merchant Center: skema yang digunakan untuk mengimpor secara massal dari Merchant Center
6. Masukkan tabel BigQuery tempat data Anda berada.
7. Opsional: Di bagian Tampilkan opsi lanjutan, masukkan lokasi bucket Cloud Storage di project Anda sebagai lokasi sementara untuk data Anda.
   
   Jika tidak ditentukan, lokasi default akan digunakan. Jika ditentukan, bucket BigQuery dan Cloud Storage harus berada di region yang sama.
8. Jika Anda tidak mengaktifkan penelusuran dan menggunakan skema Merchant Center, pilih tingkat produk.
   
   Anda harus memilih tingkat produk jika ini adalah pertama kalinya Anda mengimpor katalog atau Anda mengimpor ulang katalog setelah menghapusnya. Pelajari lebih lanjut tentang tingkat produk. Mengubah tingkat produk setelah Anda mengimpor data apa pun memerlukan upaya yang signifikan.
   
   Penting: Anda tidak dapat mengaktifkan penelusuran untuk project dengan katalog produk yang telah di-ingest sebagai varian.
9. Klik Impor.

Mengimpor peristiwa pengguna historis

Untuk mengimpor peristiwa pengguna historis, selesaikan serangkaian langkah untuk sumber data Anda. Untuk mengetahui informasi selengkapnya tentang peristiwa pengguna historis, lihat Mengimpor peristiwa pengguna historis.

Catatan: Anda juga dapat merekam peristiwa pengguna real-time untuk membuat rekomendasi dan hasil penelusuran. Untuk mengetahui informasi selengkapnya, lihat Merekam peristiwa pengguna real-time.

Cloud Storage

1. Klik Impor peristiwa pengguna untuk membuka panel Impor Data.
2. Pilih Peristiwa pengguna.
3. Pilih Google Cloud Storage sebagai sumber data.
4. Pilih Skema Peristiwa Pengguna Retail sebagai skema.
5. Masukkan lokasi Cloud Storage data Anda.
6. Klik Impor.

BigQuery

1. Klik Impor peristiwa pengguna untuk membuka panel Impor Data.
2. Pilih Peristiwa pengguna.
3. Pilih BigQuery sebagai sumber data.

4. Pilih skema data.

   • Google Analytics 4: Gunakan untuk peristiwa Google Analytics 4.
   • Google Analytics 360: Gunakan untuk peristiwa Google Analytics 360, kecuali jika Anda hanya mengimpor peristiwa tampilan halaman beranda dari Google Analytics 360 (dalam hal ini, gunakan Skema Peristiwa Pengguna Retail).
   • Skema Peristiwa Pengguna Retail: Gunakan untuk mengimpor peristiwa dari sumber selain Google Analytics dan untuk mengimpor peristiwa tampilan halaman beranda saja dari Google Analytics 360.
5. Masukkan tabel BigQuery tempat data Anda berada.
6. Opsional: Masukkan lokasi bucket Cloud Storage di project Anda sebagai lokasi sementara untuk data Anda.
   Jika tidak ditentukan, lokasi default akan digunakan. Jika ditentukan, bucket BigQuery dan Cloud Storage harus berada di region yang sama.
7. Opsional: Di bagian Tampilkan opsi lanjutan, masukkan lokasi bucket Cloud Storage di project Anda sebagai lokasi sementara untuk data Anda.
   
   Jika tidak ditentukan, lokasi default akan digunakan. Jika ditentukan, bucket BigQuery dan Cloud Storage harus berada di region yang sama.
8. Klik Impor.

Membuat konfigurasi inferensi

Konfigurasi inferensi adalah entity inferensi yang mengaitkan model atau kumpulan kontrol yang digunakan untuk membuat hasil penelusuran atau rekomendasi Anda.

Catatan: AI Commerce Search membuat konfigurasi inferensi default sehingga prosedur ini bersifat opsional jika Anda ingin membuat konfigurasi inferensi kustom.

Untuk membuat konfigurasi inferensi, selesaikan langkah-langkah berikut:

1. Di panel Konfigurasi inferensi, klik Buat konfigurasi inferensi.
2. Di halaman Buat Konfigurasi Inferensi, pilih Penelusuran sebagai produk yang akan digunakan untuk konfigurasi inferensi.
3. Berikan nama untuk konfigurasi inferensi Anda.
   
   Nama harus terdiri dari 1024 karakter atau kurang, dan hanya dapat berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi.
4. Opsional: Jika diperlukan, perbarui ID.
   
   ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project Anda. ID harus terdiri dari 50 karakter atau kurang, dan tidak boleh berisi spasi.
5. Klik Lanjutkan.
6. Pilih apakah akan mengaktifkan aspek dinamis untuk konfigurasi inferensi ini.
7. Pilih atau buat kontrol inferensi untuk mengoptimalkan penelusuran Anda.
   
   Untuk mengetahui informasi selengkapnya tentang kontrol, lihat Membuat dan mengelola kontrol.

Mengelola resource dan memantau aktivitas

Setelah Anda menyelesaikan konfigurasi awal project, dasbor konsol akan menampilkan status sistem project AI Commerce Search Anda.Google Cloud Dasbor konsol memungkinkan Anda mengelola resource dan memantau aktivitas.

Buka konsol AI Commerce Search di Gemini Enterprise for Customer Experience

Membuat kunci API

Kunci API diperlukan jika Anda menggunakan piksel JavaScript atau tag Tag Manager untuk menangkap peristiwa pengguna dari browser pengguna. Untuk mengetahui informasi selengkapnya tentang cara menangkap peristiwa pengguna, lihat Merekam peristiwa pengguna real-time.

Untuk membuat kunci API untuk panggilan ke userEvents.Collect metode, selesaikan langkah-langkah berikut:

1. Buka halaman Google Cloud Kredensial konsol.

2. Di menu drop-down project di bagian atas halaman Google Cloud konsol, pilih project Anda (project mungkin sudah dipilih).

3. Klik Buat kredensial , lalu pilih Kunci API. Jangan tambahkan pembatasan aplikasi situs apa pun. Beberapa setelan privasi pengguna diketahui tidak meneruskan URL perujuk.

   • Catat kunci API yang dibuat, yang Anda gunakan saat memanggil logging peristiwa pengguna.

4. Untuk meningkatkan keamanan, tambahkan pembatasan API ke Kunci API Anda untuk membatasi akses ke layanan AI Commerce Search di https://retail.googleapis.com/*.

Catatan: Kunci API hanya untuk mengautentikasi metode userEvents.Collect. Metode API lainnya memerlukan OAuth 2.0 melalui akun layanan atau akun pengguna.

Langkah berikutnya

• Membatasi kunci API
• Mengautentikasi ke AI Commerce Search
• Identity and Access Management (IAM)
• Mengimplementasikan AI Commerce Search