הערה: חבילת המסמכים הזו מיועדת למהדורות Standard,‏ Plus,‏ תשלום לפי שימוש ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

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

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

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

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

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

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

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

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

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

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

מידע על התנאים

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

‫queryTerms. אמצעי בקרה אופציונלי שמופעל כשמחפשים שאילתות ספציפיות. כשמשתמשים בתנאי queryTerms, אמצעי הבקרה מופעל כשהערך של queryTerms תואם למונח ב-SearchRequest.query. אפשר להשתמש במונחי שאילתה רק כשהערך של Control.searchUseCase מוגדר כ-SOLUTION_TYPE_SEARCH. אפשר לציין עד 10 queryTerms שונים ב-Control.condition אחד. אם לא צוינו מונחי שאילתה, המערכת מתעלמת מהשדה queryTerms.

כדי ליצור בהצלחה אמצעי בקרה לקידום, צריך לציין את השדה queryTerms עם fullMatch שמוגדר ל-true או ל-false.
‫activeTimeRange: אמצעי בקרה אופציונלי שמופעל כשבקשה מתרחשת בטווח תאריכים מסוים. היא בודקת אם השעה שבה הבקשה התקבלה היא בין activeTimeRange.startTime ל-activeTimeRange.endTime. אפשר לציין עד 10 טווחי activeTimeRange ב-Control.condition אחד. אם השדה activeTimeRange לא צוין, המערכת מתעלמת ממנו.

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

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

"queryTerms": [
  {
    "value": "gShoe",
    "fullMatch": true
  },
  {
    "value": "gBoot",
    "fullMatch": true
  }
]

התנאי יתקיים בבקשה עם SearchRequest.query="gShoe" או בבקשה עם SearchRequest.query="gBoot", אבל לא יתקיים עם SearchRequest.query="gSandal" או עם כל מחרוזת אחרת.

אם לא מציינים תנאים, אמצעי הבקרה תמיד מופעל.

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

יצירה וצירוף של אמצעי בקרה להצגת תוכן מחוזק

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

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

המסוף

כדי ליצור ולצרף בקרת חיזוק באמצעות מסוף Google Cloud :

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

Gemini Enterprise
בוחרים את האפליקציה שרוצים ליצור לה את פקד ההגברה.
לוחצים על Configurations (הגדרות) ואז על הכרטיסייה Control (בקרה).
לוחצים על יצירת אמצעי בקרה.
בקטע מה ברצונך לעשות?, מציינים את השם והסוג של אמצעי הבקרה:
1. בקטע שם הפקד, מזינים שם לפקד ההגברה או ההחלשה.
2. בקטע Control Type, בוחרים באפשרות Boost/bury.
3. לוחצים על Continue.
בקטע Set Rule Scope & Impact, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. בוחרים מאגר נתונים מהרשימה. אם רוצים להחיל את הפעולה על כמה מאגרי נתונים, צריך ליצור אמצעי בקרה לכל מאגר נתונים.
2. בקטע מסנן, מוסיפים מסנן.
  
  זוהי מחרוזת שמציינת את הדרישות שהמסמך צריך לעמוד בהן. תנאי החיזוק חל רק אם המסמך עומד בכל הדרישות. אחרת, אין שינוי. אם לא מציינים מסנן, ההדגשה חלה על כל המסמכים במאגר הנתונים.
  
  למידע על תחביר הסינון, ראו תחביר של ביטוי סינון.
3. בקטע Boost/bury value, בוחרים ערך לחיזוק או להחלשה בטווח ‎[-1, 1] באמצעות פס ההזזה. פס ההזזה נע בשלבים של 0.01.
4. לוחצים על Continue.
בקטע אופציונלי: מתי הכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מגדירים תנאים, אמצעי הבקרה תמיד פועל:
1. מוסיפים מונחי שאילתה בהתאמה חלקית. אמצעי הבקרה נכנס לתוקף כשיש התאמה חלקית למונחי החיפוש האלה.
2. מוסיפים מונחי שאילתה בהתאמה מדויקת. אמצעי הבקרה נכנס לתוקף כשיש התאמה מדויקת למונחי השאילתה האלה.
3. כדי להוסיף טווח זמן פעיל, לוחצים על Add time range ומגדירים את Start Time 1 ואת End Time 1. ההגדרה הזו קובעת את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
4. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שאתם יוצרים אותו, השביתו את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

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

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

לפרטים על השדות, קראו את מאמרי העזרה של ה-API של engines.controls ואת מאמרי העזרה של ה-API של engines.controls.create.

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מריצים את פקודות ה-curl הבאות כדי ליצור את אמצעי הבקרה.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
"displayName": "DISPLAY_NAME",
"solutionType": "SOLUTION_TYPE_SEARCH",
"useCases": [
  "USE_CASE"
],
"conditions": {
 "queryTerms": [
   {
     "value": "VALUE",
     "fullMatch": FULL_MATCH
   }
 ],
 "activeTimeRange": [
   {
     "startTime": "START_TIMESTAMP",
     "endTime": "END_TIMESTAMP"
   }
 ]
},
"boostAction": {
  "boost": BOOST_VALUE,
  "filter": "FILTER",
  "dataStore": "DATA_STORE_RESOURCE_PATH"
 }
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
- ‫APP_ID: מזהה האפליקציה.
- ‫CONTROL_ID: מזהה ייחודי של אמצעי הבקרה. המזהה יכול להכיל בין 1 ל-63 תווים, שיכולים להיות אותיות, ספרות, מקפים וקווים תחתונים.
- ‫DISPLAY_NAME: השם הקריא לאנשים של אמצעי הבקרה. ‫Google ממליצה שהשם הזה יציין מתי או למה להשתמש באמצעי הבקרה. הערך חייב להיות מחרוזת בקידוד UTF-8 באורך [1,128].
- ‫USE_CASE: הערך צריך להיות SEARCH_USE_CASE_SEARCH או SEARCH_USE_CASE_BROWSE. אם מציינים את SEARCH_USE_CASE_BROWSE, אי אפשר להשתמש ב-Condition.queryTerms בתנאי.
- ‫CONDITION: שדה אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
  - ‫VALUE: ערך השאילתה הספציפי שצריך להתאים. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000]. אם הערך של FULL_MATCH_1 הוא true, השדה הזה יכול להכיל עד שלושה מונחים שמופרדים ברווחים.
  - ‫FULL_MATCH: ערך בוליאני שמציין אם שאילתת החיפוש צריכה להתאים בדיוק למונח החיפוש. כשהמדיניות מוגדרת לערך true, נדרשת התאמה מלאה של SearchRequest.query לערך queryTerm.value. כשהערך הוא false, השדה SearchRequest.query צריך להכיל את הערך queryTerm.value כמחרוזת משנה.
  - ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את ההתחלה של טווח תאריכים.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את הסוף של טווח הזמן.
- ‫BOOST_VALUE: מספר בשיטת נקודה צפה בטווח [1,‏ 1-]. כשהערך שלילי, התוצאות מורדות בדרגה (הן מופיעות נמוך יותר בתוצאות). כשהערך חיובי, התוצאות מקודמות (הן מופיעות גבוה יותר בתוצאות). מידע נוסף זמין במאמר boostAction.
- ‫FILTER: מחרוזת שמציינת את הדרישות שהמסמך צריך לעמוד בהן. אם המסמך עומד בכל הדרישות, השיפור מופעל. אחרת, אין שינוי. אם השדה הזה ריק, החיזוק יחול על כל המסמכים במאגר הנתונים. למידע על תחביר הסינון, ראו תחביר של ביטוי סינון. הערה: אי אפשר לסנן את שדה המסמך title.
- ‫DATA_STORE_RESOURCE_PATH: נתיב המשאב המלא של מאגר הנתונים שהמסמכים שלו צריכים לקבל חיזוק מהפקד הזה. הפורמט של הנתיב המלא של המשאב הוא projects/PROJECT_NUMBER/locations/LOCATION_ID/collections/default_collection/dataStores/DATA_STORE_ID. מאגר הנתונים הזה חייב להיות מצורף למנוע שצוין בבקשה.

מצרפים את אמצעי הבקרה להגדרת הצגת המודעות של האפליקציה באמצעות ה-method‏ 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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search?update_mask=boost_control_ids" \
-d '{
 "boostControlIds": ["BOOST_ID_1", "BOOST_ID_2"]
}'

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

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

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

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

המסוף

כדי ליצור ולצרף אמצעי בקרה לסינון באמצעות מסוף Google Cloud :

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

Gemini Enterprise
בוחרים את האפליקציה שרוצים ליצור לה את אמצעי הבקרה לסינון.
לוחצים על Configurations (הגדרות) ואז על הכרטיסייה Control (בקרה).
לוחצים על יצירת אמצעי בקרה.
בקטע מה ברצונך לעשות?, מציינים את השם והסוג של אמצעי הבקרה:
1. בשדה שם הפקד, נותנים שם לפקד הסינון.
2. בקטע סוג אמצעי הבקרה, בוחרים באפשרות מסנן.
3. לוחצים על Continue.
בקטע Set Rule Scope & Impact, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. בוחרים מאגר נתונים מהרשימה. אם רוצים להחיל את הפעולה על כמה מאגרי נתונים, צריך ליצור אמצעי בקרה לכל מאגר נתונים.
2. בשדה מסנן, מציינים את הפריטים הספציפיים שהכלל צריך לחפש. אפשר לשלב מונחי חיפוש באמצעות AND, OR NOT ולקבץ מונחים באמצעות (). כדי לחפש ביטויים מדויקים, משתמשים במירכאות (""). לדוגמה: category: "electronics" AND price < 500, status: "open" AND priority:"P1".
  
  למידע על תחביר הסינון, ראו תחביר של ביטוי סינון.
3. לוחצים על Continue.
בקטע אופציונלי: מתי הכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מגדירים תנאים, אמצעי הבקרה תמיד פועל:
1. מוסיפים מונחי שאילתה בהתאמה חלקית. אמצעי הבקרה נכנס לתוקף כשיש התאמה חלקית למונחי החיפוש האלה.
2. מוסיפים מונחי שאילתה בהתאמה מדויקת. אמצעי הבקרה נכנס לתוקף כשיש התאמה מדויקת למונחי השאילתה האלה.
3. כדי להוסיף טווח זמן פעיל, לוחצים על Add time range ומגדירים את Start Time 1 ואת End Time 1. ההגדרה הזו קובעת את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
4. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שאתם יוצרים אותו, השביתו את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

לפרטים על השדות, קראו את מאמרי העזרה של ה-API של engines.controls ואת מאמרי העזרה של ה-API של engines.controls.create.

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מריצים את פקודות ה-curl הבאות כדי ליצור את אמצעי הבקרה.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
"displayName": "DISPLAY_NAME",
"solutionType": "SOLUTION_TYPE_SEARCH",
"useCases": ["USE_CASE"],
"conditions": {
  "queryTerms": [
    {
      "value": "VALUE",
      "fullMatch": FULL_MATCH
    }
  ],
  "activeTimeRange": [
    {
      "startTime": "START_TIMESTAMP",
      "endTime": "END_TIMESTAMP"
    }
  ]
},
"filterAction": {
  "filter": "FILTER"
 }
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
- ‫APP_ID: מזהה האפליקציה.
- ‫CONTROL_ID: מזהה ייחודי של אמצעי הבקרה. המזהה יכול להכיל בין 1 ל-63 תווים, שיכולים להיות אותיות, ספרות, מקפים וקווים תחתונים.
- ‫DISPLAY_NAME: השם הקריא לאנשים של אמצעי הבקרה. ‫Google ממליצה שהשם הזה יציין מתי או למה להשתמש באמצעי הבקרה. הערך חייב להיות מחרוזת בקידוד UTF-8 באורך [1,128].
- ‫USE_CASE: הערך צריך להיות SEARCH_USE_CASE_SEARCH או SEARCH_USE_CASE_BROWSE. אם מציינים את SEARCH_USE_CASE_BROWSE, אי אפשר להשתמש ב-Condition.queryTerms בתנאי.
- ‫CONDITION: שדה אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
  - ‫VALUE: ערך השאילתה הספציפי שצריך להתאים. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000]. אם הערך של FULL_MATCH_1 הוא true, השדה הזה יכול להכיל עד שלושה מונחים שמופרדים ברווחים.
  - ‫FULL_MATCH: ערך בוליאני שמציין אם שאילתת החיפוש צריכה להתאים בדיוק למונח החיפוש. כשהמדיניות מוגדרת לערך true, נדרשת התאמה מלאה של SearchRequest.query לערך queryTerm.value. כשהערך הוא false, השדה SearchRequest.query צריך להכיל את הערך queryTerm.value כמחרוזת משנה.
  - ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את ההתחלה של טווח תאריכים.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את הסוף של טווח הזמן.
- ‫FILTER: מחרוזת שמציינת את הדרישות שהמסמך צריך לעמוד בהן. אם המסמך עומד בכל הדרישות, הוא מוחזר בתוצאות. אחרת, המסמך לא יופיע בתוצאות. למידע על תחביר הסינון, ראו תחביר של ביטוי סינון. מידע נוסף זמין במאמר filterAction. הערה: אי אפשר לסנן את שדה המסמך title.

מצרפים את אמצעי הבקרה להגדרת הצגת המודעות של האפליקציה באמצעות ה-method‏ 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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search?update_mask=filter_control_ids" \
-d '{
  "filterControlIds": ["FILTER_ID_1", "FILTER_ID_2"]
}'

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

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

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

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

המסוף

כדי ליצור ולצרף אמצעי בקרה למילים נרדפות באמצעות מסוף Google Cloud :

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

Gemini Enterprise
בוחרים את האפליקציה שרוצים ליצור לה את אמצעי הבקרה למילים נרדפות.
לוחצים על Configurations (הגדרות) ואז על הכרטיסייה Control (בקרה).
לוחצים על יצירת אמצעי בקרה.
בקטע מה ברצונך לעשות?, מציינים את השם והסוג של אמצעי הבקרה:
1. בקטע Name Your Control, נותנים שם לפקד המילים הנרדפות.
2. בקטע סוג אמצעי הבקרה, בוחרים באפשרות מילים נרדפות.
3. לוחצים על Continue.
בקטע Set Rule Scope & Impact, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. מזינים את המילים הנרדפות שרוצים שהמערכת תביא בחשבון. לדוגמה, מזינים חתולים, לוחצים על Enter (לא על פסיק) ואז מזינים חתוליים.
2. לוחצים על Continue.
בקטע אופציונלי: מתי הכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מגדירים תנאים, אמצעי הבקרה תמיד פועל:
1. כדי להוסיף טווח זמן פעיל, לוחצים על Add time range ומגדירים את Start Time 1 ואת End Time 1. ההגדרה הזו קובעת את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
2. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שאתם יוצרים אותו, השביתו את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

לפרטים על השדות, קראו את מאמרי העזרה של ה-API של engines.controls ואת מאמרי העזרה של ה-API של engines.controls.create.

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מריצים את פקודות ה-curl הבאות כדי ליצור את אמצעי הבקרה.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
"displayName": "DISPLAY_NAME",
"solutionType": "SOLUTION_TYPE_SEARCH",
"useCases": ["USE_CASE"],
"conditions": {
  "queryTerms": [
    {
      "value": "VALUE",
      "fullMatch": FULL_MATCH
    }
  ],
  "activeTimeRange": [
    {
      "startTime": "START_TIMESTAMP",
      "endTime": "END_TIMESTAMP"
    }
  ]
},
"synonymsAction": {
  "synonyms": ["SYNONYMS_1","SYNONYMS_2"]
 }
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
- ‫APP_ID: מזהה האפליקציה.
- ‫CONTROL_ID: מזהה ייחודי של אמצעי הבקרה. המזהה יכול להכיל בין 1 ל-63 תווים, שיכולים להיות אותיות, ספרות, מקפים וקווים תחתונים.
- ‫DISPLAY_NAME: השם הקריא לאנשים של אמצעי הבקרה. ‫Google ממליצה שהשם הזה יציין מתי או למה להשתמש באמצעי הבקרה. הערך חייב להיות מחרוזת בקידוד UTF-8 באורך [1,128].
- ‫USE_CASE: הערך צריך להיות SEARCH_USE_CASE_SEARCH או SEARCH_USE_CASE_BROWSE. אם מציינים את SEARCH_USE_CASE_BROWSE, אי אפשר להשתמש ב-Condition.queryTerms בתנאי.
- ‫CONDITION: שדה אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
  - ‫VALUE: ערך השאילתה הספציפי שצריך להתאים. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000]. אם הערך של FULL_MATCH_1 הוא true, השדה הזה יכול להכיל עד שלושה מונחים שמופרדים ברווחים.
  - ‫FULL_MATCH: ערך בוליאני שמציין אם שאילתת החיפוש צריכה להתאים בדיוק למונח החיפוש. כשהמדיניות מוגדרת לערך true, נדרשת התאמה מלאה של SearchRequest.query לערך queryTerm.value. כשהערך הוא false, השדה SearchRequest.query צריך להכיל את הערך queryTerm.value כמחרוזת משנה.
  - ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את ההתחלה של טווח תאריכים.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את הסוף של טווח הזמן.
- ‫SYNONYMS_N: רשימה של מחרוזות שמשויכות זו לזו, כך שיש סיכוי גבוה יותר שכל אחת מהן תציג תוצאות דומות. סביר להניח שתקבלו תוצאות דומות, אבל כשמחפשים כל אחד מהערכים של המילים הנרדפות, יכול להיות שלא תקבלו את כל התוצאות הרלוונטיות לכל המילים הנרדפות המשויכות. צריך לציין לפחות שתי מילים נרדפות, ואפשר לציין עד 100 מילים נרדפות. כל מילה נרדפת צריכה להיות מקודדת ב-UTF-8 ובאותיות קטנות. אסור להשתמש במחרוזות כפולות. לדוגמה, אפשר להוסיף את המילים "פיקסל", "טלפון Android" ו"טלפון של Google" כמילים נרדפות. מידע נוסף זמין במאמר synonymsAction.

מצרפים את אמצעי הבקרה להגדרת הצגת המודעות של האפליקציה באמצעות ה-method‏ 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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search?update_mask=synonyms_control_ids" \
-d '{
  "synonymsControlIds": ["SYNONYMS_ID_1", "SYNONYMS_ID_2"]
}'

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

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

אמצעי בקרה להצגת הפניות אוטומטיות מאפשר להפנות משתמשים ל-URI שסופק. פקדי הפניה אוטומטית מוגדרים כפקד עם redirectAction.

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

לפרטים על השדות, קראו את מאמרי העזרה של ה-API של engines.controls ואת מאמרי העזרה של ה-API של engines.controls.create.

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מריצים את פקודות ה-curl הבאות כדי ליצור את אמצעי הבקרה.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
"displayName": "DISPLAY_NAME",
"solutionType": "SOLUTION_TYPE_SEARCH",
"useCases": ["USE_CASE"],
"conditions": {
  "queryTerms": [
    {
      "value": "VALUE",
      "fullMatch": FULL_MATCH
    }
  ],
  "activeTimeRange": [
    {
      "startTime": "START_TIMESTAMP",
      "endTime": "END_TIMESTAMP"
    }
  ]
},
"redirectAction": {
  "redirectURI": "REDIRECT_URI"
 }
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
- ‫APP_ID: מזהה האפליקציה.
- ‫CONTROL_ID: מזהה ייחודי של אמצעי הבקרה. המזהה יכול להכיל בין 1 ל-63 תווים, שיכולים להיות אותיות, ספרות, מקפים וקווים תחתונים.
- ‫DISPLAY_NAME: השם הקריא לאנשים של אמצעי הבקרה. ‫Google ממליצה שהשם הזה יציין מתי או למה להשתמש באמצעי הבקרה. הערך חייב להיות מחרוזת בקידוד UTF-8 באורך [1,128].
- ‫USE_CASE: הערך צריך להיות SEARCH_USE_CASE_SEARCH או SEARCH_USE_CASE_BROWSE. אם מציינים את SEARCH_USE_CASE_BROWSE, אי אפשר להשתמש ב-Condition.queryTerms בתנאי.
- ‫CONDITION: שדה אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
  - ‫VALUE: ערך השאילתה הספציפי שצריך להתאים. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000]. אם הערך של FULL_MATCH_1 הוא true, השדה הזה יכול להכיל עד שלושה מונחים שמופרדים ברווחים.
  - ‫FULL_MATCH: ערך בוליאני שמציין אם שאילתת החיפוש צריכה להתאים בדיוק למונח החיפוש. כשהמדיניות מוגדרת לערך true, נדרשת התאמה מלאה של SearchRequest.query לערך queryTerm.value. כשהערך הוא false, השדה SearchRequest.query צריך להכיל את הערך queryTerm.value כמחרוזת משנה.
  - ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את ההתחלה של טווח תאריכים.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את הסוף של טווח הזמן.
- ‫REDIRECT_URI_N: כתובת URI שאליה אתם מופנים. האורך המקסימלי הוא 2,000 תווים. לדוגמה, אם הערך של מונח השאילתה הוא "תמיכה", אתם יכולים להגדיר הפניה אוטומטית לדף התמיכה הטכנית במקום להחזיר (או לא להחזיר) תוצאות חיפוש של "תמיכה". בדוגמה הזו, ה-URI להפניה אוטומטית הוא "https://www.example.com/support". מידע נוסף זמין במאמר redirectAction.

מצרפים את אמצעי הבקרה להגדרת הצגת המודעות של האפליקציה באמצעות ה-method‏ 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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search?update_mask=redirect_control_ids" \
-d '{
  "redirectControlIds": ["REDIRECT_ID_1", "REDIRECT_ID_2"]
}'

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

יצירה וצירוף של אמצעי בקרה לקידום תוכן

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

כדי שהפקד לקידום יופעל, צריך לצרף אותו להגדרת ההצגה של האפליקציה.

אמצעי הבקרה לקידום מוגדרים באמצעות promoteAction.

כדי ליצור בהצלחה אמצעי בקרה לקידום, צריך לציין את השדה queryTerms עם fullMatch שמוגדר ל-true או ל-false.

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

המסוף

כדי ליצור אמצעי בקרה לקידום תוצאות, פועלים לפי ההוראות בכרטיסייה REST.

REST

לפרטים על השדות, קראו את מאמרי העזרה של ה-API של engines.controls ואת מאמרי העזרה של ה-API של engines.controls.create.

מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל "אפליקציות"
2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.
מריצים את פקודות ה-curl הבאות כדי ליצור את אמצעי הבקרה.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
"displayName": "DISPLAY_NAME",
"solutionType": "SOLUTION_TYPE_SEARCH",
"useCases": ["USE_CASE"],
"conditions": {
  "queryTerms": [
    {
      "value": "VALUE",
      "fullMatch": FULL_MATCH
    }
  ],
  "activeTimeRange": [
    {
      "startTime": "START_TIMESTAMP",
      "endTime": "END_TIMESTAMP"
    }
  ]
},
"promoteAction": {
  "dataStore": "DATA_STORE_RESOURCE_PATH",
  "searchLinkPromotion": {
     "document": "DOCUMENT_RESOURCE_PATH",
     "title": "TITLE",
     "uri": "URI",
     "description": "URI_DESCRIPTION"
  }
 }
}'
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: המספר או המזהה של הפרויקט ב- Google Cloud .
- ‫APP_ID: מזהה האפליקציה.
- ‫CONTROL_ID: מזהה ייחודי של אמצעי הבקרה. המזהה יכול להכיל בין 1 ל-63 תווים, שיכולים להיות אותיות, ספרות, מקפים וקווים תחתונים.
- ‫DISPLAY_NAME: השם הקריא לאנשים של אמצעי הבקרה. ‫Google ממליצה שהשם הזה יציין מתי או למה להשתמש באמצעי הבקרה. הערך חייב להיות מחרוזת בקידוד UTF-8 באורך [1,128].
- ‫USE_CASE: הערך צריך להיות SEARCH_USE_CASE_SEARCH או SEARCH_USE_CASE_BROWSE. אם מציינים את SEARCH_USE_CASE_BROWSE, אי אפשר להשתמש ב-Condition.queryTerms בתנאי.
- ‫CONDITION: שדה אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
  - ‫VALUE: ערך השאילתה הספציפי שצריך להתאים. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000].
  - ‫FULL_MATCH: ערך בוליאני שמציין אם צריך להיות התאמה מלאה למונח החיפוש.
  - ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את ההתחלה של טווח תאריכים.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC "Zulu"‎ שמציינת את הסוף של טווח הזמן.
- ‫DATA_STORE_RESOURCE_PATH: נתיב המשאב המלא של מאגר הנתונים שתוצאות החיפוש שלו מכילות את כתובת דף המבצע. הפורמט של הנתיב המלא של המשאב הוא projects/PROJECT_NUMBER/locations/LOCATION_ID/collections/default_collection/dataStores/DATA_STORE_ID. מאגר הנתונים הזה חייב להיות מצורף למנוע שצוין בבקשה.
- ‫DOCUMENT_RESOURCE_PATH: שדה שבו מציינים את נתיב המשאב של המסמך שרוצים לקדם. אתם צריכים לספק את מזהה המסמך בשדה DOCUMENT_RESOURCE_PATH, את ה-URI בשדה URI או את שניהם.
  
  הפורמט של נתיב המשאב המלא הוא: projects/PROJECT_NUMBER/locations/LOCATION_ID/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID.
- ‫TITLE: שדה חובה שבו מציינים את הכותרת של המסמך או של דף האינטרנט שרוצים לקדם. הכותרת הזו מוצגת בתוצאת החיפוש.
- ‫URI: שדה שבו מציינים את ה-URI שאליו תוצאת החיפוש מובילה את המשתמש. אתם צריכים לספק את מזהה המסמך בשדה DOCUMENT_RESOURCE_PATH, את ה-URI בשדה URI או את שניהם.
- ‫URI_DESCRIPTION: שדה אופציונלי לתיאור ה-URI, שמוצג בתוצאות החיפוש.
תשובה

אתם אמורים לקבל תגובת JSON שדומה לזו:
```
{
 "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/controls/PROMOTE_CONTROL_ID",
 "displayName": "PROMOTE_CONTROL_NAME",
 "solutionType": "SOLUTION_TYPE_SEARCH",
 "conditions": [
   {
     "queryTerms": [
       {
         "value": "VALUE",
         "fullMatch": true
       }
     ]
   }
 ],
 "useCases": [
   "SEARCH_USE_CASE_SEARCH"
 ],
 "promoteAction": {
   "dataStore": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/dataStores/DATA_STORE_ID",
   "searchLinkPromotion": {
     "title": "URI_TITLE",
     "uri": "URI",
     "description": "URI_DESCRIPTION",
     "enabled": ENABLED_TRUE|FALSE
  }
 }
}
```
התשובה מכילה מזהים של פקדי קידום שצריך לצרף לפקד הקידום באפליקציית החיפוש.

מצרפים את אמצעי הבקרה להגדרת הצגת המודעות של האפליקציה באמצעות ה-method‏ engines.servingConfigs.patch. הסדר שבו מצרפים את promoteControlIds בבקשה הבאה הוא הסדר שבו התוצאות המקודמות מוחזרות.

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/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search?update_mask=promote_control_ids" \
-d '{
  "promoteControlIds": ["PROMOTE_ID_1", "PROMOTE_ID_2"]
}'

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

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

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

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

Gemini Enterprise
בוחרים את האפליקציה שרוצים לשנות את אמצעי הבקרה שלה.
לוחצים על Configurations (הגדרות) ואז על הכרטיסייה Control (בקרה).
ברשימת אמצעי הבקרה של האפליקציה, לוחצים על ליד אמצעי הבקרה שרוצים לשנות ולוחצים על עריכה.
עורכים את אמצעי הבקרה בחלונית עריכת אמצעי הבקרה:
1. כדי להפעיל או להשבית אמצעי בקרה, ברשימת אמצעי הבקרה של האפליקציה, לוחצים על באמצעי הבקרה שרוצים להפעיל או להשבית, ואז לוחצים על הפעלה או על השבתה, בהתאמה.
2. כדי למחוק פקד, ברשימת הפקדים של האפליקציה, לוחצים על לצד הפקד שרוצים למחוק ואז על מחיקה.

המאמרים הבאים

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

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

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

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

מידע על התנאים

יצירה וצירוף של אמצעי בקרה להצגת תוכן מחוזק

המסוף

REST

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

המסוף

REST

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

המסוף

REST

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

יצירה וצירוף של אמצעי בקרה לקידום תוכן

המסוף

REST

תשובה

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

המאמרים הבאים

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