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

מסוף Cloud

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

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

   החלונית 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:

• מידע נוסף על השיטה הזו זמין במאמר בנושא ServingConfig.addControl הפניית API.

• דוגמה לשיטה הזו מופיעה במאמר בנושא ניהול הגדרות של הצגת מודעות.

מסוף Cloud

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

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

   החלונית 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:

• מידע נוסף על השיטה הזו זמין במאמר בנושא ServingConfig.addControl הפניית API.

• דוגמה לשיטה הזו מופיעה במאמר בנושא ניהול הגדרות של הצגת מודעות.

מסוף Cloud

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

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

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

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

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

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

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

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