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

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

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

להמלצות ולהגדרות של הצגת תוצאות חיפוש יש דרישות ואפשרויות שונות:

• הגדרות להצגת המלצות דורשות מודל. אם אתם מתכננים לצרף מודל קיים להגדרת הגשה חדשה, אתם צריכים לקבל את המזהה של המודל שבו אתם מתכננים להשתמש (נדרש כשמשתמשים בשיטה ServingConfig.create).

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

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

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

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

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

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

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

• מסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.
• ‫ServingConfig.create API.

אפשר להגדיר עד 100 הגדרות הצגה לכל קטלוג.

החיפוש פועל עם הגדרות של הצגת מודעות שלא הוגדרו. אפשר להציב כל serving_config_id כחלק מבקשת החיפוש, והמערכת תחפש את הקטלוג באמצעות יכולת החיפוש שמוגדרת כברירת מחדל ב-AI Commerce Search.default_search

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

יצירת הגדרת הצגה במסוף

מוסיפים הגדרת הצגה חדשה בדף הגדרות ההצגה במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

כדי ליצור הגדרת הצגת מודעות חדשה:

1. עוברים לדף Serving Configs במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.
   
   מעבר לדף Serving configs

2. לוחצים על Create serving config (יצירת הגדרת הצגה).

   המלצות

   1. בוחרים באפשרות Recommendation (המלצה) בתור המוצר שבו ישמש קובץ ההגדרה של הצגת המודעות.

   2. נותנים שם להגדרת התצורה להצגת מודעות.

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

   3. אופציונלי: אם צריך, מעדכנים את המזהה.

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

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

      מידע נוסף על יצירת מודלים חדשים

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

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

   6. בוחרים אם להשתמש בשיטה מבוססת-כללים או בשיטה מבוססת-נתונים לגיוון התוצאות:

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

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

      מידע נוסף מופיע במאמר Result diversification (גיוון התוצאות).

   7. בוחרים את רמת הגיוון של תוצאות ההמלצות.

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

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

   חיפוש

   1. בדף Create Serving Config (יצירת הגדרות להצגת מודעות), בוחרים באפשרות Search (חיפוש) בתור המוצר שבו ישמשו ההגדרות להצגת מודעות.
   2. מזינים שם להגדרת ההצגה.
      
      השם צריך להיות באורך של 1, 024 תווים או פחות, ויכול להכיל רק תווים אלפאנומריים, קווים תחתונים, מקפים ורווחים.
   3. אופציונלי: אם צריך, מעדכנים את המזהה.
      
      המזהה נוצר מהשם שאתם מספקים, והוא צריך להיות ייחודי בפרויקט. האורך המרבי הוא 50 תווים, והשם לא יכול להכיל רווחים.
   4. לוחצים על Continue.
   5. בוחרים אם להפעיל את ההיבטים הדינמיים בהגדרת ההצגה הזו.
   6. בוחרים או יוצרים אמצעי בקרה להצגת תוצאות כדי לבצע אופטימיזציה של החיפושים.
      
      למידע נוסף על אמצעי בקרה, אפשר לעיין במאמר יצירה וניהול של אמצעי בקרה.

3. לוחצים על יצירה כדי ליצור את ההגדרה החדשה.

   ההגדרה החדשה מופיעה בדף הגדרות התצורה להצגת מודעות.

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

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

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

יצירת הגדרת הגשה עם ServingConfig.create

אפשר ליצור הגדרת הצגה באמצעות שיטת ה-API‏ ServingConfig.create. מאמרי העזרה של ה-API של השיטה הזו זמינים בכתובת ServingConfig.create.

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

לפרטים נוספים על השדות ServingConfig, אפשר לעיין בהפניית ה-API של ServingConfigs.

המלצות

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

• ‫servingConfigId: שדה חובה. יוצרת מזהה ל-ServingConfig. הערך הזה צריך לכלול 4-63 תווים. התווים התקפים הם /[a-z][0-9]-_/.
• ‫displayName: שדה חובה. השם ServingConfig שמוצג ב-AI Commerce Search במסוף Gemini Enterprise for Customer Experience.
• ‫modelID: שדה חובה. המזהה של המודל שבו רוצים להשתמש בזמן ההצגה.
• ‫priceRerankingLevel: אופציונלי. מגדירים את מידת ההשפעה של דירוג מחדש של מחירים על תוצאות ההמלצות. הערכים המותרים הם no-price-reranking (ערך ברירת המחדל אם לא מוגדר), low-price-raranking,‏ medium-price-reranking ו-high-price-reranking.
• ‫diversityLevel: אופציונלי. הגדרה של מידת הגיוון בתוצאות ההמלצות. הערכים המותרים הם no-diversity (ברירת מחדל), low-diversity,‏ medium-diversity,‏ high-diversity ו-auto-diversity. אם המדיניות diversityLevel לא מוגדרת, הגיוון מושבת.
• ‫diversityType: אופציונלי. הגדרה לערך RULE_BASED_DIVERSITY כדי לגוון את תוצאות ההמלצות על סמך קטגוריית המוצר. הערך המומלץ הוא DATA_DRIVEN_DIVERSITY, כדי לגוון את ההמלצות על סמך למידה ממטא-נתונים של מוצרים, ולאזן בין הרלוונטיות לגיוון הקטגוריות. אם diversityLevel מוגדר אבל diversityType לא מוגדר, ברירת המחדל של diversityType היא מבוססת-כללים. מידע נוסף זמין במאמר בנושא גיוון התוצאות.
• ‫enableCategoryFilterLevel: אופציונלי. הגדרה שקובעת אם להוסיף מסננים נוספים של קטגוריות למודל 'פריטים דומים'. הערכים המותרים הם relaxed-category-match (ערך ברירת מחדל אם לא הוגדר) ו-no-category-match.
• ‫solutionTypes: שדה חובה. ההגדרה היא SOLUTION_TYPE_RECOMMENDATION עבור הגדרות להצגת המלצות.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

חיפוש

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

• ‫servingConfigId: שדה חובה. יוצרת מזהה ל-ServingConfig. הערך הזה צריך לכלול 4-63 תווים. התווים התקפים הם /[a-z][0-9]-_/.
• ‫displayName: שדה חובה. השם ServingConfig שמוצג ב-AI Commerce Search במסוף Gemini Enterprise for Customer Experience.
• ‫facetControlIds: אופציונלי. מזהים של אמצעי בקרה שהוגדרו רק עם FacetSpec set.
• ‫dynamicFacetSpec.mode: אופציונלי. מצב התכונה DynamicFacet. הערכים המותרים הם DISABLED (ברירת מחדל אם לא הוגדר) ו-ENABLED.
• ‫boostControlIds: אופציונלי. מזהים של אמצעי בקרה להגברת הצגת המודעות.
• ‫filterControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מודעות לסינון.
• ‫redirectControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת הפניות אוטומטיות.
• ‫twowaySynonymsControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מילים נרדפות דו-כיוונית.
• ‫onewaySynonymsControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מילים נרדפות חד-כיווניות.
• ‫doNotAssociateControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מודעות שלא משויכות.
• ‫replacementControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מודעות להחלפה.
• ‫ignoreControlIds: אופציונלי. מזהים של אמצעי בקרה להצגת מודעות שהמערכת מתעלמת מהם.
• ‫solutionTypes: שדה חובה. מגדירים את הערך SOLUTION_TYPE_SEARCH להגדרות של הצגת תוצאות חיפוש.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

השלבים הבאים

• שליחת בקשה לחיזויים ממיקום המודעה החדש.