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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ניתן להוספה לאינדקס: אפשר להשתמש במאפיין הזה כדי לסנן ולחלק את התוצאות בחיפוש.
  • היבטים דינמיים: מערכת החיפוש יכולה להשתמש במאפיין הזה באופן אוטומטי כהיבט דינמי על סמך התנהגות המשתמשים בעבר, כמו קליקים על היבטים וצפיות בהיבטים. כדי להפעיל סינון דינמי של מאפיין, צריך להגדיר את המאפיין Indexable כ-true.
  • ניתן לחיפוש: אפשר לחפש את המאפיין הזה באמצעות שאילתות חיפוש, מה שמגדיל את ההיזכרות במאפיין. האפשרות הזו רלוונטית רק למאפייני טקסט.
  • ‫Retrievable: אם המאפיין הזה מוגדר כ-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. אי אפשר לשנות את ההגדרות האלה.
  • מאפיינים מותאמים אישית: מושבת כברירת מחדל. אפשר להפעיל את ההגדרה הזו לכל מאפיין מותאם אישית מסוג טקסט.
  • מאפיינים ברמת המלאי: לא נתמכים.
  • תלויות: לא רלוונטי
  • ניתן לחיפוש מדויק: החיפוש המטורגט מחזיר תוצאות לשאילתות חיפוש שתואמות למוצר כלשהו בקטלוג שלכם. האפשרות הזו מתאימה למספרים סידוריים. מידע נוסף על האפשרות של חיפוש מדויק

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

סינון ההמלצות

יש הגבלה של 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-gram בפייפליין הנתונים שלכם לפני ההטמעה, ולאחסן את המחרוזת המקורית במאפיין מותאם אישית שמסומן כ-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 לגבי וריאציות, ומאפשר לאחזר פרטים בתשובות לחיפושים.

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

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

מצבי הגדרה

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

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

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

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

שיטות הגדרה

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

  • המסוף של 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 מאפשר לכם לנהל הגדרות של מאפיינים ברמת הקטלוג.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שיטות מומלצות למתן שמות ולסידור של מאפיינים מותאמים אישית

כשמרחיבים את נתוני המוצרים מעבר לסכימה המוגדרת מראש, האופן שבו נותנים שמות למאפיינים המותאמים אישית ופורמטים אותם משפיע ישירות על היכולת של 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) מושפעים לרעה.