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

בדף הזה מוסבר איך ליצור אמצעי בקרה להצגת מודעות.

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

אתם יכולים ליצור אמצעי בקרה להצגת תוצאות ב-AI Commerce Search במסוף של Gemini Enterprise for Customer Experience. אמצעי הבקרה כולל תנאי שמפעיל אותו ופעולה שמתבצעת כשהתנאי מופעל. לאחר מכן תוכלו לצרף את אמצעי הבקרה החדש על הצגת המודעות להגדרת הצגת מודעות.

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

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

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

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

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

הגדרות של ביצוע משימות קובעות אילו אמצעי בקרה יחולו במהלך חיפוש או בקשה לחיזוי. בזמן הצגת המודעה, נלקחות בחשבון רק אמצעי הבקרה בהגדרת הצגת המודעות הפעילה של הבקשה. לדוגמה, נניח שיצרתם שני אמצעי בקרה: אמצעי בקרה בשם gShoe Sale שמקדם תוצאות של המותג gShoe כשמחפשים את המונח shoes, ואמצעי בקרה בשם More shoes שמרחיב שאילתות שכוללות את המונח running shoes כך שיכללו גם את המונח sport shoes. אם תצרפו רק את אמצעי הבקרה gShoe Sale להגדרת הצגה, בקשות חיפוש שמשתמשות בהגדרת ההצגה הזו יקבלו תוצאות משופרות של gShoe לשאילתות שכוללות את המונח shoes,אבל לא תהיה השפעה לאמצעי הבקרה More shoes כי הוא לא מצורף להגדרת ההצגה שבה אתם משתמשים.

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

סרטונים ומדריכים למתחילים

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

במדריך הזה מוסבר איך להשתמש בכלי לניהול הפניות אוטומטיות.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

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

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

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

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

אפשר ליצור עד 100 אמצעי בקרה להצגת תוצאות ב-AI Commerce Search. אם אתם צריכים אמצעי בקרה נוספים על הצגת המודעות, אתם יכולים לבקש מכסה נוספת. כדי לעשות זאת, פועלים לפי השלבים שמפורטים במאמר בנושא הגדלת המכסות.

בכל הגדרת הצגה יכולים להיות עד 100 אמצעי בקרה להצגת מודעות מכל סוג, למעט אמצעי בקרה להפניה אוטומטית של חיפושים, שבהם המגבלה היא עד 1,000 לכל הגדרת הצגה. חשוב לזכור שהמכסה שלכם להגדרות בקרה בהגדרת תצורה אחת של הצגת מודעות עשויה להיות שונה מהמכסה הכוללת שמותרת לסוג בקרה ב-AI Commerce Search API.

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

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

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

    כניסה לדף Controls

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

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

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

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

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

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

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

  5. בקטע בחירת מוצרים, בוחרים באפשרות חיפוש.

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

  7. בקטע Triggers (טריגרים), בוחרים את סוג התנהגות המשתמש שמפעיל את אמצעי הבקרה הזה.

    • עיון בקטגוריות: הכלל מופעל כשמשתמש מעיין בקטגוריות באתר שלכם (הערך של search.request.query ריק).

    • חיפוש: הכלל מופעל כשמשתמש מבצע חיפוש באתר (search.request.query לא ריק). כדי להגדיר את אמצעי הבקרה הזה כך שיופעל כשמעיינים בקטגוריה כלשהי או כשמחפשים שאילתה כלשהי, מדלגים על השלב הבא.

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

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

    • אם בחרתם באפשרות חיפוש: לוחצים על הלחצן הוספת שאילתה כדי להוסיף מונחי שאילתה (לדוגמה, running shoes) לסינון. לכל מונח, בוחרים באפשרות התאמה חלקית או התאמה מלאה.

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

  10. לוחצים על המשך כדי לעבור לקטע פעולות.

  11. מוסיפים מסננים למאפייני מוצרים בשדה הדגשת מוצר/הסתרת מוצר.

    משתמשים בתחביר של ביטויי המסננים שמתועד במאמר בנושא סינון ומיון. לדוגמה, כדי לציין גרסאות אדומות וכחולות של product1 ו-product2: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

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

  13. בקטע Serving configs (הגדרות להצגת מודעות), בוחרים את ההגדרות להצגת מודעות שרוצים להחיל עליהן את אמצעי הבקרה.

  14. שולחים את הגדרות הבקרה.

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

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

curl

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

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

אפשר להפעיל את אמצעי הבקרה להדגשה או להסרה של תוצאות חיפוש כשמשתמשים מעיינים בקטגוריות באתר שלכם (search.request.query ריק), או כשמשתמשים מחפשים באתר שלכם (search.request.query לא ריק).

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

בדוגמה הבאה מוצגים שדות של אמצעי בקרה שמופעל על ידי חיפוש, כאשר הערך searchSolutionUseCase מוגדר ל-SEARCH_SOLUTION_USE_CASE_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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

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

  7. לוחצים על המשך כדי לעבור לקטע פעולות.

  8. מוסיפים מסננים למאפייני מוצרים בשדה הדגשת מוצר/הסתרת מוצר.

    משתמשים בתחביר של ביטויי המסננים שמתועד במאמר בנושא המלצות לסינון.

    לדוגמה, כדי לציין גרסאות אדומות וכחולות של product1 ו-product2: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

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

  10. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  12. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

יצירת אמצעי בקרה של מסנן

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

    • עיון בקטגוריות: הכלל מופעל כשמשתמש מעיין בקטגוריות באתר שלכם (הערך של search.request.query ריק).

    • חיפוש: הכלל מופעל כשמשתמש מבצע חיפוש באתר (search.request.query לא ריק).

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

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

    • אם בחרתם באפשרות חיפוש: לוחצים על הלחצן הוספת שאילתה כדי להוסיף מונחי שאילתה (לדוגמה, running shoes) לסינון, ובוחרים אחת מהאפשרויות הבאות לכל מונח:

      • התאמה חלקית: אמצעי הבקרה הזה חל כשהשאילתה מכילה התאמה חלקית למונח השאילתה הזה.
      • התאמה מלאה: האפשרות הזו רלוונטית רק כששאילתה מכילה התאמה מלאה למונח השאילתה הזה.

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

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

  10. לוחצים על המשך כדי לעבור לקטע פעולות.

  11. מוסיפים מסננים למאפייני מוצר בשדה Filter action.

    משתמשים בתחביר של ביטויי המסננים שמתועד במאמר בנושא סינון ומיון.

    לדוגמה, כדי לציין גרסאות אדומות וכחולות של product1 ו-product2: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  14. שולחים את הגדרות הבקרה.

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

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

curl

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

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

אפשר להפעיל את אמצעי הבקרה של המסנן כשמשתמשים מעיינים בקטגוריות באתר (search.request.query ריק), או כשמשתמשים מחפשים באתר (search.request.query לא ריק).

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

בדוגמה הבאה מוצגים שדות של אמצעי בקרה שמופעל על ידי חיפוש, כאשר הערך searchSolutionUseCase מוגדר ל-SEARCH_SOLUTION_USE_CASE_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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

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

    • עיון בקטגוריות: הכלל מופעל כשמשתמש מעיין בקטגוריות באתר שלכם (הערך של search.request.query ריק).

    • חיפוש: הכלל מופעל כשמשתמש מבצע חיפוש באתר (search.request.query לא ריק).

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

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

    • אם בחרתם באפשרות חיפוש: לוחצים על הלחצן הוספת שאילתה כדי להוסיף מונחי שאילתה (לדוגמה, running shoes) לסינון, ובוחרים אחת מהאפשרויות הבאות לכל מונח:

      • התאמה חלקית: אמצעי הבקרה הזה חל כשהשאילתה מכילה התאמה חלקית למונח השאילתה הזה.
      • התאמה מלאה: האפשרות הזו רלוונטית רק כששאילתה מכילה התאמה מלאה למונח השאילתה הזה.

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

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

  11. לוחצים על המשך כדי לעבור לקטע פעולות.

  12. מזינים את ה-URI שאליו תתבצע ההפניה כשהפקד הזה יופעל.

  13. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  15. שולחים את הגדרות הבקרה.

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

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

curl

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

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

הפניה אוטומטית יכולה להיות מופעלת כשמשתמשים מעיינים בקטגוריות באתר שלכם (search.request.query ריק), או כשמשתמשים מבצעים חיפוש באתר שלכם (search.request.query לא ריק).

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

בדוגמה הבאה מוצגים שדות של אמצעי בקרה שמופעל על ידי חיפוש, כאשר הערך searchSolutionUseCase מוגדר ל-SEARCH_SOLUTION_USE_CASE_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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

מידע נוסף על סוג ההגדרה הזה זמין במאמר בנושא הגדרות של מילים נרדפות דו-כיווניות.

מסוף Cloud

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

    כניסה לדף Controls

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

  3. בשדה שם אמצעי הבקרה, מזינים שם לאמצעי הבקרה החדש.

    החלונית Create control תיפתח.

  4. תועברו לקטע העדפות.

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

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

  7. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

  9. לוחצים על המשך כדי לעבור לקטע פעולות.

  10. בשדה מילים נרדפות מזינים 2 עד 100 מונחי שאילתה (לדוגמה, shirt ו-top) שצריכים להיות מילים נרדפות.

    אם אחד מהמונחים האלה נכלל בשאילתה, search מתייחס למונחים האחרים בשאילתה כמילים נרדפות למונח שנכלל.

  11. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  13. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת התצורה של הצגת המודעות, משתמשים ב-method‏ ServingConfig.addControl. איך מוסיפים אמצעי בקרה להגדרות של הצגת מודעות בתוך הקו?

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

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

  5. בוחרים באפשרות One-way synonym control (שליטה חד-כיוונית במילים נרדפות) כסוג אמצעי הבקרה.

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

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

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

  10. בשדה Synonyms (מילים נרדפות), מזינים מונחים שצריכים לשמש כמילים נרדפות למונחי השאילתה שציינתם (לדוגמה, sneakers ו-sandals כמילים נרדפות חד-כיווניות למונח השאילתה shoes).

  11. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  13. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

יצירת אמצעי בקרה מסוג 'לא לשייך'

מידע נוסף על סוג הבקרה הזה זמין במאמר בנושא כללי בקרה של 'לא לשייך'.

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

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

  9. בשדה תנאי שאילתה, מזינים את המונחים (לדוגמה, gShoe) שרוצים להבחין ביניהם לבין מונחים אחרים.

  10. בשדה Dissociated terms (מונחים לא משויכים), מזינים מונחים שרוצים לבטל את השיוך שלהם לתוצאות החיפוש עם מונחי השאילתה שצוינו.

    לדוגמה, אפשר לבטל את השיוך של מונח השאילתה gShoe למונח cheap.

  11. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  13. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

מידע נוסף על סוג ההגדרה הזה מופיע במאמר התעלמות מהגדרות.

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

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

  9. בשדה Ignore terms (התעלמות ממונחים), מזינים מונחים (לדוגמה, shoddy) שרוצים שהחיפוש יתעלם מהם כשהם מוזנים כמונחי שאילתה.

  10. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  12. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

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

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

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

  6. לוחצים על 'המשך' כדי לעבור לקטע טריגרים.

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

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

  9. בשדה מונחי שאילתה, מזינים את מונחי השאילתה (לדוגמה, gShoe) שרוצים להחליף במונח החלופי.

  10. בשדה מונח חלופי, מזינים את המונח שצריך להחליף את מונחי השאילתה שציינתם.

    לדוגמה, אפשר להחליף את מונח השאילתה gShoe במונח ההחלפה Google Shoe.

  11. לוחצים על המשך כדי לעבור לקטע הגדרות להצגת מודעות.

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

  13. שולחים את הגדרות הבקרה.

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

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

curl

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

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

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

כדי ליצור לחצן הצמדה:

מסוף Cloud

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

    כניסה לדף Controls

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

    החלונית Create control תיפתח.

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

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

  5. בקטע בחירת מוצרים, בוחרים באפשרות חיפוש או עיון.

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

  7. בקטע Triggers (טריגרים), בוחרים את התנהגות המשתמש שמפעילה את אמצעי הבקרה הזה:

    • דפדוף בקטגוריות: בבקשות דפדוף חובה למלא את השדה page_categories, בנוסף לכך שהשדה search.request.query צריך להיות ריק.

    • חיפוש: כדי לשלוח בקשות חיפוש, צריך למלא רק את search.request.query.

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

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

    • עיון בקטגוריות: בשדה Categories (קטגוריות), מזינים את הקטגוריות שמפעילות את אמצעי הבקרה.

    • חיפוש: כדי להוסיף מונחי שאילתה לסינון (לדוגמה, running shoes), לוחצים על הוספת שאילתה. לכל מונח, בוחרים באפשרות התאמה חלקית או התאמה מלאה.

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

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

    AI Commerce Search מאפשר להוסיף 10 סיכות למפת הסיכות של כל אמצעי בקרה. המיקום יכול להיות כל ערך בין 1 ל-120 (גודל הדף המקסימלי לבקשה).

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

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

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

curl

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

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

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

הערך pin_position צריך להיות מספר שלם בין [1,10] כולל, והערך product_id חייב להופיע בקטלוג. מספר הרכיבים המקסימלי המותר במפת הסיכות הוא 10 לכל אמצעי בקרה.

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

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

במקרה כזה, CONTROL_ID צריך להיות אמצעי הבקרה להצמדה id שיצרתם קודם.

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים בשיטה ServingConfig.addControl:

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

מסוף Cloud

  1. נכנסים לדף Evaluate במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Evaluate

  2. עוברים לכרטיסייה חיפוש.

  3. מזינים שאילתת בדיקה בשדה שאילתת החיפוש.

  4. לוחצים על תצוגה מקדימה של החיפוש.

  5. בודקים את התוצאות כדי לוודא שהמוצרים שבחרתם מוצמדים.

curl 

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

מגבלות לבדיקת שגיאות

כדי לבדוק אם יש שגיאות, חשוב לזכור את ההגבלות הבאות:

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