בגרסה v25 ואילך, אפשר להשתמש בשיטה 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כדי למנוע הצגה כפולה.