הגדרת התוצאות לממשק המשתמש

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

מושגים שקשורים לווידג'ט חיפוש Google

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

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

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

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

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

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

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

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

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

ממשק המשתמש של נתונים לא מובְנים ונתוני אתרים מציע את אפשרויות החיפוש הבאות בהתאמה אישית:

• חיפוש (פנייה אחת)
• חיפוש עם תשובה (חיפוש בשלב אחד עם סיכום)
• חיפוש עם שאלות המשך (חיפוש בכמה שלבים)

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

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   Gemini Enterprise

2. לוחצים על שם האפליקציה שרוצים לערוך.

3. בתפריט הניווט, לוחצים על Configurations.

4. לוחצים על הכרטיסייה UI.

5. עורכים את השדות בכרטיסייה.

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

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

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

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

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

• כותרת: כותרת של פריט שמשתמש יכול ללחוץ עליה כדי לבחור את הפריט הזה בתוצאת חיפוש.
• תמונה ממוזערת. כתובת ה-URL של תמונה שתוצג לצד שם הפריט בתוצאת חיפוש.
• כתובת URL. כתובת URL שהמשתמש מועבר אליה כשהוא לוחץ על שם הפריט.

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

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

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

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   Gemini Enterprise

2. לוחצים על השם של אפליקציית החיפוש שרוצים לערוך.

3. לוחצים על Configurations (הגדרות).

4. לוחצים על הכרטיסייה UI.

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

6. מרחיבים את הקטע Configure fields in results.

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

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

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

   1. לוחצים על התיבה כותרת ובוחרים שדה למיפוי הכותרות של תוצאות החיפוש. אם לא רוצים שהכותרות יופיעו בתוצאות החיפוש, בוחרים באפשרות ללא.

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

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

10. כדי להוסיף עוד שדות לתוצאות החיפוש:

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

    2. לוחצים על החץ לצד התיבה Text 1 כדי להציג את התיבה Template. השדה {value} בתיבה Template מייצג את ערך השדה שיוצג בתוצאת החיפוש. מוסיפים טקסט לפני או אחרי השדה {value} (או בשני המקומות) כדי לתת הקשר לערך בתוצאות החיפוש. לדוגמה, נניח שבחרתם באפשרות price בתיבה טקסט 1, וערך המחיר של פריט מסוים הוא 42. אם מעדכנים את השדה Template לערך "Total Price: {value} USD", אז "Total Price: 42 USD" מוצג בתוצאות החיפוש של הפריט הזה.

    3. כדי להוסיף עוד שדות, חוזרים על השלבים האלה בתיבות טקסט 2 וטקסט 3.

11. כדי לקבוע את הגדרות המאפיינים:

    1. מרחיבים את הקטע Facet settings.

    2. בוחרים שדה שרוצים להגדיר כהיבט ומזינים שם לתצוגה.

    3. כדי להוסיף עוד מאפיינים, לוחצים על הוספת מאפיין.

12. בודקים בחלונית תצוגה מקדימה שהשינויים מוצגים בצורה נכונה.

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

הערה: למידע על הפעלת ההשלמה האוטומטית, ראו הגדרת ההשלמה האוטומטית.
למידע על הפעלת משוב, קראו את המאמר הגדרת משוב.

הצגת השמות שהאדמין הגדיר למקורות הנתונים

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

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

המסוף

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   אל Gemini Enterprise

2. לוחצים על שם האפליקציה שרוצים לערוך.

3. בתפריט הניווט, לוחצים על Configurations.

4. לוחצים על הכרטיסייה ממשק משתמש לחיפוש.

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

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

REST

מעדכנים את השדה uiSettings.sourceAdminDisplayNameEnabled במשאב WidgetConfig של האפליקציה באמצעות קריאה ל-method‏ engines.widgetConfigs.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
  -d '{
    "uiSettings": {
      "sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
    }
  }'

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
  • ‫eu למספר אזורים באיחוד האירופי
  • ‫global למיקום הגלובלי
  מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
• ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
• ‫LOCATION_ID: המיקום הגיאוגרפי של מאגר הנתונים, למשל global. מידע נוסף מופיע בקטע מיקומים.
• ‫APP_ID: מזהה האפליקציה.
• ‫SOURCE_ADMIN_DISPLAY_NAME_ENABLED: ערך בוליאני. מציינים את הערך true כדי להציג את שם התצוגה של מקורות הנתונים שהאדמין הגדיר, או את הערך false כדי להציג את סוג המחבר.

השלבים הבאים

• תצוגה מקדימה של תוצאות החיפוש