ניהול פרטי הקטלוג

בדף הזה מוסבר איך לנהל את פרטי המוצרים אחרי שמייבאים קטלוג ל-AI Commerce Search. אתם יכולים לקרוא מוצרים בקטלוג, לכתוב מוצרים ולמחוק אותם.

כדי שהקטלוג שלכם יהיה עדכני כשפרטי המוצרים משתנים, אתם יכולים לייבא את הקטלוג באותה דרך שבה ייבאתם אותו בפעם הראשונה. לקבלת עזרה בייבוא הקטלוג, אפשר לעיין במאמר בנושא ייבוא פרטי קטלוג.

יצירה, גישה וניהול של מדריכים למוצרים

במדריך הזה מוסבר איך להשתמש בשיטות של API, שמבצעות את הפעולות הבאות:

• יצירת מוצר
• קבלת מוצר
• עדכון מוצר
• מחיקת מוצר

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

יצירת מוצר

במדריך הזה מוסבר איך ליצור מוצר בודד.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

קבלת מוצר

במדריך הזה מוסבר איך לאחזר פריט מוצר.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

עדכון מוצר

במדריך הזה מוסבר איך לעדכן מוצר בקטלוג.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

מחיקת מוצר

במדריך הזה מוסבר איך למחוק מוצר מקטלוג.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

העלאת פריט מוצר בודד

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "PRODUCT_TITLE",
      "categories": "CATEGORY"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "CATEGORY"
  \],
  "title": "PRODUCT_TITLE",
  "availability": "IN_STOCK"
}

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

עדכון פרטי המוצר

כשהקטלוג של המוצרים משתנה, אתם יכולים לרענן אותו על ידי העלאת שינויים במוצרים, כמו מוצרים חדשים, מחירים וסטטוס מלאי בזמן אמת. אתם יכולים להעלות רק מוצרים שהוספתם או שיניתם, ולא צריך להעלות מחדש את כל הקטלוג.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value"
    }" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "Parent category > Child category"
  \],
  "title": "new product title",
  "availability": "IN_STOCK"
}

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

מחיקת פרטי המוצר

למרות שממשק ה-API מספק דרך למחוק מוצרים מהקטלוג, חשוב לזכור שאם מתעדים אירוע משתמש שקשור לפריט מוצר שנמחק, ממשק ה-API לא יכול לעבד את אירוע המשתמש בצורה תקינה והוא עלול להימחק. בנוסף, הכללת נתונים היסטוריים של קטלוגים משפרת את איכות המודל וחשובה מאוד כדי לקבל המלצות טובות ותוצאות חיפוש טובות.

מומלץ להגדיר את availability של מוצרים שיצאו משימוש כ-OUT_OF_STOCK במקום למחוק אותם.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

אחזור פריט מוצר

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

{
    "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
    "id": "PRODUCT_ID",
    "primaryProductId": "PRODUCT_ID",
    "type": "PRIMARY",
    "categories": \[
      "Parent category > Child category"
    \],
    "title": "product title",
    "availability": "IN_STOCK"
}

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

הצגת מידע מצטבר על הקטלוג

בכרטיסייה קטלוג בדף נתונים במסוף של AI Commerce Search ב-Gemini Enterprise for Customer Experience אפשר לראות מידע מצטבר על הקטלוג ולצפות בתצוגה מקדימה של מוצרים שהועלו.

הערכת איכות הנתונים בקטלוג

כדי להעריך את איכות הנתונים בקטלוג:

1. עוברים לדף איכות הנתונים במסוף של AI Commerce Search ב-Gemini Enterprise for Customer Experience.
   
   כניסה לדף 'איכות הנתונים'

   בדף איכות הנתונים אפשר לבדוק אם צריך לעדכן את נתוני הקטלוג כדי לשפר את איכות תוצאות החיפוש ולשדרג את רמת הביצועים בחיפוש.

מידע נוסף על בדיקת האיכות של נתוני החיפוש ועל הצגת רמות הביצועים של החיפוש זמין במאמר הצגת רמות הביצועים של החיפוש.

במאמר הזה מפורטים מדדי האיכות של הקטלוג.

שינוי סוגי המוצרים

כשמייבאים מוצר, אפשר לציין אם סוג המוצר הוא ראשי, וריאציה או אוסף. אם סוג המוצר השתנה או צוין בצורה שגויה, צריך למחוק את המוצר וליצור אותו מחדש עם הסוג המעודכן.

סוג המוצר יכול להיות TYPE_UNSPECIFIED, PRIMARY, VARIANT או COLLECTION. פרטים נוספים מופיעים בproduct.Type במאמרי העזרה.

שינוי ההגדרות ברמת המוצר

כדי לייבא קטלוג באמצעות Merchant Center, צריך לציין אם המוצרים הם מוצרים ראשיים או וריאנטים.

אם יש שינוי ברמות המוצר או שהן צוינו בצורה שגויה, צריך לפעול לפי השלבים הבאים כדי לתקן את ההגדרה שלהן. כדי להשלים את התהליך הזה, צריך להיות לכם תפקיד אדמין של Retail ב-IAM.

1. חשוב לוודא שלא מתבצעים ייבואים בזמן שאתם מגדירים מחדש את רמות המוצרים. כך מוודאים שהנתונים לא מועלים ברמה הלא נכונה.

2. מחיקה של כל פריטי המוצרים. מידע נוסף מפורט בproducts.delete. לפני שממשיכים לשלב הבא, צריך לוודא שהקטלוג ריק לגמרי.

3. כדי לשנות את ההגדרה ברמת המוצר, צריך לייבא מחדש את הנתונים.

   התהליך הזה תלוי בשיטת הייבוא. פועלים לפי ההליך המתאים במאמר ייבוא פרטי קטלוג כדי להגדיר את רמות המוצרים בהתאם להגדרה החדשה.

4. מייבאים את הקטלוג החדש עם הגדרת הרמה ששונתה, באמצעות ההליך שבחרתם במאמר ייבוא פרטי קטלוג.

5. שיפור הביצועים של כל המודלים הקיימים.

   כדי לכוונן מודל, עוברים אל דף המודלים, לוחצים על שם המודל כדי להציג את דף הפרטים שלו, ואז לוחצים על כוונון ידני בסרגל הלחצנים.

   לדף Models

   פרטים על עלויות ההתאמה זמינים במאמר בנושא תמחור.