Sebelum memulai

Membuat project Google Cloud

  1. Pada halaman Manage resources di Konsol Google Cloud, pilih atau buat project Google Cloud.

    Buka halaman Kelola Resource

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

Menyiapkan Vertex AI Search untuk retail

Agar dapat menggunakan Vertex AI Search untuk retail, beserta rekomendasi, Anda harus mengaktifkan Vertex AI Search untuk retail dan menyetujui persyaratan Vertex AI Search untuk Industri untuk penggunaan data. Jika Anda juga menggunakan penelusuran, Anda harus mengaktifkannya. Penggunaan penelusuran akan menimbulkan biaya tambahan berdasarkan jumlah kueri. Untuk mengetahui informasi selengkapnya, lihat Biaya penelusuran.

Guna menyiapkan Vertex AI Search untuk retail, selesaikan langkah-langkah berikut:

  1. Buka halaman Vertex AI Search for retail di Konsol Google Cloud.

    Buka halaman Search for Retail

  2. Di halaman Set up Vertex AI Search for retail, klik Turn on API.

  3. Saat Vertex AI Search for retail dan Recommendations AI ditampilkan sebagai On, klik Continue.

  4. Baca persyaratan Vertex AI Search for Industry untuk penggunaan data dan klik Accept jika Anda menyetujui persyaratan penggunaan data.

    Setelah Anda menyetujui persyaratan penggunaan data, Konsol Google Cloud akan menunjukkan bahwa persyaratan penggunaan data retail untuk Vertex AI Search telah disetujui.

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

  6. Jika ingin mengaktifkan penelusuran selain rekomendasi, lakukan tindakan berikut:

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

Konsol Google Cloud akan menampilkan Vertex AI Search untuk komponen retail yang telah Anda aktifkan. Sekarang Anda dapat mengonfigurasi setelan awal project Anda.

Menyiapkan project yang sudah ada

Jika menyiapkan Vertex AI Search untuk retail di project Google Cloud sebelum persyaratan penggunaan data berlaku pada 4 April 2022, Anda harus menyetujui persyaratan Vertex AI Search for Industry agar dapat terus menggunakan Vertex AI Search untuk retail dengan project tersebut. Anda juga harus mengaktifkan penelusuran untuk project tersebut, jika diperlukan.

Untuk menyetujui persyaratan Vertex AI Search for Industry untuk project yang sudah ada, selesaikan langkah-langkah berikut:

  1. Buka halaman Search for Retail di Konsol Google Cloud untuk project Anda.

    Buka halaman Search for Retail

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

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

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

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

Nonaktifkan penelusuran atau Vertex AI Search untuk retail

Nonaktifkan penelusuran

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

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

  • Kategori: Machine Learning
  • Komponen: Vertex AI Search untuk retail: penelusuran & penjelajahan
  • Subkomponen: Administrasi & Penagihan Akun

Untuk informasi selengkapnya tentang pembuatan tiket dukungan, lihat Mendapatkan dukungan.

Menonaktifkan Vertex AI Search untuk retail

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

Guna menonaktifkan Vertex AI Search untuk retail, selesaikan langkah-langkah berikut:

  1. Buka halaman Vertex AI Search for Retail API/Service Details di Konsol Google Cloud.

    Buka halaman Detail Layanan API retail Vertex AI Search

  2. Klik Disable API.

  3. Di kotak Disable Vertex AI Search for retail API?, klik Disable.

Mulai menggunakan Vertex AI Search untuk retail

Saat Anda menyiapkan Vertex AI Search bagi retail untuk sebuah project baru, Konsol Google Cloud akan menampilkan tiga panel berikut guna membantu Anda mengonfigurasi Vertex AI Search untuk project retail:

  • Data > Catalog: menampilkan katalog produk 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 bagi Vertex AI Search untuk project retail Anda.

Mengimpor katalog produk

Untuk mengimpor katalog produk, selesaikan serangkaian langkah untuk sumber data Anda. Untuk informasi selengkapnya tentang katalog produk, lihat Mengimpor informasi 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.
  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, lalu pilih negara penjualan dan bahasa Merchant Center yang ingin 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 Skema Katalog Produk Retail sebagai skema.
  5. Masukkan lokasi Cloud Storage data Anda.
  6. Jika penelusuran tidak diaktifkan, pilih tingkat produk.

    Anda harus memilih tingkat produk jika ini adalah pertama kalinya Anda mengimpor katalog atau mengimpor ulang katalog setelah menghapusnya. Pelajari lebih lanjut tingkat produk. Mengubah tingkat produk setelah Anda mengimpor data memerlukan upaya yang signifikan.

    Penting: Anda tidak dapat mengaktifkan penelusuran project dengan katalog produk yang telah diserap 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:
  6. Masukkan tabel BigQuery tempat data Anda berada.
  7. Opsional: Di bagian Tampilkan opsi lanjutan, masukkan lokasi bucket Cloud Storage dalam 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 secara permanen. Pelajari lebih lanjut tingkat produk. Mengubah tingkat produk setelah Anda mengimpor data memerlukan upaya yang signifikan.

    Penting: Anda tidak dapat mengaktifkan penelusuran project dengan katalog produk yang telah diserap sebagai varian.
  9. Klik Import.

Mengimpor peristiwa pengguna historis

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

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.

  5. Masukkan tabel BigQuery tempat data Anda berada.
  6. Opsional: Masukkan lokasi bucket Cloud Storage dalam 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 dalam 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 penayangan

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

Untuk membuat konfigurasi penayangan, selesaikan langkah-langkah berikut:

  1. Di panel Konfigurasi penayangan, klik Buat konfigurasi penayangan.
  2. Di halaman Buat Konfigurasi Penayangan, pilih Telusuri sebagai produk yang akan menggunakan konfigurasi penayangan.
  3. Beri nama untuk konfigurasi penayangan Anda.

    Nama harus terdiri dari 1.024 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. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.
  5. Klik Lanjutkan.
  6. Pilih apakah akan mengaktifkan faset dinamis untuk konfigurasi penayangan ini atau tidak.
  7. Pilih atau buat kontrol penayangan untuk mengoptimalkan penelusuran Anda.

    Untuk mengetahui informasi selengkapnya tentang kontrol, lihat Membuat dan mengelola kontrol.

{i>Dashboard/<i}Dasbor

Setelah Anda menyelesaikan konfigurasi awal project, konsol Search for Retail akan menampilkan status sistem Vertex AI Search untuk project retail Anda. Konsol memungkinkan Anda mengelola resource dan memantau aktivitas.

Buka Search for Retail console

Menyiapkan autentikasi untuk aplikasi

Anda harus menyiapkan autentikasi sehingga aplikasi, seperti situs e-commerce, dapat mengakses Vertex AI Search untuk retail:

  • Akun Layanan. Aplikasi menggunakan akun layanan untuk mengautentikasi panggilan ke Product. Untuk menyiapkan akun layanan, lihat Membuat akun layanan di bawah.

  • Kunci API. Aplikasi menggunakan kunci API untuk panggilan ke metode userEvents.Collect. Anda hanya perlu menyiapkan metode autentikasi ini jika ingin merekam peristiwa pengguna dari browser pengguna melalui piksel JavaScript atau Google Tag Manager. Untuk menyiapkan kunci API, lihat Membuat kunci API di bawah.

Membuat akun layanan

  1. Buka halaman Credentials di Konsol Google Cloud.

  2. Pilih project tempat Anda membuat akun layanan (project mungkin sudah dipilih).

  3. Klik Create credentials, lalu pilih Service account.

    Halaman Create service account akan terbuka.

  4. Pada Detail akun layanan, isi kolom berikut:

    • Nama akun layanan: Nama tampilan untuk akun layanan Anda.
    • ID akun layanan: Nama unik untuk akun layanan Anda. Anda dapat menggunakan ID default yang diberikan, atau menggantinya dengan ID kustom.
    • Deskripsi akun layanan: Opsional. Deskripsi akun.

  5. Klik Create and continue untuk membuat akun layanan dan lanjutkan untuk memberi akun layanan tersebut akses ke project Anda.

  6. Di bagian Grant this service account access to project, tambahkan peran berikut:

    • Akun Layanan > Service Account Token Creator
    • Lainnya > Editor Retail

  7. Opsional: Untuk memberikan akses akun layanan kepada pengguna atau grup yang perlu melakukan tindakan sebagai akun layanan ini, klik Continue, lalu masukkan informasi akun pengguna atau grup.

  8. Klik Selesai untuk menyimpan perubahan.

Menambahkan akun layanan ke lingkungan lokal

Jika ingin melakukan panggilan ke Vertex AI Search untuk retail dengan menggunakan alat command line cURL, Anda harus menyediakan akun layanan di lingkungan lokal.

Untuk mendapatkan file JSON kunci akun layanan, ikuti petunjuk di Membuat dan mengelola akun layanan.

File JSON berisi kunci umum/pribadi untuk akun layanan Anda. File JSON ini adalah satu-satunya salinan kunci untuk akun layanan Anda. Pastikan untuk menyimpannya di lokasi yang aman.

File kunci JSON harus disimpan di lokasi yang dapat diakses dari aplikasi Anda.

cURL menggunakan perintah gcloud auth application-default print-access-token untuk mendapatkan token akses untuk akun layanan Anda menggunakan Google Cloud CLI. Untuk mendownload dan menginstal gcloud CLI, lihat gcloud CLI. Jika Anda menggunakan Cloud Shell, gcloud CLI sudah terinstal.

Variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS tidak akan bertahan jika Anda menutup jendela perintah. Untuk memastikan variabel disetel ke jalur ke file akun layanan saat Anda membuka jendela perintah baru, setel nilai dalam skrip shell inisialisasi.

  export GOOGLE_APPLICATION_CREDENTIALS=path-to-service-account-json-key-file

Membuat Kunci API

Kunci API diperlukan jika Anda menggunakan piksel JavaScript atau tag Tag Manager untuk mencatat 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 Credentials Konsol Google Cloud.

  2. Pada 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 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 Vertex AI Search untuk layanan retail di https://retail.googleapis.com/*.

Contoh

Mengautentikasi menggunakan akun layanan (OAuth 2.0)

Berikut adalah contoh Java dari autentikasi OAuth 2.0 menggunakan akun layanan. Petunjuk yang lebih detail dapat ditemukan di dokumentasi autentikasi. Google memiliki library klien dalam 7 bahasa yang dapat Anda gunakan untuk menerapkan autentikasi OAuth2 di aplikasi Anda. Jika Anda ingin menerapkan HTTP/REST secara langsung, ikuti petunjuk autentikasi REST.

Pada contoh, ganti your-service-account-json-key-file dengan jalur ke file kunci JSON untuk akun layanan Anda.

// Simple Java example of using Google Cloud OAuth client library.
//
// Please see here for the list of libraries in different languages:
// https://developers.google.com/identity/protocols/OAuth2#libraries
//
// The following example depends on the google api client library.
//
// Maven:
//    <dependency>
//      <groupId>com.google.api-client</groupId>
//      <artifactId>google-api-client</artifactId>
//      <version>1.22.0</version>
//    </dependency>
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.GenericUrl;
import com.google.api.client.http.HttpRequest;
import com.google.api.client.http.HttpRequestFactory;
import com.google.api.client.http.HttpResponse;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.http.json.JsonHttpContent;
import com.google.api.client.json.GenericJson;
import com.google.api.client.json.jackson2.JacksonFactory;
import java.io.FileInputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;

public class RetailApiSample {
  public static final String CREATE_PRODUCT_URL =
     "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products";

  public static GoogleCredential authorize() throws Exception {
    return GoogleCredential.fromStream(new FileInputStream("your-service-account-json-key-file"))
        .createScoped(Collections.singleton("https://www.googleapis.com/auth/cloud-platform"))
        .setExpirationTimeMilliseconds(new Long(3600 * 1000));;
  }

  // Build an example product.
  public static GenericJson getProduct() {
    GenericJson categories = new GenericJson()
        .set("categories", Arrays.asList("Electronics > Computers", "Laptops"));
    GenericJson priceInfo = new GenericJson()
        .set("currency_code", "USD")
        .set("price", 800.00)
        .set("original_price", 1000.00);

    return new GenericJson()
        .set("name", "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/[ProductName]")
        .set("title", "Sample Laptop")
        .set("description", "Indisputably the most fantastic laptop ever created.")
        .set("categories", categories)
        .set("price_info", priceInfo)
        .set("availability", "IN_STOCK")
        .set("available_quantity", 1219);
  }

  public static void main(String[] args) {
    try {
      GoogleCredential credential = RetailApiSample.authorize();

      HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
      HttpRequestFactory requestFactory = httpTransport.createRequestFactory();
      HttpRequest request = requestFactory.buildPostRequest(new GenericUrl(CREATE_PRODUCT_URL),
          new JsonHttpContent(new JacksonFactory(), RetailApiSample.getProduct()));
      credential.initialize(request);
      HttpResponse response = request.execute();
      System.out.println("Response content: " + response.parseAsString());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

Langkah selanjutnya