Note: Vertex AI Search is being renamed to Agent Search. We are in the process of updating content to reflect the new branding.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הדגשה והסתרה של המלצות למדיה

הערה: התכונה הזו היא מוצר בגרסת טרום-GA, והשימוש בה כפוף ל "תנאי השימוש במוצרים בגרסת טרום-GA" בתנאים הספציפיים לשירותי GCP. יכול להיות שהתמיכה במוצרים ובתכונות בגרסת טרום-GA תהיה מוגבלת, ושינויים במוצרים ובתכונות בגרסת טרום-GA לא יהיו תואמים לגרסאות אחרות של טרום-GA. מידע נוסף זמין בקטע תיאורים של שלבי ההשקה. בנוסף, כשאתם משתמשים בתכונה הזו, אתם מסכימים לתנאים ולהגבלות של גרסת הטרום-השקה של AI גנרטיבי (להלן: 'תנאי השימוש בגרסת הטרום-השקה'). אתם יכולים להשתמש בתכונה הזו כדי לעבד מידע אישי כמו שמפורט בנספח לעיבוד נתונים ב-Cloud, בכפוף להגבלות ולמחויבויות הרלוונטיות בהסכם (כפי שמוגדר בתנאי התצוגה המקדימה).

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

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

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

המלצות לשיפור הביצועים לעומת המלצות לסינון

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

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

איך להימנע מהצפת מודל ההמלצות

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

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

הורדת דירוג לעומת הסתרה

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

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

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

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

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

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

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

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

ערכי ההגברה הם מצטברים

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

לדוגמה, אם מגדילים את החשיפה של סרטי אנימציה לילדים ב-0.3 ואת החשיפה של סרטי אנימציה להרפתקאות ב-0.4, אז סרט שמסווג כסרט אנימציה להרפתקאות לילדים יקבל הגדלת חשיפה של 0.7.

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

הסכום של ההגברות יכול להיות גדול מ-‎+1. לדוגמה, אם אמצעי הבקרה העלו את הדירוג של סרטי אנימציה לילדים ב-0.6 ואת הדירוג של סרטי אנימציה להרפתקאות ב-0.5, אז הדירוג של סרט אנימציה להרפתקאות לילדים יעלה ב-1.1.

דוגמאות למסננים

הנה כמה דוגמאות למסננים להמלצות על מדיה.

מסננים במאפייני מפתח נפוצים

דוגמאות למסננים במאפייני מחרוזת של מפתח נפוץ (category,‏ image_name,‏ image_uri,‏ language,‏ title ו-uri).

אנימציות לילדים:
"filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"
מדיה מפחידה:
"filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")
פריטי מדיה ששם הכותרת שלהם הוא 'חג המולד':
"filter": "title: ANY(\"Christmas\")"
פריטי מדיה שבהם הפריט הראשון במערך images הוא name beachball:‏
"filter": "images[0].name: ANY(\"beach ball\")"

מסננים לפי מאפייני מפתח של מדיה

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

קובצי מדיה שהסוג שלהם הוא audio:
"filter": "media_key_properties.media_type: ANY(\"audio\")"
נכסי מדיה שבהם המערך hash_tags מכיל את המחרוזת #winter:
"filter": "media_key_properties.hash_tags: ANY(\"#winter\")"
‫Media where the first element of the hash_tags array is the string #winter:
"filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

שדות מותאמים אישית

דוגמאות למסננים בשדות מותאמים אישית. למאפיינים מותאמים אישית, מוסיפים את הקידומת attributes. לשם השדה.

יש לכם שדה מחרוזת מותאם אישית, festival, בסכימה כדי לייצג את פסטיבל הסרטים שבו הסרט הוצג לראשונה. כדי לסנן רק את הסרטים שהוצגו בבכורה בפסטיבל קאן:
"filter": "attributes.festival: ANY(\"Cannes\")
יש לכם שדה בוליאני מותאם אישית, audio_desc, שהערך שלו הוא true אם המדיה כוללת תיאור קולי לצופים עם לקות ראייה. כדי לסנן מדיה עם תיאור קולי:
"filter": "attributes.audio_desc: ANY(true)"

המגבלות על שדות שאפשר לסנן

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

אפשר להשתמש בביטויים לסינון לחיזוק רק בשדות נכס מסוג string ו-boolean.
אי אפשר לסנן שדות שמוטמעים ביותר מרמה אחת. לדוגמה, אפשר לסנן לפי persons.name אבל אי אפשר לסנן לפי השדה persons.name.stage (גם אם שדה כזה קיים).
המסננים צריכים להיות התאמות מדויקות. כלומר, בדוגמאות, סרט בשם Christmas Story או CHRISTMAS לא יקבל דחיפה.

לפני שמתחילים

מוודאים שיצרתם אפליקציה להמלצות על מדיה ומאגר נתונים. מידע נוסף זמין במאמר בנושא יצירה של אפליקציה ומאגר נתונים להמלצות על מדיה.
אופציונלי: אם אתם לא רוצים להשתמש בהגדרת ברירת המחדל להצגת מודעות, אתם יכולים ליצור הגדרה חדשה להצגת מודעות לפי שלבים 1-5 ו-7 במאמר יצירת הגדרה להצגת מודעות. אם האפליקציה שלכם נמצאת בשלב הייצור, Google ממליצה ליצור הגדרת הגשה נפרדת לבדיקת אמצעי הבקרה להגברת התנועה לפני שמחילים את אמצעי הבקרה על הגדרת ההגשה של הייצור.
חשוב לוודא שכל השדות שרוצים להשתמש בהם בבקרה על ההגברה מסומנים כניתנים לסינון בסכימה. מידע נוסף מופיע במאמר הגדרת שדות. אפשר לעיין גם במאמר מגבלות על סינון.

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

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

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

REST

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

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף AI Applications במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
איך מוצאים את המזהה של מאגר הנתונים אם כבר יש לכם מזהה של מאגר נתונים, אפשר לדלג לשלב הבא.
1. במסוף Google Cloud , עוברים לדף AI Applications ובתפריט הניווט לוחצים על Data Stores.
  
  מעבר לדף Data Stores
2. לוחצים על השם של מאגר הנתונים.
3. בדף Data (נתונים) של מאגר הנתונים, מאתרים את מזהה מאגר הנתונים.

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

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
      "displayName": "CONTROL_DISPLAY_NAME",
          "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
          "boostAction": {
               "dataStore": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/dataStores/DATA_STORE_ID",
               "boost" :  BOOST_VALUE,
               "filter": "FILTER"
          }
    }'

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

‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
CONTROL_DISPLAY_NAME: שם קריא לאנשים לזיהוי אמצעי הבקרה. הערך צריך להיות מחרוזת UTF-8 באורך של עד 128 תווים.
CONTROL_ID: מזהה ייחודי (במאגר נתונים) של אמצעי הבקרה. המזהה יכול להכיל אותיות קטנות, ספרות, מקפים וקווים תחתונים.
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
‫DATA_STORE_ID: המזהה של מאגר הנתונים של חיפוש מבוסס סוכנים.
‫BOOST_VALUE: מספר בשיטת נקודה צפה בטווח [‎-1,1]. אם הערך שלילי, ההמלצות יופיעו בחלק התחתון של התוצאות. אם הערך חיובי, ההמלצות מקודמות (הן מופיעות גבוה יותר בתוצאות).
‫FILTER: ביטוי המסנן שמתאר אילו מסמכים יקבלו דחיפה או יוסתרו. מידע מפורט על אופן יצירת ביטויי סינון זמין במאמר בנושא ביטויי סינון.

דוגמה לפקודה ולתשובה

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: 123456" \
"https://discoveryengine.googleapis.com/v1beta/projects/123456/locations/global/collections/default_collection/engines/my-app/controls?controlId=boost-kids" \
-d '{
      "displayName": "Boost childrens category",
          "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
          "boostAction": {
               "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store",
               "boost" :  0.3,
               "filter": "categories: ANY(\"Children\")"
          }
    }'

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
  "displayName": "Boost childrens category",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "boostAction": {
    "boost": 0.3,
    "filter": "categories: ANY(\"Children\")",
    "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
  }
}

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

חוזרים על שלב 3 לכל אמצעי בקרה להגברת הביצועים שרוצים להחיל על ההמלצות. לדוגמה, יכול להיות שתרצו אמצעי בקרה אחד שיקדם סרטים לילדים, boost-kids ואמצעי בקרה שני שידחיק סרטי אימה, bury-horror.
מאתרים את המזהה של הגדרת הצגת המודעות. אם כבר יש לכם את מזהה הגדרת ההצגה, אפשר לדלג לשלב הבא.
1. נכנסים לדף AI Applications במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, לוחצים על שם האפליקציה.
3. עוברים לדף Configurations ולוחצים על הכרטיסייה Control.
4. מעתיקים את מזהה הגדרות הצגת המודעות מהעמודה מזהה.
מצרפים את אמצעי הבקרה החדש להגברת התנועה להגדרת התנועה באמצעות בקשת עדכון בשיטה engines.servingConfigs.patch.

חשוב: אם כבר יש אמצעי בקרה להגברת התנועה שמשויכים להגדרת התצורה הזו של הצגת המודעות, פקודת התיקון הזו תמחק את אמצעי הבקרה האלה. הפקודה patch מחליפה את הערך של boostControlIds בערך החדש שאתם מספקים.
```
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["CONTROL_ID"]
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫CONFIG_ID: המזהה של הגדרת התצורה של הצגת המודעות שרוצים לצרף אליה את אמצעי הבקרה להגברת החשיפה – לדוגמה, my_app-1234567_id. הסבר מופיע בשלב הקודם.
- ‫CONTROL_ID: מכיל את המזהים של אמצעי בקרה אחד או יותר של הגברת הצגת התוצאות שרוצים לצרף להגדרת ההצגה, לדוגמה, "boost-kids", "bury-horror". זו מערך של מחרוזות. אם יש יותר ממזהה אחד, אל תשכחו להשתמש במירכאות ובפסיקים כדי להפריד ביניהם.
דוגמה לפקודה ולתשובה
```
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["boost-kids", "bury-horror"]
}'
```
```
{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
  "displayName": "jane-day-test-serving-config-for-boost-bury",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "modelId": "my-app",
  "diversityLevel": "no-diversity",
  "diversityType": "RULE_BASED_DIVERSITY",
  "mediaConfig": {},
  "boostControlIds": [
    "boost-kids",
    "bury-horror"
  ]
}
```
הפקודה הזו מצרפת שני אמצעי בקרה להגברת התנועה להגדרת ברירת המחדל של הצגת המודעות באפליקציית my-app.
מחכים כמה דקות עד שהתוצאות ייכנסו לתוקף.
צפייה בתצוגה מקדימה של ההשפעה של אמצעי הבקרה להגברת התנועה. איך מקבלים המלצות למדיה

עדכון בקרת ההגברה

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

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

כשמעדכנים ערך או מסנן של הגדלת נפח תנועה, מפעילים את השיטה engines.controls.patch.

השיטה patch מחליפה את הערכים של boost ו-filter בערכים החדשים שאתם מספקים. בתהליך הזה מוסבר איך לערוך את הערך boost (שלב 3) ואת הערך filter (שלב 4) בנפרד. אבל אם רוצים לערוך את שניהם, אפשר לעשות זאת באמצעות פקודת curl אחת.

REST

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

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף AI Applications במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

מאתרים את המזהה של אמצעי הבקרה של ההגברה שרוצים לעדכן באמצעות השיטה engines.servingConfigs.get. אם כבר יש לכם את המזהה, דלגו לשלב הבא.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls"

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.

דוגמה לפקודה ולתוצאה

curl -X GET \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json" \
 -H "X-Goog-User-Project: my-project-123" \
 "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls"

{
  "controls": [
    {
      "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
      "displayName": "Boost childrens category",
      "associatedServingConfigIds": [
        "my_app-1234567_id"
      ],
      "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
      "boostAction": {
        "boost": 0.3,
        "filter": "categories: ANY(\"Children\")",
        "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
      }
    },
    {
      "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/bury-horror",
      "displayName": "Bury horror category",
      "associatedServingConfigIds": [
        "my_app-1234567_id"
      ],
      "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
      "boostAction": {
        "boost": -0.4,
        "filter": "categories: ANY(\"Horror\")",
        "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
      }
    }
  ]
}

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

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

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID?update_mask=boost_action.boost" \
-d '{
    "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID",
    "boostAction": {
      "boost": BOOST_VALUE
    }
}'

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
‫CONTROL_ID: המזהה הייחודי של אמצעי הבקרה להגברת הביצועים שרוצים לערוך, החלק האחרון של השדה name שמופק על ידי הפקודה GET בשלב 2. לדוגמה, boost-kids.
‫BOOST_VALUE: מספר בשיטת נקודה צפה בטווח [‎-1,1]. אם הערך שלילי, ההמלצות יופיעו בחלק התחתון של התוצאות. אם הערך חיובי, ההמלצות מקודמות (הן מופיעות גבוה יותר בתוצאות).

דוגמה לפקודה ולתוצאה

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls/boost-kids?update_mask=boost_action.boost" \
-d '{
    "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
    "boostAction": {
      "boost": 0.2
    }
}'

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
  "displayName": "Boost childrens category",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "boostAction": {
    "boost": 0.2,
    "filter": "categories: ANY(\"Children\")",
    "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
  }
}

הפקודה הזו מגדירה את ערך ההגברה של אמצעי הבקרה boost-kids ל-0.2.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID?update_mask=boost_action.filter" \
-d '{
    "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID",
    "boostAction": {
      "filter": "FILTER"
    }
}'

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
‫CONTROL_ID: המזהה הייחודי של אמצעי הבקרה להגברת הביצועים שרוצים לערוך, החלק האחרון של השדה name שמופק על ידי הפקודה GET בשלב 2.
‫FILTER: ביטוי המסנן שמתאר אילו מסמכים יקבלו דחיפה או יוסתרו. מידע מפורט על אופן יצירת ביטויי סינון זמין במאמר בנושא ביטויי סינון.

דוגמה לפקודה ולתוצאה

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls/boost-kids?update_mask=boost_action.filter" \
-d '{
"name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
"boostAction": {
  "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"
}
}'

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
  "displayName": "Boost childrens category",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "boostAction": {
    "boost": 0.2,
    "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")",
    "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
  }
}

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

מחיקת אמצעי בקרה להגברת התנועה

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

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

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

REST

כדי למחוק אמצעי בקרה להגברת התנועה:

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף AI Applications במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

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

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls"

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.

דוגמה לפקודה ולתוצאה

curl -X GET \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json" \
 -H "X-Goog-User-Project: my-project-123" \
 "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls"

{
  "controls": [
    {
      "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/boost-kids",
      "displayName": "Boost childrens category",
      "associatedServingConfigIds": [
        "my_app-1234567_id"
      ],
      "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
      "boostAction": {
        "boost": 0.2,
        "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")",
        "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
      }
    },
    {
      "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/controls/bury-horror",
      "displayName": "Bury horror category",
      "associatedServingConfigIds": [
        "my_app-1234567_id"
      ],
      "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
      "boostAction": {
        "boost": -0.4,
        "filter": "categories: ANY(\"Horror\")",
        "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
      }
    }
  ]
}

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

בדקו את התוצאה. אם אמצעי הבקרה להגברת התנועה מצורף להגדרות התצורה של הצגת המודעות, צריך לעדכן את הגדרות התצורה של הצגת המודעות כדי להסיר את אמצעי הבקרה שרוצים למחוק. במאמר עדכון הגדרות הצגת מודעות כדי להסיר אמצעי בקרה להגברת התנועה מוסבר איך לעשות זאת.
מריצים את פקודת ה-curl הבאה כדי למחוק את אמצעי הבקרה להגברת החשיפה:
```
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID"
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- ‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
- ‫CONTROL_ID: המזהה הייחודי של אמצעי הבקרה להגברת הביצועים שרוצים למחוק. זהו החלק האחרון של השדה name שמוחזר על ידי הפקודה GET בשלב 2.
פקודה לדוגמה
```
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls/boost-kids"
```
```
{}
```
הפקודה הזו מוחקת את אמצעי הבקרה boost-kids.
אם מופיעה הודעת שגיאה שלפיה יש הפניה פעילה לבקרת ההגברה לפחות בהגדרת תצורה אחת להצגת מודעות, אפשר לעיין במאמר עדכון הגדרת תצורה להצגת מודעות כדי להסיר בקרת הגברה.

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

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

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

כדי לגלות אילו אמצעי בקרה לשיפור הביצועים מצורפים להגדרת הצגת התוצאות, שולחים בקשת engines.servingConfigs.get ומסתכלים על השדה boostControlIds בתגובה.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.
‫CONFIG_ID: המזהה של הגדרת ההצגה שרוצים לקבל עליה מידע נוסף.

דוגמה לפקודה ולתוצאה

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id"

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
  "displayName": "jane-day-test-serving-config-for-boost-bury",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "modelId": "my-app",
  "diversityLevel": "no-diversity",
  "diversityType": "RULE_BASED_DIVERSITY",
  "mediaConfig": {},
  "createTime": "2024-11-22T23:54:45.613178Z",
  "updateTime": "2024-11-26T20:28:11.967439Z",
  "boostControlIds": [
    "boost-kids",
    "bury-horror"
  ]
}

הפקודה הזו מציגה מידע על הגדרת ההצגה my_app-1234567_id. בפרט, היא מראה שהגדרת ההצגה כוללת שני אמצעי בקרה להגברת החשיפה: boost-kids ו-bury-horror.

כדי לעדכן את הגדרות הצגת המודעות ולהסיר אמצעי בקרה אחד להגברת התנועה, משתמשים בשיטה engines.servingConfigs.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://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["CONTROL_ID"]
}'

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

‫CONFIG_ID: המזהה של הגדרת התצורה של הצגת המודעות שרוצים לצרף אליה את אמצעי הבקרה להגברת החשיפה – לדוגמה, my_app-1234567_id. הסבר מופיע בשלב הקודם.
‫CONTROL_ID: מכיל את המזהים של אמצעי בקרה להגברת החשיפה שרוצים להוסיף להגדרת התצורה של הצגת התוצאות. חשוב לוודא שאתם לא כוללים את אמצעי הבקרה של ההגברה שאתם רוצים למחוק. זו מערך של מחרוזות. אם יש לכם יותר ממזהה אחד, אל תשכחו להשתמש במירכאות ובפסיקים להפרדה – לדוגמה, boost-1", "boost-2.

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["bury-horror"]
}'

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
  "displayName": "jane-day-test-serving-config-for-boost-bury",
  "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
  "modelId": "my-app",
  "diversityLevel": "no-diversity",
  "diversityType": "RULE_BASED_DIVERSITY",
  "mediaConfig": {},
  "boostControlIds": [
    "bury-horror"
  ]
}

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

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
-d '{
"boostControlIds": []
}'

{
"name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
"displayName": "jane-day-test-serving-config-for-boost-bury",
"solutionType": "SOLUTION_TYPE_RECOMMENDATION",
"modelId": "my-app",
"diversityLevel": "no-diversity",
"diversityType": "RULE_BASED_DIVERSITY",
"mediaConfig": {}
}

הפקודה הזו מסירה את כל אמצעי הבקרה להגברת התנועה מהגדרות ההצגה, my_app-1234567_id

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

המלצות לשיפור הביצועים לעומת המלצות לסינון

איך להימנע מהצפת מודל ההמלצות

הורדת דירוג לעומת הסתרה

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

ערכי ההגברה הם מצטברים

דוגמאות למסננים

מסננים במאפייני מפתח נפוצים

מסננים לפי מאפייני מפתח של מדיה

שדות מותאמים אישית

המגבלות על שדות שאפשר לסנן

לפני שמתחילים

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

REST

דוגמה לפקודה ולתשובה

דוגמה לפקודה ולתשובה

עדכון בקרת ההגברה

REST

דוגמה לפקודה ולתוצאה

דוגמה לפקודה ולתוצאה

דוגמה לפקודה ולתוצאה

מחיקת אמצעי בקרה להגברת התנועה

REST

דוגמה לפקודה ולתוצאה

פקודה לדוגמה

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

דוגמה לפקודה ולתוצאה

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

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

הדגשה והסתרה של המלצות למדיה