טיפים כלליים

בדף הזה מתוארים שלבים לפתרון בעיות שיכולים לעזור לכם אם נתקלתם בבעיות בשימוש ב-Vision API Google Product Search.

תוצאות חיפוש

מהו המספר המקסימלי של תוצאות שמוחזרות?

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

האם אפשר להגדיר סף ניקוד לתוצאות?

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

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

יש דרך לדעת למה תוצאה מסוימת דורגה גבוה יותר מתוצאה אחרת?

נכון לעכשיו, ב-Vision API Google Product Search אין תכונות שמסבירות למה תוצאה מסוימת הוחזרה.

מה ההבדל בין שימוש ב-productGroupedResults לבין שימוש בתכונה Object Localizer של Vision API?

בתגובה productGroupedResults תוחזר רשימה של פריטים שזוהו, התווית והניקוד החזויים שלהם, תיבות התוחמות שלהם ורשימה מדורגת של תוצאות חיפוש מוצרים לכל פריט. התשובה הזו שקולה לשליחה של תמונת השאילתה קודם לתכונה Object Localizer של Vision API, ואז שליחה של התמונה יחד עם תיבה תוחמת (bounding box) של כל פריט מוצר (מסונן לפי התוויות הרלוונטיות) ל-Google Product Search ב-Vision API.

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

אם אני יודע את המיקום של מוצר בתמונה, האם כדאי לחתוך את התמונה לפני שאני שולח שאילתה ל-API עם התמונה?

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

תמונות לדוגמה

מהן תמונות מוצר טובות לדוגמה?

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

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

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

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

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

איך אפשר לקבל עוד תמונות להמחשה של המוצרים?

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

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

האם הוספת שיפורים לנתונים של קבוצת המוצרים שלי תעזור לשפר את הדיוק של ה-API?

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

ניהול נתונים

מה הדרך המומלצת לעדכן קבוצת מוצרים בסביבת הייצור?

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