בגרסה v25 ואילך, אפשר להשתמש ב-method SmartCampaignSettingService.GeneratePMaxDraftCampaign כדי להמיר קמפיין חכם לקמפיין למיקסום הביצועים. השיטה הזו לא זמינה בגרסה v24 ובגרסאות קודמות.
איך ההמרה עובדת
כשמפעילים את השיטה SmartCampaignSettingService.GeneratePMaxDraftCampaign, ה-API יוצר טיוטה של קמפיין למיקסום הביצועים, תקציב, קבוצת נכסים ונכסים, על סמך ההגדרות של הקמפיין החכם שצוינו בבקשה. אחרי שהמערכת תיצור את המשאבים החדשים, כדאי לבדוק, לשנות ולשפר אותם לפני שמפעילים את הקמפיין כדי להציג מודעות.
הטיוטה שנוצרה של הקמפיין למיקסום הביצועים מאותחלת עם ערכי הסטטוס הבאים:
-
statusמוגדר לערךPAUSED. - הכשירות להצגת מודעות משתקפת ב
primary_status. - כברירת מחדל,
contains_eu_political_advertisingמוגדר כ-DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING(אם הוא לא צוין כבר בקמפיין החכם). אם הקמפיין שלכם מכיל פרסום שקשור לפוליטיקה באיחוד האירופי, אתם צריכים לבדוק ולעדכן את השדה הזה.
כך תוכלו לבדוק, לשנות ולשפר את הקמפיין למיקסום הביצועים, התקציב, קבוצת הנכסים והנכסים שנוצרו לפני שתפעילו את הקמפיין כדי להציג מודעות.
טיוטות של נכסים
הקמפיין החדש כולל קבוצה של תמונות לדוגמה שצריך להחליף לפני שמפעילים את הקמפיין החדש. כשהשדה image_enabled נתמך ומוגדר כ-true בבקשה, ה-API יוצר תמונות באופן אוטומטי במקום להשתמש בתמונות לדוגמה. אתם יכולים לבדוק את הנכסים החדשים בשדה assets של התגובה, ולהחליף אותם לפי השלבים הבאים:
- מעיינים במדריך לדרישות לגבי נכסים.
- כדי להעלות תמונות חדשות, פועלים לפי הדוגמה של העלאת נכס תמונות.
- מקשרים את הנכסים החדשים לקבוצת הנכסים של הקמפיין בטיוטה, ואז מסירים את הקישורים של
AssetGroupAssetלתמונות לדוגמה (באותה בקשה אטומית לשינוי נתונים או אחרי שמקשרים את הנכסים החדשים, כדי להמשיך לעמוד בדרישות המינימליות לגבי נכסים) לפי המדריך לקישור קבוצות נכסים לנכסים.
פרמטרים של בקשות
ההודעה GeneratePMaxDraftCampaignRequest מקבלת את השדות הבאים:
resource_name(חובה): שם המשאב שלSmartCampaignSettingשרוצים ליצור מחדש בשביל הקמפיין החכם שרוצים להמיר, בפורמט הבא:customers/customer_id/smartCampaignSettings/campaign_id
validate_only(אופציונלי): אם הערך הואtrue, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות אימות, אזהרות או בעיות אפשריות בהמרות מוחזרות בשדהvalidated_infoשל התגובה, בלי ליצור ישויות טיוטה.
gbp_enabled(לא נתמך): אופציונלי. אם להמיר את המיקום של פרופיל העסק ב-Google (GBP) שמקושר לקמפיין למיקסום הביצועים. אל תגדירו את השדה הזה או הגדירו אותו כ-false. הגדרה שלו כ-trueלא נתמכת ומחזירה את השגיאהSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
image_enabled(לא נתמך): אופציונלי. אם ליצור את התמונות הנדרשות לקמפיינים למיקסום הביצועים (כמו תמונות אופקיות, תמונות ריבועיות ותמונות לוגו). צריך להשאיר את השדה הזה לא מוגדר או להגדיר אותו לערךfalse. הגדרה לערךtrueלא נתמכת ומחזירה את השגיאהSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
פרטי התשובה
ההודעה GeneratePMaxDraftCampaignResponse מחזירה את שמות המשאבים של טיוטת הקמפיין למיקסום הביצועים שנוצרה ושל הישויות שמשויכות אליה:
pmax_campaign: שם המשאבCampaignשל טיוטת הקמפיין למיקסום הביצועים שנוצרה.-
campaign_budget: שם המשאב שלCampaignBudgetשמקושר לקמפיין שנוצר למיקסום הביצועים. asset_group: שם המשאב שלAssetGroupשמקושר לקמפיין למיקסום הביצועים שנוצר.-
assets: רשימה של שמות המשאבים מסוגAssetשמקושרים לקמפיין למיקסום הביצועים שנוצר. -
validated_info: פרטי האימות או בעיות אפשריות בהמרות שהוחזרו על ידי בדיקת ההמרות (מאוכלס גם כש-validate_onlyמוגדר כ-trueוגם לצד שמות המשאבים של הישויות שנוצרו כש-validate_onlyמוגדר כ-false).
תהליך העבודה המומלץ
כדי להמיר קמפיין חכם, משתמשים בתהליך העבודה הבא:
- יצירת טיוטת הקמפיין: מפעילים את השיטה
SmartCampaignSettingService.GeneratePMaxDraftCampaignרק עם השדה הנדרשresource_name(משאירים את השדותgbp_enabledו-image_enabledלא מוגדרים או מגדירים אותם כ-false). שומרים את שמות המשאבים המוחזריםpmax_campaign,campaign_budget,asset_groupו-assets. - בדיקה והתאמה אישית של הקמפיין: מכיוון שהטיוטה של הקמפיין למיקסום הביצועים נוצרה באמצעות
status = PAUSEDו-creation_status = INCOMPLETE, צריך לבדוק ולהגדיר את התקציב, את קבוצת הנכסים ואת הנכסים. - הפעלת הקמפיין והשהיית הקמפיין המקורי: כשתהיו מוכנים להציג מודעות, עדכנו את הערך של
statusבקמפיין למיקסום הביצועים ל-ENABLED, ואז עדכנו את הערך שלstatusבקמפיין החכם המקורי ל-PAUSEDכדי למנוע הצגה כפולה.