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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

לדוגמה, אמצעי הבקרה יכולים להבליט תוצאות או להסתיר אותן, לסנן רשומות מתוצאות שהוחזרו, לשייך מחרוזות זו לזו כמילים נרדפות או להפנות תוצאות לכתובות 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 (שליטה).
לוחצים על יצירת אמצעי בקרה.
בקטע What do you want to do?‎ (מה ברצונך לעשות?), מציינים את שם אמצעי הבקרה ואת הסוג שלו:
1. בשדה שם אמצעי הבקרה, מזינים שם לאמצעי הבקרה להדגשה או להסרה.
2. בשדה Control Type, בוחרים באפשרות Boost/bury.
3. לוחצים על Continue.
בקטע הגדרת היקף ההשפעה של הכלל, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. בוחרים מאגר נתונים מהרשימה. אם רוצים שהפעולה תחול על כמה מאגרי נתונים, צריך ליצור אמצעי בקרה לכל מאגר נתונים.
2. בקטע פילטר, מוסיפים פילטר.
  
  זו מחרוזת שמציינת דרישות שהמסמך צריך לעמוד בהן. תנאי ההגברה יחול רק אם המסמך עומד בכל הדרישות. אחרת, לא יחול שינוי. אם לא מציינים מסנן, ההגברה חלה על כל המסמכים במאגר הנתונים.
  
  מידע על תחביר הסינון מופיע במאמר בנושא תחביר של ביטויי סינון.
3. בקטע ערך להדגשה/הסתרה, משתמשים בפס ההזזה כדי לבחור ערך להדגשה או להסתרה בטווח [‎-1, 1]. פס ההזזה נע בקפיצות של 0.01.
4. לוחצים על Continue.
בקטע אופציונלי: כשהכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מוגדרים תנאים, אמצעי הבקרה תמיד בתוקף:
1. מוסיפים מונחים לשאילתות בהתאמה חלקית. הבקרה נכנסת לתוקף כשיש התאמה חלקית בין מונחי השאילתה האלה.
2. מוסיפים מונחים מדויקים לשאילתות. אמצעי הבקרה ייכנס לתוקף כשהמונחים בשאילתה יהיו זהים בדיוק.
3. כדי להוסיף טווח זמנים פעיל, לוחצים על הוספת טווח זמנים ומגדירים את שעת ההתחלה 1 ואת שעת הסיום 1. המאפיין הזה מגדיר את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
4. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם רוצים להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שהוא נוצר, משביתים את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

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

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

לפרטים על השדות, אפשר לעיין בengines.controls הפניית API וב-engines.controls.create הפניית API.

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
מריצים את פקודות ה-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. מאגר הנתונים הזה חייב להיות מצורף למנוע שצוין בבקשה.

מצרפים את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות המתודה 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 (שליטה).
לוחצים על יצירת אמצעי בקרה.
בקטע What do you want to do?‎ (מה ברצונך לעשות?), מציינים את שם אמצעי הבקרה ואת הסוג שלו:
1. בשדה Control name, מזינים שם לרכיב השליטה של המסנן.
2. בקטע סוג אמצעי הבקרה, בוחרים באפשרות מסנן.
3. לוחצים על Continue.
בקטע הגדרת היקף ההשפעה של הכלל, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. בוחרים מאגר נתונים מהרשימה. אם רוצים להחיל את הפעולה על כמה מאגרי נתונים, צריך ליצור אמצעי בקרה לכל מאגר נתונים.
2. בקטע Filter, מציינים לכלל אילו פריטים ספציפיים לחפש. אפשר לשלב מונחי חיפוש באמצעות AND, OR NOT ולקבץ מונחים באמצעות (). כדי לחפש ביטויים מדויקים, משתמשים במירכאות (""). לדוגמה: category: "electronics" AND price < 500, status: "open" AND priority:"P1".
  
  מידע על תחביר הסינון מופיע במאמר בנושא תחביר של ביטויי סינון.
3. לוחצים על Continue.
בקטע אופציונלי: כשהכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מוגדרים תנאים, אמצעי הבקרה תמיד בתוקף:
1. מוסיפים מונחים לשאילתות בהתאמה חלקית. הבקרה נכנסת לתוקף כשיש התאמה חלקית בין מונחי השאילתה האלה.
2. מוסיפים מונחים מדויקים לשאילתות. אמצעי הבקרה ייכנס לתוקף כשהמונחים בשאילתה יהיו זהים בדיוק.
3. כדי להוסיף טווח זמנים פעיל, לוחצים על הוספת טווח זמנים ומגדירים את שעת ההתחלה 1 ואת שעת הסיום 1. המאפיין הזה מגדיר את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
4. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם רוצים להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שהוא נוצר, משביתים את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

לפרטים על השדות, אפשר לעיין בengines.controls הפניית API וב-engines.controls.create הפניית API.

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
מריצים את פקודות ה-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 (שליטה).
לוחצים על יצירת אמצעי בקרה.
בקטע What do you want to do?‎ (מה ברצונך לעשות?), מציינים את שם אמצעי הבקרה ואת הסוג שלו:
1. בשדה Name Your Control, מזינים שם לבקר המילים הנרדפות.
2. בקטע סוג הבקרה, בוחרים באפשרות מילים נרדפות.
3. לוחצים על Continue.
בקטע הגדרת היקף ההשפעה של הכלל, מגדירים את הפעולות שרוצים להפעיל באמצעות אמצעי הבקרה הזה:
1. מזינים את המילים הנרדפות שרוצים שהמערכת תתייחס אליהן בבקרה. לדוגמה, מזינים cats ואז מקש Enter (לא פסיק), ואז feline.
2. לוחצים על Continue.
בקטע אופציונלי: כשהכלל הזה מופעל, מגדירים את התנאים הבאים שמפעילים את אמצעי הבקרה. אם לא מוגדרים תנאים, אמצעי הבקרה תמיד בתוקף:
1. כדי להוסיף טווח זמנים פעיל, לוחצים על הוספת טווח זמנים ומגדירים את שעת ההתחלה 1 ואת שעת הסיום 1. המאפיין הזה מגדיר את חלון הזמן שבו התנאי פעיל. אפשר להוסיף עד 10 טווחי זמן.
2. לוחצים על Continue.
בקטע הגדרות נוספות, בוחרים אם רוצים להפעיל את הכלל:
1. אם אתם לא רוצים להפעיל את אמצעי הבקרה הזה מיד אחרי שהוא נוצר, משביתים את האפשרות פרסום אמצעי הבקרה הזה באופן מיידי.
2. לוחצים על Continue.
לוחצים על שליחה.

REST

לפרטים על השדות, אפשר לעיין בengines.controls הפניית API וב-engines.controls.create הפניית API.

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
מריצים את פקודות ה-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.

מצרפים את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות המתודה 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.

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

לפרטים על השדות, אפשר לעיין בengines.controls הפניית API וב-engines.controls.create הפניית API.

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
מריצים את פקודות ה-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

לפרטים על השדות, אפשר לעיין בengines.controls הפניית API וב-engines.controls.create הפניית API.

מאתרים את מזהה האפליקציה. אם כבר יש לכם מזהה אפליקציה, דלגו לשלב הבא.
1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .
  
  מעבר אל 'אפליקציות'
2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.
מריצים את פקודות ה-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: נתיב המשאב המלא של מאגר הנתונים שתוצאות החיפוש שלו מכילות את כתובת ה-URL המקודמת. הפורמט של הנתיב המלא למשאב הוא 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

תשובה

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

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

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