Prasyarat penyiapan

Sebelum dapat menyiapkan Penelusuran Platform Agen untuk e-commerce untuk project baru, Anda harus:

1. Buat project baru atau siapkan project yang sudah ada
2. Mengaktifkan Penelusuran Platform Agen untuk commerce
3. Impor katalog produk dan peristiwa pengguna Anda

Buat Google Cloud project

1. Di halaman Kelola resource di konsol Google Cloud , 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 Penelusuran Platform Agen untuk commerce

Untuk menggunakan Penelusuran Platform Agen untuk e-commerce, lakukan langkah-langkah berikut. Selain itu, jika Anda mengaktifkan Penelusuran Platform Agen untuk perdagangan dan menggunakan rekomendasi, ketahui bahwa biaya didasarkan pada jumlah kueri. Untuk mengetahui informasi selengkapnya tentang harga penelusuran Platform Agen untuk commerce, lihat Biaya penelusuran Platform Agen untuk commerce.

Penting: Anda harus menyetujui persyaratan Penelusuran Platform Agen untuk Industri bagi setiap project yang ingin Anda gunakan dengan Penelusuran Platform Agen untuk e-commerce.

Untuk project baru Anda

Untuk menyiapkan Penelusuran Platform Agen untuk commerce:

1. Buka halaman Agent Platform Search for commerce di konsol Google Cloud .

   Buka halaman Penelusuran untuk e-commerce

2. Di halaman Siapkan Penelusuran Platform Agen untuk commerce, klik Aktifkan API.

3. Jika Agent Platform Search for commerce dan Recommendations AI ditampilkan sebagai Aktif, klik Lanjutkan.

4. Baca Persyaratan Penelusuran Platform Agen untuk Penggunaan Data di Industri untuk penggunaan data dan klik Setuju jika Anda menyetujui persyaratan penggunaan data. Anda akan menerima konfirmasi dari konsol Google Cloud 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 Google Cloud menampilkan Penelusuran Platform Agen untuk komponen e-commerce yang telah Anda aktifkan. Sekarang Anda dapat mengonfigurasi setelan awal project.

Untuk project yang ada

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

1. Buka halaman Search for commerce di konsol Google Cloud untuk project Anda.

   Buka halaman Penelusuran untuk e-commerce

2. Di halaman Persyaratan penggunaan data, baca persyaratan penggunaan data Solusi Penemuan, lalu 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 atau Pemilik Retail 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 menyetel tiket Anda ke komponen yang benar, pilih kolom berikut:

• Kategori: Machine Learning
• Komponen: Penelusuran Platform Agen untuk e-commerce: penelusuran & penjelajahan
• Subkomponen: Administrasi Akun & Penagihan

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

Menonaktifkan Penelusuran Platform Agen untuk commerce

Anda dapat menonaktifkan Penelusuran Platform Agen untuk e-commerce kapan saja dengan menonaktifkannya. Tindakan ini akan menonaktifkan rekomendasi dan penelusuran.

Untuk menonaktifkan Penelusuran Platform Agen untuk e-commerce, selesaikan langkah-langkah berikut:

1. Buka halaman Agent Platform Search for Retail API/Service Details di konsolGoogle Cloud .

   Buka halaman Detail Layanan API Commerce di Agent Platform Search

2. Klik Disable API.

3. Di kotak Disable Agent Platform Search for commerce API?, klik Disable.

Catatan: Jika Anda menonaktifkan API Penelusuran Platform Agen untuk e-commerce, perlu waktu beberapa jam agar istilah Penelusuran Platform Agen untuk Industri terkait penggunaan data dinonaktifkan untuk project.

Mulai menggunakan Penelusuran Platform Agen untuk perdagangan

Saat Anda menyiapkan Penelusuran Platform Agen untuk e-commerce bagi project baru, konsolGoogle Cloud akan menampilkan tiga panel berikut untuk membantu Anda mengonfigurasi project Penelusuran Platform Agen untuk e-commerce:

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

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

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

Anda dapat menggunakan panel ini untuk mengimpor data dan membuat konfigurasi awal untuk project Penelusuran platform agen untuk perdagangan.

Mengimpor katalog produk

Untuk mengimpor katalog produk, selesaikan serangkaian langkah untuk sumber data Anda. Untuk mengetahui informasi selengkapnya tentang katalog produk, lihat bagian 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 yang akan difilter.
7. Pilih cabang tempat Anda akan mengupload katalog.
8. Klik Import.

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 Retail Product Catalogs Schema 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 level 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 Import.

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 Penelusuran Platform Agen untuk e-commerce
   • 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 level 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 Import.

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 Import.

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 mengimpor hanya tayangan halaman beranda dari Google Analytics 360 (dalam hal ini, gunakan Skema Peristiwa Pengguna Retail).
   • Skema Peristiwa Pengguna Retail: Digunakan untuk mengimpor peristiwa dari sumber selain Google Analytics dan untuk mengimpor peristiwa hanya penayangan halaman beranda 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 Import.

Membuat konfigurasi inferensi

Konfigurasi penayangan adalah entitas penayangan yang mengaitkan model atau serangkaian kontrol yang digunakan untuk membuat hasil penelusuran atau rekomendasi Anda.

Catatan: Penelusuran Platform Agen untuk e-commerce membuat konfigurasi penayangan default, sehingga prosedur ini bersifat opsional jika Anda ingin membuat konfigurasi penayangan kustom.

Untuk membuat konfigurasi penayangan, selesaikan langkah-langkah berikut:

1. Di panel Konfigurasi penayangan, klik Buat konfigurasi penayangan.
2. Di halaman Create Serving Config, pilih Search sebagai produk yang akan menggunakan konfigurasi penayangan.
3. Berikan nama untuk konfigurasi penayangan Anda.
   
   Nama harus terdiri dari 1024 karakter atau kurang, dan hanya dapat berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi.
4. Opsional: Jika perlu, perbarui ID.
   
   ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project Anda. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.
5. Klik Lanjutkan.
6. Pilih apakah akan mengaktifkan penyesuaian dinamis untuk konfigurasi penayangan ini.
7. Pilih atau buat kontrol penayangan 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 Agent Platform Search for Commerce Anda.Google Cloud Dasbor konsol memungkinkan Anda mengelola resource dan memantau aktivitas.

Buka konsol Penelusuran untuk e-commerce

Membuat kunci API

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

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

1. Buka halaman Google Cloud console Credentials.

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

3. Klik Create credentials, lalu pilih API key. Jangan menambahkan batasan aplikasi situs. Beberapa setelan privasi pengguna diketahui tidak meneruskan URL perujuk.

   • Catat kunci API yang dibuat, yang Anda gunakan saat memanggil pencatatan log aktivitas pengguna.

4. Untuk meningkatkan keamanan, tambahkan pembatasan API ke Kunci API Anda untuk membatasi akses ke layanan penelusuran Platform Agen untuk layanan e-commerce 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 Penelusuran Platform Agen untuk e-commerce
• Identity and Access Management (IAM)
• Menerapkan Penelusuran Platform Agen untuk commerce