מידע על מאפייני מוצר

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

סוגי מאפיינים

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

• מאפייני מערכת: מאפייני מערכת מוגדרים מראש הם שדות קיימים Product שמספקים מידע נוסף על המוצר. המאפיינים האלה כוללים מאפייני מוצר כמו מותג, זמינות, צבע ומידה. רשימה של כל מאפייני המערכת הזמינים למוצרים מופיעה בProductמאמרי העזרה.

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

  דוגמאות למאפיינים מותאמים אישית שנמצאים ב-20 המובילים:

  • קו המוצרים שאליו המוצר הזה שייך
  • נפח המכירות של המוצר בחנות
  • אירוע שמתאים ללבוש
  • מבצעים ושוברים שרלוונטיים למוצר הזה
  • פופולריות המוצרים באתר כולו
  הערה: 20 המאפיינים המותאמים אישית המובילים משתנים מדי חודש. המאפיינים שנבחרו מופיעים בדף Controls (אמצעי בקרה) במסוף של AI Commerce Search ב-Gemini Enterprise for Customer Experience. כדי לגשת אליו, לוחצים על הכרטיסייה פרמטרים להשוואה בדף פרמטרים להשוואה.

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

  ‫inventories.price ו-inventories.originalPrice הם מאפיינים מספריים של מערכת שהוגדרו מראש על ידי AI Commerce Search. אפשר ליצור מאפיינים מותאמים אישית ברמת המלאי, שיכולים להיות טקסטואליים או מספריים. כברירת מחדל, אפשר להוסיף לאינדקס מאפיינים ברמת מלאי שטחי הפרסום. אי אפשר להגדיר סינון דינמי וסינון שניתן לחיפוש במאפיינים ברמת מלאי שטחי הפרסום.

הערה: מומלץ מאוד לספק ערכים למאפייני מערכת מוגדרים מראש ב-Product, כמו מותג, צבע ומידה. אפשר גם לכלול מאפיינים מותאמים אישית שמוגדרים באמצעות Product.attributes.

הגדרות מאפיינים זמינות

הגדרות התצורה של המאפיינים משפיעות על התנהגות החיפוש וההמלצות באתר.

הגדרות אישיות	תיאור	מאפייני מערכת	מאפיינים מותאמים אישית	מאפיינים ברמת המלאי
זמינות בחיפוש	אפשר לחפש את המאפיין הזה באמצעות שאילתות חיפוש, וכך להגדיל את ההיזכרות במאפיין (רק מאפייני טקסט).	תמיד פועל (טקסט בלבד)	מושבת כברירת מחדל (אפשר להפעיל אותו; טקסט בלבד).	לא נתמך
זמינות להוספה לאינדקס	אפשר לסנן ולחפש באמצעות המאפיין הזה.	פועלים כל הזמן	מופעל כברירת מחדל (אפשר להשבית אותו).	מערכת: תמיד מופעל התאמה אישית: מופעל כברירת מחדל (אפשר להשבית).
סינון דינמי	בחיפוש Google אפשר להשתמש במאפיין הזה באופן אוטומטי כהיבט דינמי, על סמך התנהגות המשתמשים בעבר, כמו קליקים על היבטים וצפיות בהם (רק מאפייני טקסט).	מופעל כברירת מחדל (אם indexability = True) (אפשר להשבית אותו).	מופעל כברירת מחדל (אם indexability = True) (אפשר להשבית אותו).	לא נתמך
ניתן לסינון (תצוגה מקדימה)	אפשר להשתמש במאפיין הזה בביטויי סינון של Recommendations AI. האפשרות הזו רלוונטית רק למאפייני טקסט.	ההגדרה מושבתת כברירת מחדל (אפשר להפעיל אותה לטקסט, למעט FulfillmentInfo ו-Title).	מושבת כברירת מחדל (אפשר להפעיל אותו לטקסט).	נתמך רק ב-availability=IN_STOCK
התאמה מדויקת	המאפיין הזה רלוונטי רק למאפיינים מותאמים אישית מסוג טקסט. כדי להפעיל את האפשרות 'חיפוש מדויק', צריך להגדיר את האפשרות 'ניתן להוספה לאינדקס' למצב 'מופעל'.	לא נתמך	מושבת כברירת מחדל (אפשר להפעיל אותו).	לא נתמך

החיפוש מתבסס על הגדרות המאפיינים הבאות:

• ניתן להוספה לאינדקס: אפשר להשתמש במאפיין הזה כדי לסנן ולחלק את התוצאות בחיפוש.
• פילוח דינמי: מערכת החיפוש יכולה להשתמש אוטומטית במאפיין הזה כפילוח דינמי על סמך התנהגות משתמשים בעבר, כמו קליקים על פילוחים וצפיות. כדי להפעיל סינון דינמי של מאפיין, צריך להגדיר את המאפיין Indexable כ-true.
• ניתן לחיפוש: אפשר לחפש את המאפיין הזה באמצעות שאילתות חיפוש, מה שמגדיל את ההיזכרות במאפיין. האפשרות הזו רלוונטית רק למאפייני טקסט.
• ניתן לאחזור: אם הערך הוא true, החיפוש מחזיר את המאפיין הזה בתשובות לשאילתות חיפוש. אם הערך של כל המאפיינים הוא false, תוצאות החיפוש יכללו רק את שם המוצר או (במקרה של וריאציות) את שם המוצר ופרטי הצבע. השדה RetrievableFields ב-REST הוצא משימוש במוצרים. במקום זאת, אפשר להשתמש באמצעי הבקרה הניתן לאחזור באתר כולו.

ההמלצות מתבססות על הגדרות המאפיינים הבאות:

• ניתן לסינון (גרסת Public Preview): אפשר להשתמש במאפיין הזה בביטויי סינון של המלצות. האפשרות הזו רלוונטית רק למאפייני טקסט.

ניתן להוספה לאינדקס

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

• מאפייני מערכת: האפשרות 'יצירת אינדקס' תמיד מופעלת עבור מאפייני מערכת מוגדרים מראש. אי אפשר להשבית את ההגדרה הזו למאפייני מערכת.
• מאפיינים מותאמים אישית: מופעל כברירת מחדל. אפשר להשבית את האפשרות להוספה לאינדקס לכל מאפיין מותאם אישית. אם אתם מתכננים להפוך אינדקס של מאפיינים מותאמים אישית לזמין לחיפוש, הוא צריך להתאים לתבנית הביטוי הרגולרי [a-zA-Z0-9][a-zA-Z0-9_]*. לדוגמה, key0LikeThis או KEY_1_LIKE_THIS.
• מאפיינים ברמת המלאי: תמיד מופעלים למאפיינים ברמת המלאי של המערכת. אי אפשר לשנות את ההגדרה הזו. ההגדרה הזו מופעלת כברירת מחדל עבור מאפיינים מותאמים אישית ברמת המלאי, אבל אפשר להשבית אותה.
• תלויות: לא רלוונטי

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

סינון דינמי

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

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

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

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

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

זמין בחיפוש

אם מאפיין מוגדר כמאפיין שאפשר לחפש, השליפה של המאפיין הזה בשאילתות חיפוש משתפרת.

אפשר להפעיל את האפשרות 'אפשרות חיפוש' רק לערכים של מאפייני טקסט. היא לא רלוונטית למאפיינים מספריים.

• מאפייני מערכת: מאפייני מערכת טקסטואליים מוגדרים מראש של Product שהגדרות החיפוש שלהם נקבעות על ידי AI Commerce Search. אי אפשר לשנות את ההגדרה הזו.
• מאפיינים מותאמים אישית: מושבת כברירת מחדל. אפשר להפעיל את ההגדרה הזו לכל מאפיין מותאם אישית מסוג טקסט.
• מאפיינים ברמת המלאי: לא נתמכים.
• תלויות: לא רלוונטי
• חיפוש מדויק: החיפוש המטורגט מחזיר תוצאות לשאילתות חיפוש שתואמות למוצר כלשהו בקטלוג שלכם. האפשרות הזו מתאימה למספרים סידוריים. מידע נוסף על האפשרות של התאמה מדויקת לחיפוש

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

סינון המלצות

גרסת טרום-השקה: התכונה הזו זמינה בתוכנית Public Preview.

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

• מאפייני מערכת: מושבת כברירת מחדל. אפשר להפעיל את ההגדרה הזו לכל מאפייני הטקסט המוגדרים מראש במערכת עבור Product, חוץ מFulfillmentInfo ומtitle. לא אפשרי במאפיינים מספריים.
• מאפיינים מותאמים אישית: מושבת כברירת מחדל. אפשר להפעיל את ההגדרה הזו לכל מאפיין טקסטואלי מותאם אישית ב-Product. לא אפשרי במאפיינים מספריים.
• מאפיינים ברמת המלאי: נתמכים רק לערך availability IN_STOCK.
• תלויות: לא רלוונטי

אפשרות חיפוש מדויק

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

בדרך כלל, בשביל מאפיינים מותאמים אישית, השדה ExactSearchableOption שימושי למאפייני מוצרים עם ערך מדויק (כמו ModelId או ManufacturerId). מאפיינים כמו product_id הם שדות אינדקס ראשיים – אפשר לבצע בהם חיפוש מדויק כברירת מחדל. השדה item_id תמיד מופעל להתאמה מדויקת ואי אפשר להשבית אותו.

• כדי למנוע החזרה של פריטים לא קשורים בחיפושים, אל תגדירו את האפשרות 'ניתן לחיפוש' לערך כללי כמו battery.
• כדי למנוע מצב שבו שאילתות חיפוש לא יקבלו מענה, אל תגדירו שדות מיוחדים כמו tag – שיכולים להכיל את הערך המחרוזתי iphone – כחיפוש מדויק. אם תעשו את זה, יכול להיות שהשאילתות האלה יגבילו את התוצאות לכל האייפונים בקטלוג המוצרים.

מידע נוסף על מאפייני מוצרים

שיטות מומלצות להגדרת מאפיינים

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

• טיפול בנתונים אלפאנומריים (מספרי חלקים או מק"טים): מכיוון שהניתוח הבלשני שמוגדר כברירת מחדל מותאם לשפה טבעית, יכול להיות שהוא יסיר תווים מיוחדים כמו מקפים (-) ממספרי חלקים (לדוגמה, המרה של part-123 ל-part ושל 123). כדי לאפשר חיפוש של מספרי החלקים האלה, צריך להשתמש בדגל המאפיין exact-searchable.
• הפתרון העקיף של n-gram: למספרי דגם מורכבים מאוד שמכילים תווים מיוחדים, מומלץ לפצל את המחרוזת ל-n-grams בצינור הנתונים שלכם לפני ההטמעה, ולאחסן את המחרוזת המקורית במאפיין מותאם אישית שמסומן כ-exact searchable: true. הפעולה הזו מאלצת התאמה קפדנית לקטעי ה-n-gram.
• הגבלות על מפתחות של מאפיינים מותאמים אישית: מפתחות של מאפיינים מותאמים אישית לא יכולים להכיל מקפים או תווים מיוחדים. כדי שהמפתח יהיה ניתן לאינדוקס, הוא חייב להתאים באופן מדויק לדפוס הביטוי הרגולרי [a-zA-Z0-9][a-zA-Z0-9_]*. מידע נוסף זמין במאמר מידע על מאפייני מוצרים.
• דרישה לקידוד UTF-8: כל מאפייני המחרוזת והערכים שלהם צריכים להיות מחרוזות בקידוד UTF-8 תקין.

התנהגות המאפיין

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

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

התנהגות של וריאנט ראשי בחיפוש לעומת המלצות

רק פריטים ראשיים מוחזרים בתוצאות החיפוש וההמלצות, אבל AI Commerce Search משפר את האיכות של החיפוש וההמלצות.

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

• במודלים של המלצות, פרטי המוצר ומאפיינים לא עוברים בירושה מהמוצר הראשי לווריאציה. כדי שההמלצות יהיו באיכות אופטימלית, חשוב מאוד שלמוצרים הראשיים ולמוצרי הווריאציות יהיו פרטים מלאים ומדויקים במאפיינים מרכזיים כמו product.categories,‏ product.title,‏ product.attributes וproduct.prices.

טיפול במאפיינים במהלך יצירת אינדקס וסינון

אם אותו מאפיין מוגדר בראשי ובווריאציה, המאפיין בווריאציה הוא חלק מהסינון. לדוגמה, נניח שמאפיין מוגדר למוצר ראשי ולוריאציות שלו (צבע או מידה). ערכי המאפיינים של הווריאנטים משמשים בעיקר לסינון. במהלך הסינון, המערכת בודקת אם אחד מהווריאנטים העיקריים תואם לערך המאפיין. לדוגמה, אם מוצר ראשי מסומן בout-of-stock, אבל לפחות אחת מהווריאציות שלו מסומנת בin-stock, המוצר הראשי זמין בתוצאות החיפוש אם מוחל מסנן in-stock.

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

• במאפיינים שקשורים למלאי, כמו זמינות, אם למוצר הראשי יש וריאציות, צריך להגדיר את הזמינות של המוצר הראשי כ-OUT_OF_STOCK, ואת הזמינות האמיתית (למשל IN_STOCK) צריך להגדיר ברמת הווריאציה. כך, המוצר הראשי נחשב כ'במלאי' כל עוד לפחות וריאציה אחת שלו נמצאת במלאי. במקרה כזה, מסננים כמו availability: ANY("IN_STOCK") מחזירים את המוצר הראשי בצורה נכונה.

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

מאפיינים אופציונליים לסינון

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

לדוגמה, נניח שבדרך כלל אתם מגדירים קטגוריות כמו [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] לסינון. המילוי האוטומטי סופר את הקטגוריות הכי נפוצות לשאילתה מסוימת, ולכן הקטגוריות המוצעות הן lvl1 ו-lvl2 (כל המוצרים שלכם).

שיטות מומלצות לשימוש במאפיינים

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

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

• שימוש בשדות מובנים: אל תסתמכו רק על מאפיינים מותאמים אישית. ממפים את פרטי המוצרים לשדות המובנים Product (brands,‏ colors,‏ sizes ושדות החובה). לשדות מובנים יש השפעה גדולה יותר על יכולת החיפוש, על הוספה לאינדקס ועל אופטימיזציות של רלוונטיות. מאפיינים מותאמים אישית (Product.attributes) מיועדים לנתוני מוצרים שלא מתאימים למאפייני המערכת המוגדרים מראש.

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

  שימו לב: אם אתם משתמשים בחיפוש, השימוש ב-Product.retrievableFields, שבו מאפיינים נכללו עם מוצר בתגובת החיפוש, הוצא משימוש. משתמשים באמצעי הבקרה באתר כולו שאפשר לאחזר.

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

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

מצבי הגדרה

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

• מצב הגדרה ברמת הקטלוג (ברירת מחדל): במצב הזה, ההגדרות של מאפיינים ברמת הקטלוג משמשות כמקור האמת.
• מצב הגדרה ברמת המוצר (הוצא משימוש): במצב הזה, הגדרות המאפיינים ברמת המוצר משמשות כמקור האמת.

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

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

שיטות הגדרה

אפשר להגדיר את תצורת המאפיינים בדרכים הבאות:

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

• השיטה AttributeConfig של API: הגדרת תצורות של מאפיינים ברמת הקטלוג באמצעות API. ההגדרה הזו קובעת מאפיינים לכל המוצרים.

• השיטה Product API (הוצאה משימוש): הגדרת מאפיינים מותאמים אישית ברמת המוצר באמצעות השיטה Product API. השיטה הזו להגדרת מאפיינים לא זמינה למשתמשים חדשים ולא מומלצת.

הגדרת מאפיינים במסוף

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

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

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

הגדרת מאפיינים באמצעות AttributesConfig

משאב ה-API‏ AttributesConfig מאפשר לנהל את הגדרות המאפיינים ברמת הקטלוג.

השדות הבאים מגדירים אפשרויות של מאפיינים ברמת הקטלוג:

• ‫CatalogAttribute.indexableOption: הגדרת האפשרות ליצירת אינדקס של מאפיין.
• ‫CatalogAttribute.dynamicFacetableOption: הגדרת האפשרות של פילוח דינמי של מאפיין.
• ‫CatalogAttribute.searchableOption: הגדרת האפשרות 'ניתן לחיפוש' למאפיין.
• CatalogAttribute.recommendationsFilteringOption (גרסת Preview ציבורית): מגדיר את אפשרות הסינון של ההמלצות לפי מאפיין.

כדי לאחזר את כל הגדרות המאפיינים, משתמשים בשיטה GetAttributesConfig.

עדכון של כמה מאפיינים

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

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

מספר המאפיינים המקסימלי של קטלוג שמותר לכלול בבקשה הוא 1,000.

עדכון של מאפיין ספציפי

השיטות הבאות משמשות לעדכון מאפיינים ספציפיים בקטלוג:

• ‫AddCatalogAttribute: מוסיף הגדרה של מאפיין ספציפי למאפיין בקטלוג.

  מידע נוסף מופיע במאמרי העזרה בנושא API של AddCatalogAttribute.

• ‫ReplaceCatalogAttribute: שינוי של הגדרת מאפיין ספציפי. הפעולה הזו מחליפה את הערך CatalogAttribute שצוין במאפיין AttributesConfig על ידי עדכון מאפיין הקטלוג עם אותו הערך CatalogAttribute.key.

  מידע נוסף מופיע במאמרי העזרה בנושא API של ReplaceCatalogAttribute.

• ‫RemoveCatalogAttribute: מסיר הגדרת מאפיין בודדת מ-AttributesConfig.

  אפשר למחוק רק CatalogAttributes שלא נמצאים בשימוש במוצרים. אם נעשה שימוש ב-CatalogAttribute, הפעולה RemoveCatalogAttribute לא מוחקת אותו, אלא מאפסת את מאפייני ההגדרה שלו לערכי ברירת המחדל. CatalogAttribute.inUse מוגדר ל-True אם המאפיין נמצא בשימוש במוצרים כלשהם.

  מידע נוסף מופיע במאמרי העזרה בנושא API של RemoveCatalogAttribute.

הוצא משימוש

הגדרת מאפיינים באמצעות השיטה Product

השיטה הזו להגדרת מאפיינים לא זמינה למשתמשים חדשים ולא מומלצת.

השדות הבאים מגדירים הגדרות של יצירת אינדקס וחיפוש למוצר ספציפי באמצעות שיטת ה-API‏ Product:

• Product.attributes.indexable.
• ‫Product.attributes.searchable. זמין רק למאפיינים מותאמים אישית.

שיטות מומלצות לבחירת שמות למאפיינים מותאמים אישית ולסידור שלהם

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

כדי להבטיח ביצועים אופטימליים של החיפוש ולהימנע משגיאות אימות, מומלץ לפעול לפי השיטות המומלצות הבאות:

1. כדאי לתת עדיפות למאפייני מערכת מקוריים. לפני שיוצרים מאפיין בהתאמה אישית, כדאי לבדוק אם כבר קיים מאפיין מערכת שמוגדר כברירת מחדל (כמו brands,‏ colorInfo,‏ sizes או materials) לנתונים שלכם. מודלים של AI בבק-אנד מבינים שדות ברירת מחדל הרבה יותר טוב ממאפיינים בהתאמה אישית, והם משתמשים בהם באופן נרחב כדי לשפר את הרלוונטיות וההחזרה של התוצאות.

   • דוגמה: אל תעבירו את פרטי המותג כ-Product.attributes.brand. במקום זאת, ממפים אותו ישירות לשדה ברירת המחדל Product.brands. שומרים מאפיינים מותאמים אישית לנתונים ספציפיים ייחודיים, כמו Product.attributes.sleeve_length.

2. חשוב להקפיד על מוסכמות מתן שמות קפדניות כדי שהדפים יהיו זמינים להוספה לאינדקס. אם אתם מתכוונים להשתמש במאפיין מותאם אישית לסינון, לשימוש בפילטרים או להדגשה, אתם צריכים לסמן אותו כ-Indexable. כדי שהמערכת תוכל לבצע אינדוקס של מפתח מאפיין מותאם אישית, הוא צריך להתאים לדפוס הביטוי הרגולרי [a-zA-Z0-9][a-zA-Z0-9_]*.

   • שם תקין: sleeve_length או KEY_1_LIKE_THIS.
   • שם לא תקין: sleeve-length (אסור להשתמש במקפים, והם ימנעו את הוספת הדף לאינדקס).
   • מגבלות: מפתח המאפיין חייב להיות מחרוזת בקידוד UTF-8 באורך של עד 128 תווים. לכל מוצר יכולים להיות עד 200 מאפיינים מותאמים אישית.

3. הגדרת סוגי ערכים ברורים (טקסט או מספרים). AI Commerce Search מחייב שערכים של מאפיינים מותאמים אישית יוגדרו כטקסטואליים (text) או מספריים (numbers). עליך להגדיר בדיוק אחד מהסוגים האלה למפתח נתון. ניסיון לאכלס את שני המאפיינים text ו-numbers עבור אותו מאפיין יחזיר שגיאה INVALID_ARGUMENT.

   • מאפייני טקסט: מותר להשתמש בעד 400 ערכים לכל מאפיין. אסור להשתמש במחרוזות ריקות (""). כל ערך צריך להיות מחרוזת UTF-8 לא ריקה באורך של עד 256 תווים.
   • מאפיינים מספריים: אפשר להוסיף עד 400 ערכים לכל מאפיין.
   • הערה לגבי פילוח: אם רוצים להשתמש במאפיין מספרי כdynamicFacet, צריך להמיר את סוג הנתונים המספרי למחרוזת Text בצינור הנתונים לפני ההטמעה (למשל, להעביר את 10.99 כ-"10.99"). אחרת, אפשר להשתמש במאפיינים מספריים רק כפילוח סטטי שבו צריך להגדיר באופן ידני וספציפי את טווחי הערכים בבקשת החיפוש.

4. שימוש אסטרטגי בהתאמות מדויקות. ההגדרה 'חיפוש מדויק' מיועדת למחרוזות אלפאנומריות ספציפיות מאוד שאין להן משמעות לשונית, כמו model_name (למשל "WA2300AH3000") או part_number.

   • דוגמה: לא מומלץ להחיל התאמה מדויקת על מאפיינים בהתאמה אישית שמכילים שמות עצם נפוצים באנגלית או מותגים פופולריים. הפעולה הזו מגבילה את תוצאות החיפוש כשהמילים הנפוצות האלה מופיעות בשאילתת חיפוש, וכתוצאה מכך, המוצר לא מופיע בתוצאות החיפוש ושיעורי הקליקים (CTR) נפגעים.