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

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

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

לדוגמה, אמצעי הבקרה יכולים להבליט תוצאות ולהסתיר תוצאות אחרות, לסנן רשומות מתוצאות שהוחזרו, לשייך מחרוזות זו לזו כמילים נרדפות או להפנות תוצאות לכתובות 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 'זולו' שמציינת את ההתחלה של טווח זמן.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC 'זולו' שמציינת את סוף טווח הזמן.
- ‫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. בקטע מסנן, מציינים את הפריטים הספציפיים שהכלל צריך לחפש. אפשר לשלב מונחי חיפוש באמצעות 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 'זולו' שמציינת את ההתחלה של טווח זמן.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC 'זולו' שמציינת את סוף טווח הזמן.
- ‫FILTER: מחרוזת שמציינת דרישות שהמסמך צריך לעמוד בהן. אם המסמך עומד בכל הדרישות, הוא יופיע בתוצאות. אחרת, המסמך לא יופיע בתוצאות. מידע על תחביר הסינון זמין במאמר תחביר של ביטויי סינון. מידע נוסף זמין במאמר filterAction. הערה: אי אפשר לסנן את שדה המסמך title.

מצרפים את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות המתודה 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 'זולו' שמציינת את ההתחלה של טווח זמן.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC 'זולו' שמציינת את סוף טווח הזמן.
- ‫SYNONYMS_N: רשימה של מחרוזות שמשויכות זו לזו, כך שסביר יותר שכל אחת מהן תציג תוצאות דומות. למרות שסביר יותר שתקבלו תוצאות דומות, כשמחפשים כל אחת מהמילים הנרדפות, יכול להיות שלא תקבלו את כל התוצאות הרלוונטיות לכל המילים הנרדפות המשויכות. צריך לציין לפחות שני מילים נרדפות, ואפשר לציין עד 100 מילים נרדפות. כל מילה נרדפת צריכה להיות מקודדת ב-UTF-8 ובאותיות קטנות. אסור להשתמש במחרוזות משוכפלות. לדוגמה, אפשר להוסיף את המילים "pixel",‏ "טלפון 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 'זולו' שמציינת את ההתחלה של טווח זמן.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC 'זולו' שמציינת את סוף טווח הזמן.
- ‫REDIRECT_URI_N: ‏URI שאליו מופנים. האורך המקסימלי הוא 2,000 תווים. לדוגמה, אם ערך מונח השאילתה הוא 'תמיכה', אפשר להגדיר הפניה לדף התמיכה הטכנית במקום להחזיר (או לא להחזיר) תוצאות חיפוש למונח 'תמיכה'. בדוגמה הזו, מזהה ה-URI להפניה מותנית הופך ל-"https://www.example.com/support". מידע נוסף זמין במאמר redirectAction.

מצרפים את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות המתודה 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 'זולו' שמציינת את ההתחלה של טווח זמן.
  - ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC 'זולו' שמציינת את סוף טווח הזמן.
- ‫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
  }
 }
}
```
התשובה מכילה מזהים של אמצעי בקרה לקידום, שצריך לצרף לאמצעי הבקרה לקידום באפליקציית החיפוש.

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

תשובה

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

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

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