از نسخه v25_2 به بعد، API گوگل ادز متد SmartCampaignSettingService.GeneratePMaxDraftCampaign را معرفی میکند تا به شما در تبدیل یک کمپین هوشمند به یک کمپین با حداکثر عملکرد (Performance Max) کمک کند.
تبدیل چگونه کار میکند؟
وقتی SmartCampaignSettingService.GeneratePMaxDraftCampaign را فراخوانی میکنید، API بر اساس پیکربندی یک کمپین هوشمند موجود، یک کمپین پیشنویس Performance Max تولید میکند.
کمپین پیشنویس Performance Max تولید شده با مقادیر وضعیت زیر مقداردهی اولیه میشود:
-
statusرویPAUSEDتنظیم شده است. -
creation_statusرویINCOMPLETEتنظیم شده است.
این به شما امکان میدهد قبل از فعال کردن کمپین برای نمایش تبلیغات، کمپین، بودجه، گروه دارایی و داراییهای تولید شده با حداکثر عملکرد را بررسی، اصلاح و بهبود دهید.
پارامترهای درخواست
پیام GeneratePMaxDraftCampaignRequest فیلدهای زیر را میپذیرد:
resource_name( الزامی ): نام منبعSmartCampaignSettingمرتبط با کمپین هوشمند موجود که میخواهید تبدیل کنید، به فرمت زیر:customers/customer_id/smartCampaignSettings/campaign_idvalidate_only( اختیاری ): اگرtrue، درخواست اعتبارسنجی میشود اما اجرا نمیشود. فقط خطاهای اعتبارسنجی، هشدارها یا مشکلات احتمالی تبدیل در فیلدvalidated_infoپاسخ برگردانده میشوند.gbp_enabled( در حال حاضر پشتیبانی نمیشود ): اینکه آیا مکان نمایه کسبوکار گوگل (GBP) مرتبط با کمپین هوشمند را به کمپین تولید شده با حداکثر عملکرد تبدیل و پیوند دهیم یا خیر. تنظیم این فیلد رویtrueدر حال حاضر پیادهسازی نشده است و خطایGBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDرا برمیگرداند.image_enabled( در حال حاضر پشتیبانی نمیشود ): اینکه آیا تصاویر مورد نیاز برای کمپین Performance Max (مانند تصاویر افقی، مربعی و لوگو) به طور خودکار تولید شوند یا خیر. تنظیم این فیلد رویtrueدر حال حاضر پیادهسازی نشده است و خطایIMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDرا برمیگرداند.
جزئیات پاسخ
پیام GeneratePMaxDraftCampaignResponse نام منابع کمپین پیشنویس Performance Max که به تازگی ایجاد شده و موجودیتهای مرتبط با آن را برمیگرداند:
-
pmax_campaign: نام منبعCampaignمربوط به پیشنویس کمپین Performance Max تولید شده. -
campaign_budget: نام منبعCampaignBudgetکه به کمپین تولید شده با حداکثر عملکرد (Performance Max) لینک شده است. -
asset_group: نام منبعAssetGroupکه به کمپین Performance Max تولید شده لینک شده است. -
assets: فهرستی از نامهای منابعAssetکه به کمپین تولید شدهی Performance Max لینک شدهاند. -
validated_info: اطلاعات اعتبارسنجی اضافی یا مشکلات احتمالی تبدیل که هنگام تنظیمvalidate_onlyرویtrueبرگردانده میشوند.
گردش کار توصیه شده
برای تبدیل یک کمپین هوشمند، از گردش کار زیر استفاده کنید:
- تولید پیشنویس کمپین :
SmartCampaignSettingService.GeneratePMaxDraftCampaignرا فقط با مجموعهresource_nameمورد نیاز فراخوانی کنید (gbp_enabledوimage_enabledرا بدون تنظیم یا با مقدارfalseباقی بگذارید). نامهای منبعpmax_campaign،campaign_budget،asset_groupوassetsکه برگردانده شدهاند را ذخیره کنید. - بررسی و سفارشیسازی کمپین : از آنجا که پیشنویس کمپین Performance Max با
status = PAUSEDوcreation_status = INCOMPLETEایجاد شده است، بودجه، گروه دارایی و داراییهای آن را بررسی و پیکربندی کنید. - فعال کردن کمپین : وقتی آماده ارائه تبلیغات شدید،
statusکمپین را بهENABLEDوcreation_statusبهCOMPLETEبهروزرسانی کنید.