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

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

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

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

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

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

אפשר לערוך את הגדרות ההצגה באמצעות מסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience או באמצעות ה-API.

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

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

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

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

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

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

הגדרות להצגת תיקונים מוטמעות

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

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

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

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

כדי להוסיף אמצעי בקרה להגדרת הצגת מודעות, משתמשים ב-ServingConfig.addControl. הפקד מתווסף למיקום האחרון ברשימת הפקדים שהוא שייך אליה. לדוגמה, הפקד facetSpec מוחל במיקום האחרון של servingConfig.facetSpecIds.

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

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

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

כדי להסיר אמצעי בקרה מהגדרות ההגשה, משתמשים ב-ServingConfig.removeControl.

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

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

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

אפשר לראות את הגדרות ההצגה באמצעות מסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience או באמצעות ה-API.

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

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

צפייה בהגדרות של פרסום מודעות מוטבעות

כדי לראות הגדרת הצגה אחת בשורה, משתמשים ב-ServingConfig.get.

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

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

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

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

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

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

מחיקת הגדרת הצגת מודעות

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

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

כדי למחוק הגדרת הצגה במסוף:

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

    מעבר לדף Serving configs

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

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

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

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

כדי למחוק הגדרת הצגה יחידה בשורה, משתמשים בפקודה ServingConfig.delete.

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

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

בדיקת נתונים סטטיסטיים של הגדרות הצגה

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

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