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

در 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 به‌روز کنید تا از ارائه تکراری جلوگیری شود.