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

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

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

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

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

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

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

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

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

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

מידע על תנאים

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

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

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

  • טווח זמן (activeTimeRange). אמצעי בקרה אופציונלי שמוחל כשמתרחשת בקשה בטווח זמן מוגדר. היא בודקת אם השעה שבה התקבלה הבקשה היא בין activeTimeRange.startTime ל-activeTimeRange.endTime. אפשר לציין עד 10 טווחי activeTimeRange בControl.condition אחד. אם לא מציינים את השדה activeTimeRange, המערכת מתעלמת ממנו.

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

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

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

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

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

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

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

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

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

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

המסוף

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

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

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

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

  4. בשלב אות, לוחצים על המשבצת הדגשה/הסתרה.

  5. לוחצים על יצירת אמצעי בקרה.

  6. בשדה Name Your Control (מתן שם לקבוצת הבקרה) מזינים שם לקבוצת הבקרה של ההדגשה או ההסתרה ולוחצים על Continue (המשך).

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

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

    2. בקטע פילטר, מוסיפים פילטר.

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

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

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

    4. לוחצים על Continue.

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

    1. מוסיפים מונחים לשאילתות בהתאמה חלקית. הבקרה נכנסת לתוקף כשיש התאמה חלקית בין מונחי השאילתה האלה.

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

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

    4. לוחצים על Continue.

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

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

    2. לוחצים על Continue.

  10. לוחצים על שליחה.

REST

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

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

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

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

    1. נכנסים לדף AI Applications במסוף Google Cloud .

      מעבר אל 'אפליקציות'

    2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

  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: מחרוזת שמציינת דרישות שהמסמך צריך לעמוד בהן. אם המסמך עומד בכל הדרישות, המערכת תחיל את ההגדרה. אחרת, לא יחול שינוי. אם השדה הזה ריק, ההדגשה חלה על כל המסמכים במאגר הנתונים. מידע על תחביר הסינון זמין במאמרים בנושא תחביר של ביטויי סינון ותחביר של הוספת אתרים לאינדקס. רשימת שדות של מאפייני מפתח שאפשר להשתמש בהם במסננים זמינה במאמר מאפייני מפתח שתומכים בסינון.
    • ‫DATA_STORE_RESOURCE_PATH: נתיב המשאב המלא של מאגר הנתונים שהמסמכים שלו צריכים לקבל דירוג גבוה יותר באמצעות אמצעי הבקרה הזה. הפורמט של הנתיב המלא למשאב הוא projects/PROJECT_NUMBER/locations/LOCATION_ID/collections/default_collection/dataStores/DATA_STORE_ID. מאגר הנתונים הזה חייב להיות מצורף למנוע שצוין בבקשה.

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

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

מסנן להצגת מודעות מסנן לפי קריטריון או כלל מסוים. לדוגמה, באתר של מלון, אפשר להחיל מסנן (price < 175 AND petfriendly = "true") כדי להציג רק מלונות שמקבלים חיות מחמד במחיר של פחות מ-175 $ללילה.

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

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

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

המסוף

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

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

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

  3. בדף הסקירה הכללית של האפליקציה, מוודאים שאתם בכרטיסייה System overview.

  4. בשלב אות, לוחצים על המשבצת מסנן.

  5. לוחצים על יצירת אמצעי בקרה.

  6. בקטע Name Your Control (מתן שם לאמצעי הבקרה), מזינים שם לאמצעי הבקרה של המסנן ולוחצים על Continue (המשך).

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

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

    2. בקטע Filter, מציינים לכלל אילו פריטים ספציפיים לחפש. אפשר לשלב מונחי חיפוש באמצעות AND,‏ OR,‏ NOT ולקבץ מונחים באמצעות (). כדי לחפש ביטויים מדויקים, משתמשים במירכאות "". לדוגמה: status: "open" AND priority:"P1".

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

    3. לוחצים על Continue.

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

    1. מוסיפים מונחים לשאילתות בהתאמה חלקית. הבקרה נכנסת לתוקף כשיש התאמה חלקית בין מונחי השאילתה האלה.

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

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

    4. לוחצים על Continue.

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

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

    2. לוחצים על Continue.

  10. לוחצים על שליחה.

REST

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

    1. נכנסים לדף AI Applications במסוף Google Cloud .

      מעבר אל 'אפליקציות'

    2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

  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. מידע על תחביר הסינון זמין במאמרים תחביר של ביטויי סינון ותחביר של הוספת אתרים מתקדמת לאינדקס.

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

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

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

המסוף

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

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

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

  3. בדף הסקירה הכללית של האפליקציה, מוודאים שאתם בכרטיסייה System overview.

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

  5. לוחצים על יצירת אמצעי בקרה.

  6. בקטע Name Your Control (מתן שם לבקרה), מזינים שם לבקרת המילים הנרדפות ולוחצים על Continue (המשך).

  7. בקטע היקף ההשפעה של הכלל:

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

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

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

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

    2. לוחצים על Continue.

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

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

    2. לוחצים על Continue.

  10. לוחצים על שליחה.

REST

  1. מריצים את פקודות ה-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.

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

    1. נכנסים לדף AI Applications במסוף Google Cloud .

      מעבר אל 'אפליקציות'

    2. בדף אפליקציות, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה מזהה.

  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.

  3. מצרפים את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות המתודה 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: אי אפשר לציין את התנאי הזה אם מציינים את התנאי queryRegex, שרלוונטי רק לחיפוש בסיסי באתר. בחיפוש בסיסי באתר, אם מציינים את queryTerms, צריך להגדיר את fullMatch לערך true. בכל שאר אפליקציות החיפוש, רק queryTerms נתמך, ואפשר להגדיר את fullMatch לערך true או false.
  • ‫queryRegex. האפשרות הזו זמינה רק עבור אמצעי בקרה לקידום הצגת מודעות לחיפוש בסיסי באתר בלבד. התנאי הזה מחיל את אמצעי הבקרה כשהשאילתה תואמת לביטוי הרגולרי שצוין. אי אפשר לציין את התנאי הזה אם מציינים את התנאי queryTerms.

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

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

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

המסוף

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

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

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

  3. בדף הסקירה הכללית של האפליקציה, מוודאים שאתם בכרטיסייה System overview.

  4. בשלב האות, לוחצים על המשבצת קידום.

  5. לוחצים על יצירת אמצעי בקרה.

  6. בקטע Name Your Control (מתן שם לאמצעי הבקרה), מזינים שם לאמצעי הבקרה לקידום ולוחצים על Continue (המשך).

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

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

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

    3. מזינים את כתובת ה-URL לקידום, למשל המיקום של הסרטון.

    4. מזינים את כתובת ה-URL של התמונה לקידום, למשל תמונה ממוזערת או צילום מסך.

    5. מזינים תיאור לקידום קצר, למשל על מה הסרטון. האורך המקסימלי הוא 250 תווים.

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

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

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

    3. לוחצים על Continue.

  9. לוחצים על שליחה.

REST

  1. מריצים את פקודות ה-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": true
    }
  ],
  "activeTimeRange": [
    {
      "startTime": "START_TIMESTAMP",
      "endTime": "END_TIMESTAMP"
    }
  ],
  "queryRegex": "VALUE_REGEX"
},
"promoteAction": {
  "dataStore": "DATA_STORE_RESOURCE_PATH",
  "searchLinkPromotion": {
     "document": "DOCUMENT_RESOURCE_PATH",
     "title": "TITLE",
     "uri": "URI",
     "description": "DESCRIPTION",
     "enabled": ENABLED_TRUE|FALSE,
  }
 }
}'

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

    • ‫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: אובייקט אופציונלי שמגדיר מתי צריך להחיל את אמצעי הבקרה. מכיל את השדות הבאים:
      • ‫queryTerms: אי אפשר להשתמש בו בשדה queryRegex.
        • ‫VALUE: ערך השאילתה הספציפי שצריך להתאים לו. זו מחרוזת UTF-8 באותיות קטנות באורך [1, 5000].
      • activeTimeRange:
        • ‫START_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC ‏'Zulu' שמציינת את ההתחלה של טווח זמן.
        • ‫END_TIMESTAMP: חותמת זמן בפורמט RFC 3339 UTC ‏'Zulu' שמציינת את סוף טווח הזמן.
      • ‫queryRegex: זמין רק למאגרי נתונים עם חיפוש בסיסי באתר. אי אפשר להשתמש בשדה הזה עם השדה queryTerms.
        • ‫VALUE_REGEX: ביטוי רגולרי להתאמה של השאילתה.
    • ‫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.
      • במאגרי נתונים של אתרים, השדה הזה צריך להיות לא מוגדר, ובמקומו צריך להגדיר את השדה URI.
    • ‫TITLE: שדה חובה שבו מציינים את שם המסמך או דף האינטרנט שמקדמים. הכותרת הזו מוצגת בתוצאת החיפוש.
    • ‫URI: שדה חובה שבו מציינים את קישור ה-URI שאליו תוצאת החיפוש מובילה את המשתמש. אין צורך לכלול את ה-URI הזה במאגר הנתונים.
      • במאגרי נתונים לחיפוש עם נתונים מובְנים ולא מובְנים, צריך לספק את נתיב משאב המסמך בשדה DOCUMENT_RESOURCE_PATH, את ה-URI בשדה DOCUMENT_RESOURCE_PATH, או את שניהם.URI
      • בשדות של מאגרי נתונים באתרים, חובה להגדיר את השדה הזה.
    • ‫DESCRIPTION: שדה אופציונלי לתיאור המסמך או דף האינטרנט שרוצים לקדם, שמוצג בתוצאת החיפוש.
    • ‫ENABLED_TRUE|FALSE: שדה בוליאני אופציונלי שמציין אם אמצעי הבקרה לקידום מופעל ומצורף לאפליקציה. השדה הזה רלוונטי למאגרי נתונים של אתרים עם חיפוש בסיסי באתר בלבד. כשמגדירים את השדה הזה לערך false, אמצעי הבקרה להצגת קידום מושבת. כדי שאמצעי הבקרה ייכנס לתוקף, צריך לעדכן אותו ולהפעיל אותו, כמו שמוסבר בשלב הבא. מידע נוסף זמין במאמר promoteAction.

  2. בכל אפליקציות החיפוש, חוץ מאפליקציות חיפוש בסיסיות באתרים, צריך לצרף את אמצעי הבקרה להגדרת ההצגה של האפליקציה באמצעות השיטה 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 במזהי הבקרה שיצרתם בשלב הקודם.

  3. אופציונלי: כדי לבצע חיפוש בסיסי באתר, לא צריך לצרף את אמצעי הבקרה להגדרת ההגשה של האפליקציה. עם זאת, כדי לבצע חיפוש בסיסי באתר, אפשר להפעיל או להשבית את אמצעי הבקרה לקידום אחרי שהוא נוצר, ולקרוא לשיטה engines.control.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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID?updateMask=promoteAction.searchLinkPromotion.enabled" \
-d '{
"promoteAction": {
  "searchLinkPromotion": {
     "enabled": ENABLED_TRUE|FALSE,
  }
}
}'

דוגמה

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

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

{
 "conditions": [
   {
     "queryTerms": [
       {
         "value": "artificial intelligence",
         "fullMatch": true
       }
     ]
   }
 ]"
 ...
 promoteAction": {
  "dataStore": "https://discoveryengine.googleapis.com/v1alpha/projects/123456/locations/us/collections/default_collection/dataStores/basic-website-data-store" \
  "searchLinkPromotion": {
    "title": "What is AI?",
    "uri": "https://cloud.google.com/learn/what-is-artificial-intelligence",
    "description": "Explain what is AI"
    "enabled": true
  }
 }
}

לאחר מכן שולחים את בקשת החיפוש הבאה:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/123456/locations/us/collections/default_collection/engines/basic-website-app/servingConfigs/default_search:search" \
  -d '{
"query": "artificial intelligence"
}'

אתם אמורים לקבל תגובת JSON שדומה לתגובה הבאה (התגובה קוצרה). התשובה מכילה את השדה searchLinkPromotions שכולל את הקישור המקודם.

{
 "results": [...],
  "totalSize": 3,
  "attributionToken": "_gHw_QoMCMSbhboGELuI1qwCEiQ2NzQwYmYzYi0wMDAwLTJmYTctYTk1OC0yNDA1ODg4MzZmYjgiB0dFTkVSSUMqvAGrxIotzua1L5neqC_n7YgtxPzLMIOymiK0kq4wxPi8MPn2sy3LmrQw6d3EMNSynRWc1rctnN3YMOuCsS3ogrEto4CXIsLwnhX89rMtkKS0MJbeqC-jibMtkPeyMMTGsTCZ3dgw5O2ILa7Eii2NpLQw5t3EMN6PmiKOvp0VwfzLMICymiKq-LMt0ea1L634sy3Fy_MXtreMLbeSrjDHxrEwzpq0MMH4vDCgibMtn9a3LZSSxTCOkckw24-aIjAB",
  "guidedSearchResult": {},
  "summary": {},
  "searchLinkPromotions": [
    {
      "title": "What is AI?",
      "uri": "https://cloud.google.com/learn/what-is-artificial-intelligence",
      "description": "Explain what is AI"
    }
  ]
}

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

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

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

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

  3. בכרטיסייה System overview, בוחרים בשלב Prepare או Signal שבו נמצא אמצעי הבקרה.

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

  5. עורכים את אמצעי הבקרה בחלונית עריכת אמצעי הבקרה:

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

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

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

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