Tentang katalog dan produk

Halaman ini memberikan praktik terbaik untuk membuat informasi katalog dan mengisi data katalog Anda.

Ringkasan

Katalog adalah kumpulan objek produk.

Data katalog yang Anda impor ke Vertex AI Search untuk commerce memiliki pengaruh langsung pada kualitas model yang dihasilkan, dan oleh karena itu, pada kualitas hasil penelusuran dan rekomendasi. Secara umum, semakin akurat dan spesifik informasi katalog yang dapat Anda berikan, semakin berkualitas tinggi model Anda.

Katalog Anda harus selalu diperbarui. Anda dapat mengupload perubahan katalog sesering yang diperlukan; idealnya, setiap hari untuk katalog dengan tingkat perubahan yang tinggi. Anda dapat mengupload (membuat patch) item produk yang ada; hanya kolom yang diubah yang akan diperbarui. Tidak ada biaya untuk mengupload informasi katalog. Untuk mengetahui informasi selengkapnya, lihat Memastikan katalog Anda selalu terbaru.

Cabang katalog

Cabang katalog dengan penelusuran

Jika menggunakan penelusuran, Anda dapat menggunakan cabang katalog untuk menguji data baru yang telah diupload secara offline sebelum menayangkannya di situs Anda.

Anda dapat menggunakan hingga tiga cabang, yang diidentifikasi sebagai 0, 1, dan 2. Situs aktif Anda mengarah ke default_branch untuk data katalognya. Tentukan cabang mana yang merupakan default_branch live Anda (default disetel ke cabang 0) menggunakan setDefaultBranch atau tab Data di Search for commerce console. Situs Anda kemudian menggunakan data katalog yang disediakan oleh cabang yang ditunjuk oleh default_branch.

Sebagai contoh, misalkan default_branch disetel ke ID cabang 0, sehingga situs Anda menggunakan data katalog yang telah Anda upload ke cabang tersebut. Anda dapat mengupload data katalog baru ke cabang 1 dan melihat pratinjaunya. Setelah mengonfirmasi bahwa katalog telah diupload dengan benar, Anda dapat beralih ke cabang 1 sebagai default_branch aktif.

Cache katalog dapat memerlukan waktu hingga 30 menit untuk diperbarui setelah pengalihan cabang.

Jika Anda menggunakan rekomendasi, sebaiknya gunakan hanya cabang default karena penundaan update selama peralihan cabang. Jika perbedaan data antar-cabang besar, penundaan pembaruan dapat berdampak negatif pada hasil prediksi.

Informasi produk yang diperlukan

Kolom berikut wajib diisi; Anda harus memberikan nilai untuk kolom tersebut saat membuat item produk di katalog. Nilai tersebut juga harus sesuai dengan nilai yang digunakan dalam database produk internal Anda, dan harus mencerminkan produk yang diwakili secara akurat, karena disertakan dalam pelatihan model Anda.

Dalam beberapa kasus, kolom lain juga wajib diisi. Lihat daftar lengkap semua kolom produk di halaman referensi Product.

Semua informasi produk yang Anda berikan dapat digunakan untuk meningkatkan kualitas rekomendasi dan hasil penelusuran. Pastikan untuk memberikan sebanyak mungkin kolom.

Kategori katalog

Bagian ini menjelaskan struktur katalog dan cara menentukannya untuk digunakan dalam taksonomi dan pemfilteran.

Struktur katalog

Kolom categories dalam katalog harus berisi jalur kategori yang paling terperinci untuk setiap produk. Kategori induk tidak wajib dan tidak boleh disertakan.

Berikut adalah contoh cara menyusun katalog Anda:

• Benar: categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"]
• Salah: categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]

Kategori induk

Kategori induk untuk produk tertentu tidak boleh disertakan dalam kolom categories. Pemfilteran untuk penjelajahan harus ditangani menggunakan atribut kustom lainnya.

Penamaan kategori

Nama kategori harus dipilih dengan cermat untuk menghindari pengenalan kata kunci yang salah dan meningkatkan performa. Menggunakan istilah yang lebih spesifik dan akurat akan meningkatkan relevansi dan mengurangi masalah.

• Direkomendasikan: Makanan Beku > Buah Beku
• Tidak direkomendasikan: Buah & Sayuran Beku > Buah Beku

Struktur tingkat katalog khusus project

Buat satu katalog untuk setiap bahasa. Jika beroperasi di beberapa negara, Anda dapat menggunakan katalog yang sama untuk memberikan hasil penelusuran di berbagai negara.

Berikan harga, yang ditentukan melalui inventaris lokal, dalam mata uang yang sama di seluruh negara. Jika harga berbeda di setiap negara, buat inventaris lokal untuk setiap negara. Tentukan harganya di sana.

Untuk mengoptimalkan hasil penelusuran, berikan nama setiap negara sebagai SearchRequest.entity dan UserEvent.entity. Gunakan entity negara hanya untuk tujuan penentuan peringkat.

Ringkasan hierarki produk

Saat mengelola katalog produk di Vertex AI Search untuk commerce, memahami cara menangani atribut untuk produk utama dan varian sangat penting untuk penelusuran dan rekomendasi yang efektif. Penetapan SKU produk menentukan hierarki katalog.

Jenis penunjukan produk

Ada tiga jenis penetapan produk:

1. Item primer atau induk ditampilkan dalam rekomendasi atau hasil penelusuran dan berfungsi sebagai penampung atau grup logis dari item serupa. Produk utama dapat berupa item individual (tingkat SKU) dan grup item serupa (grup SKU).

2. Varian atau item turunan adalah versi spesifik dan individual dari produk utama kelompok SKU. Misalnya, jika produk utama adalah Kemeja V-neck,variannya bisa berupa Kemeja V-neck cokelat, ukuran XL dan Kemeja V-neck putih, ukuran S.

3. Item koleksi adalah paket produk utama atau produk varian, seperti set perhiasan dengan kalung, anting, dan cincin. Struktur hierarkis yang serupa dengan produk dan varian, koleksi mengelompokkan produk utama terkait. Pelanggan tidak dapat membelinya secara langsung, tidak banyak digunakan, dan hanya tersedia di penelusuran.

Contoh produk

Sebagai contoh, menurut jenis penunjukan produk ini, item grosir lebih baik dikatalogkan sebagai produk utama, yang masing-masing terdiri dari satu produk SKU, seperti"bananas, fresh".

Di sisi lain, kaos akan lebih baik jika disusun secara hierarkis, sebagai produk utama dengan serangkaian variannya. Setiap varian mewakili SKU individu (untuk setiap ukuran) dan setiap item utama mewakili grup SKU, di mana setiap SKU adalah ukuran yang berbeda untuk satu gaya kaus yang menyeluruh. Struktur pengelompokan menurut SKU ini memungkinkan panel hasil penelusuran dan rekomendasi menampilkan berbagai gaya kaus. Hal ini memungkinkan pembeli melihat detail utama (gaya) tertentu untuk memilih varian (ukuran) yang akan dibeli.

Koleksi mengelompokkan produk terkait yang mungkin dibeli pelanggan. Untuk merepresentasikannya secara akurat dalam model penyusunan ulang peringkat, Vertex AI Search untuk commerce memiliki logika yang mengatribusikan pembelian kepada mereka. Misalnya: Pembeli mengklik produk dalam set seprai, lalu menambahkan ke keranjang atau membeli produk utama dalam koleksi tersebut. Koleksi tersebut dikreditkan dengan pembelian itu, dan model secara akurat merepresentasikan popularitas dan nilai koleksi.

Ada juga jenis katalog khusus varian, yang kini tidak digunakan lagi. Jenis katalog ini hanya dapat digunakan dengan rekomendasi. Untuk katalog khusus varian, ingestionProductType disetel ke variant selama impor. Produk utama disimpulkan untuk setiap varian, berdasarkan ID produk utama yang ditentukan untuk setiap varian.

Menyiapkan katalog produk

Saat merencanakan katalog produk, Anda harus memutuskan apakah katalog tersebut berisi produk yang ditetapkan sebagai hanya produk utama, produk utama dan varian, atau campuran dari kedua pengaturan tersebut. Pikirkan dalam hal struktur SKU produk Anda. Produk Anda dapat berupa item utama, yang mungkin atau mungkin tidak memiliki varian.

Berdasarkan cara SKU produk Anda ditetapkan, pertimbangkan opsi Anda untuk menyiapkan katalog produk:

• Anda ingin SKU ditampilkan sebagai hasil penelusuran atau rekomendasi individual: SKU=primary
• SKU Anda harus menjadi bagian dari grup SKU serupa: SKU=varian, grup SKU=utama
• Kombinasi keduanya: SKU=utama, SKU=varian, grup SKU=utama

Jika halaman detail produk Anda menampilkan opsi, pemilih ukuran, atau warna, opsi ini biasanya diupload sebagai varian ke katalog produk Anda. Pertimbangkan apakah Anda ingin berbagai jenis produk yang sama dengan atribut berbeda seperti ukuran dan warna muncul sebagai satu hasil penelusuran atau terpisah. Misalnya, untuk buku, Anda ingin memutuskan apakah Anda ingin SKU sampul keras dan SKU sampul lunak dari buku yang sama muncul sebagai hasil penelusuran terpisah (SKU = utama), atau sebagai satu hasil (SKU = varian, grup SKU = utama).

Saat menyiapkan katalog produk, perlu diingat bahwa rekomendasi dan hasil penelusuran hanya menampilkan item utama.

Produk utama minimal

Jika Anda menentukan bahwa katalog Anda harus memiliki produk utama dan varian, yaitu grup SKU dan SKU, tetapi Anda hanya memiliki SKU sekarang, Anda perlu membuat produk utama untuk grup SKU. Warna primer ini terkadang disebut warna primer virtual atau warna primer palsu.

Primary ini hanya perlu berisi informasi minimal: id, title, dan categories.

Jika type tidak ditentukan, jenis produk akan ditetapkan secara default ke utama. Jika Anda mengimpor, Anda tidak perlu menentukan name. Untuk mengetahui informasi selengkapnya, lihat bagian sebelumnya, Informasi produk yang diperlukan.

Impor katalog

Jika katalog Anda ada di Cloud Storage atau BigQuery atau penyimpanan lain, lakukan impor data massal.

Untuk mengetahui informasi mendetail tentang cara mengupload katalog, lihat Mengimpor informasi katalog.

Inventaris produk

Inventaris produk mencakup:

• Harga, baik harga saat ini maupun harga asli

• Ketersediaan, seperti tersedia, habis, inden, dan praorder

• Jumlah yang tersedia

• Informasi pemenuhan pesanan seperti pengambilan di toko, pengiriman ke toko, dan pengiriman pada hari berikutnya

Ada dua tingkat inventaris: tingkat produk dan lokal.

Inventaris tingkat produk

Untuk retailer yang hanya menjual secara online, inventaris ditentukan di tingkat produk. Harga, ketersediaan, dan data inventaris lainnya ditetapkan untuk setiap produk dalam katalog.

Untuk mengetahui informasi selengkapnya tentang inventaris tingkat produk, termasuk cara mempertahankan data inventaris, lihat Memperbarui inventaris untuk Vertex AI Search untuk commerce.

Inventaris lokal

Retailer yang memiliki toko fisik dan toko online harus menyimpan informasi inventaris per toko. Mereka menggunakan inventaris lokal untuk melakukannya.

Ada dua kolom produk yang dapat digunakan untuk menyimpan inventaris lokal. Kedua kolom adalah daftar lokasi (ID tempat) dengan informasi inventaris terkait:

• Product.fulfillmentInfo. Metode pengambilan dan pengiriman di setiap lokasi toko

• Product.localInventories. Informasi harga, atribut produk, serta metode pengambilan dan pengiriman di setiap lokasi toko

Anda dapat menggunakan salah satu atau kedua kolom untuk informasi tingkat toko.

Untuk mengetahui informasi selengkapnya tentang inventaris lokal, lihat Memperbarui inventaris lokal untuk Vertex AI Search for Commerce.

Struktur inventaris varian utama

Struktur data inventaris varian utama terdiri dari produk utama, varian, dan inventaris lokal:

• Produk utama: Data produk utama disimpan tanpa harga.

• Produk varian (dengan harga terendah di seluruh negara): Misalnya, varian untuk produk utama (warna, ukuran) harus memiliki harga terendah di seluruh negara. Data harga varian di-roll up ke data produk utama, dan harga utama digunakan untuk tujuan peringkat. Harga khusus lokasi diabaikan.

• Inventaris lokal (harga khusus wilayah atau toko): Menggunakan informasi harga dari inventaris lokal dalam pengurutan ulang pada waktu penayangan

• Atribut produk utama: Produk utama hanya boleh menyertakan atribut yang umum untuk semua varian terkaitnya.

Metrik kualitas data katalog

Halaman Kualitas data di Konsol penelusuran untuk e-commerce menilai apakah Anda perlu memperbarui data katalog untuk meningkatkan kualitas hasil penelusuran dan membuka tingkatan performa penelusuran.

Tabel berikut menjelaskan metrik kualitas yang digunakan Vertex AI Search untuk commerce guna membantu Anda mengevaluasi data produk. Untuk mengetahui detail tentang cara melihat metrik kualitas data dan tingkat performa penelusuran di konsol Penelusuran untuk e-commerce, lihat Memanfaatkan tingkat performa penelusuran.

Skema produk

Saat mengimpor katalog dari BigQuery, gunakan skema produk Vertex AI Search untuk e-commerce berikut guna membuat tabel BigQuery dengan format yang benar dan memuatnya dengan data katalog Anda. Kemudian, impor katalog.

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]