تبدیل «پویش‌های هوشمند» به پویش‌های «عملکرد بیشینه»

در v25 و نسخه‌های جدیدتر، می‌توانید از روش SmartCampaignSettingService.GeneratePMaxDraftCampaign برای تبدیل «کمپین هوشمند» به کمپین «عملکرد بیشینه» استفاده کنید. این روش در v24 و نسخه‌های قدیمی‌تر دردسترس نیست.

نحوه عملکرد تبدیل

وقتی SmartCampaignSettingService.GeneratePMaxDraftCampaign را فراخوانی می‌کنید، میانای برنامه‌سازی کاربردی پیش‌نویس کمپین «عملکرد بیشینه»، بودجه، گروه دارایی، و دارایی‌ها را براساس پیکربندی «کمپین هوشمند» ارائه‌شده در درخواست تولید می‌کند. پس‌از تولید، باید منابع جدید را قبل‌از فعال کردن پویش برای ارائه آگهی‌ها بازرسی، اصلاح، و بهبود دهید.

پویش پیش‌نویس «عملکرد بیشینه» تولیدشده با مقادیر وضعیت زیر مقداردهی اولیه می‌شود:

• status روی PAUSED تنظیم شده است.
• واجدشرایط بودن آن برای ارائه در primary_status منعکس شده است.
• contains_eu_political_advertising به‌طور پیش‌فرض روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تنظیم شده است (اگر قبلاً در «پویش هوشمند» مشخص نشده باشد). اگر پویش شما حاوی تبلیغات سیاسی اتحادیه اروپا است، این فیلد را به‌تأیید برسانید و به‌روز کنید.

این کار به شما امکان می‌دهد پویش، بودجه، گروه دارایی، و دارایی‌های «عملکرد بیشینه» تولیدشده را قبل‌از فعال کردن پویش برای ارائه آگهی‌ها بررسی، اصلاح، و بهبود دهید.

دارایی‌های پیش‌نویس

پویش جدید با گروهی از تصاویر جای‌بان همراه است که باید قبل‌از فعال شدن پویش جدید جایگزین شوند. وقتی فیلد image_enabled در درخواست پشتیبانی شود و روی true تنظیم شده باشد، میانای برنامه‌سازی کاربردی به‌جای استفاده از تصاویر جای‌بان، به‌طور خودکار تصویر تولید می‌کند. می‌توانید دارایی‌های جدید را در فیلد assets پاسخ بررسی کنید و با دنبال کردن این مراحل آن‌ها را جایگزین کنید:

1. راهنمای الزامات دارایی را مرور کنید.
2. با دنبال کردن نمونه بارگذاری دارایی تصویری، تصاویر جدید بارگذاری کنید.
3. دارایی‌های جدید را به گروه دارایی پویش پیش‌نویس پیوند دهید و سپس پیوندهای 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 تنظیم شده است، پر می‌شود).

گردش کار توصیه‌شده

برای تبدیل «پویش هوشمند»، از گردش کار زیر استفاده کنید:

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 پویش «بیشینه‌سازی عملکرد» را به ENABLED به‌روز کنید، سپس status پویش «هوشمند» اصلی را به PAUSED به‌روز کنید تا از ارائه تکراری جلوگیری شود.