המרת קמפיינים חכמים לקמפיינים למיקסום הביצועים

החל מגרסה v25_2, ב-Google Ads API מוצגת השיטה SmartCampaignSettingService.GeneratePMaxDraftCampaign שעוזרת להמיר קמפיין חכם לקמפיין למיקסום הביצועים.

איך ההמרה פועלת

כשמבצעים קריאה אל SmartCampaignSettingService.GeneratePMaxDraftCampaign, ה-API יוצר טיוטה של קמפיין למיקסום הביצועים על סמך ההגדרה של קמפיין חכם קיים.

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

• הערך של status הוא PAUSED.
• הערך של creation_status הוא INCOMPLETE.

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

פרמטרים של בקשה

שימו לב: הפרמטרים gbp_enabled ו-image_enabled לא מוטמעים כרגע, ויגרמו לשגיאות אם יוגדרו לערך true בבקשה. השדות האלה יופעלו בגרסה עתידית.

ההודעה GeneratePMaxDraftCampaignRequest מקבלת את השדות הבאים:

• ‫resource_name (חובה): שם המשאב של SmartCampaignSetting שמשויך לקמפיין החכם הקיים שרוצים להמיר, בפורמט הבא:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• ‫validate_only (אופציונלי): אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות או אזהרות שקשורות לאימות, או בעיות אפשריות בהמרות, מוחזרות בשדה validated_info בתגובה.

• ‫gbp_enabled (לא נתמך כרגע): האם להמיר ולקשר את המיקום בפרופיל העסק ב-Google (GBP) שמשויך לקמפיין החכם לקמפיין למיקסום הביצועים שנוצר. ההגדרה של השדה הזה לערך true לא מיושמת כרגע ותחזיר שגיאה GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• ‫image_enabled (לא נתמך כרגע): האם ליצור באופן אוטומטי תמונות נדרשות לקמפיין למיקסום הביצועים (כמו נכסי תמונות אופקיות, ריבועיות ולוגו). ההגדרה של השדה הזה לערך true לא מיושמת כרגע ותחזיר שגיאה IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

פרטי התשובה

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

• ‫pmax_campaign: שם המשאב Campaign של טיוטת הקמפיין למיקסום הביצועים שנוצרה.
• ‫campaign_budget: שם המשאב CampaignBudget שמקושר לקמפיין למיקסום הביצועים שנוצר.
• ‫asset_group: שם המשאב AssetGroup שמקושר לקמפיין למיקסום הביצועים שנוצר.
• ‫assets: רשימה של שמות משאבים מסוג Asset שמקושרים לקמפיין למיקסום הביצועים שנוצר.
• ‫validated_info: מידע נוסף לאימות או בעיות אפשריות בהמרה שמוחזרים כש-validate_only מוגדר ל-true.

תהליך עבודה מומלץ

כדי להמיר קמפיין חכם, משתמשים בתהליך העבודה הבא:

1. יצירת טיוטת קמפיין: קוראים ל-SmartCampaignSettingService.GeneratePMaxDraftCampaign רק עם הפרמטרים הנדרשים resource_name (משאירים את gbp_enabled ו-image_enabled לא מוגדרים או מגדירים אותם כ-false). שומרים את שמות המשאבים pmax_campaign,‏ campaign_budget,‏ asset_group ו-assets שמוחזרים.
2. בדיקה והתאמה אישית של הקמפיין: מכיוון שקמפיין הטיוטה למיקסום הביצועים נוצר באמצעות status = PAUSED ו-creation_status = INCOMPLETE, צריך לבדוק ולהגדיר את התקציב, קבוצת הנכסים והנכסים שלו.
3. מפעילים את הקמפיין: כשמוכנים להציג מודעות, מעדכנים את הערכים של status ו-creation_status בקמפיין ל-ENABLED ו-COMPLETE.

הערה: אחרי שנפעיל את gbp_enabled ואת image_enabled בגרסה עתידית, תוכלו גם להעביר באופן אוטומטי נכסי תמונות ומיקומים ב-GBP.