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

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

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

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

אפשר לראות את אמצעי הבקרה להצגת תוצאות של AI Commerce Search באמצעות המסוף וה-API.

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

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

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

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

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

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

מידע נוסף על השיטה הזו זמין במאמר בנושא Control.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/controls/CONTROL_ID'

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

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

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

מידע נוסף על השיטה הזו זמין במאמר בנושא Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

בקרות להצגת תיקונים בתוך הדף

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

מידע נוסף על השיטה הזו זמין במאמר בנושא Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

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

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

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

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

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

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

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

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

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

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

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

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

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

    כניסה לדף Controls

  2. בשורה בטבלה של אמצעי הבקרה שרוצים להסיר, לוחצים על מחיקה.

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

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

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

מידע נוסף על השיטה הזו זמין במאמר בנושא Controls.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/controls/SERVING_CONTROL_ID'

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

אפשר לייצא את אמצעי הבקרה להצגת מודעות לקובץ בקטגוריה של Cloud Storage.

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

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

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

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

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

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

    כניסה לדף Controls

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

  3. בחלון Export Serving Controls (ייצוא אמצעי בקרה להצגת מודעות), בוחרים את הקטגוריה של Cloud Storage שאליה רוצים לייצא את קובץ אמצעי הבקרה.

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

    האמצעים לבקרה שמיוצאים נשמרים בקובץ NDJSON בקטגוריה שנבחרה, עם שם בפורמט הבא:

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

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

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

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

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

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

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

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

  1. עורכים ובודקים קובץ של אמצעי בקרה על הצגת מודעות שיוצא, וממקמים את הקובץ בקטגוריה של Cloud Storage. (כדי לייצא את אמצעי הבקרה להצגת מודעות, אפשר לעיין במשימה הקודמת ייצוא אמצעי הבקרה להצגת מודעות).

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

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

    כניסה לדף Controls

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

  4. בחלון ייבוא אמצעי בקרה להצגת מודעות:

    1. מעיינים ב-Cloud Storage ובוחרים את הקטגוריה ואת קובץ ה-NDJSON שמכילים את אמצעי הבקרה שרוצים לייבא.

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

    3. בודקים את התוכנית בתצוגה המקדימה של הייבוא. הפקדים שייווצרו מוצגים בכרטיסייה New, והפקדים שישופצו מוצגים בכרטיסייה Modified.

  5. לוחצים על Import.

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

  6. אחרי שהייבוא מסתיים, אפשר לראות את סטטוס הפעולה בכרטיסייה אמצעי בקרה בחלון סטטוס הפעילות. פותחים את החלון Activity status (סטטוס הפעילות) על ידי לחיצה על Show (הצגה) בחלון ההודעה או על ידי ביצוע ההוראות במאמר בדיקת הסטטוס של פעולת שילוב ספציפית.