پیش‌نویس‌های پویش راهی برای آماده‌سازی مجموعه‌ای از تغییرات موردنظر در پویش پایه است. هر پیش‌نویس کمپین دارای یک کمپین پایه و یک کمپین پیش‌نویس مرتبط با آن است.
- پویش پایه یک پویش عادی در حساب شما است که آگهی‌ها، گروه‌های آگهی، و منابع دیگر را دارد.
- پویش پیش‌نویس لایه مجازی‌ای است که در آن تغییرات با انجام عملیات جمع‌آوری می‌شوند، اما بر هیچ‌یک از پویش‌های واقعی در حسابتان تأثیر نمی‌گذارند. وقتی از وضعیت پویش پیش‌نویس راضی بودید، می‌توانید آن را به چند روش مختلف روی پویش واقعی اعمال کنید.
می‌توانید مثال کاملی از ایجاد آزمایش را در کاتالوگ نمونه‌های کد پیدا کنید.
ایجاد پیش‌نویس
برای ایجاد CampaignDraft:
شیء
CampaignDraftرا با فیلدهای زیر ایجاد کنید:base_campaign: نام منبع پویشی که این پیش‌نویس براساس آن ساخته خواهد شد.name: نامی برای پیش‌نویس پویش شما.
سپس،
CampaignDraftOperationرا با فیلدcreateتنظیم‌شده روی شیءCampaignDraftکه ایجاد کرده‌اید بسازید.درنهایت، این عملیات را بااستفاده از روش
CampaignDraftService.MutateCampaignDraftsبه Google Ads API ارسال کنید. درخواستcreateهمگام است و بلافاصله پاسخ را برمی‌گرداند.
اصلاح پویش پیش‌نویس
پس‌از ایجاد پیش‌نویس پویش، می‌توانید نام منبع آن را از فیلد results در MutateCampaignDraftsResponse بازیابی کنید.
قبل‌از اینکه بتوانید تغییراتی در آن ایجاد کنید، باید نام منبع پویش پیش‌نویس مرتبط با آن را بازیابی کنید. با نام منبع پیش‌نویس پویش، می‌توانید
GoogleAdsService.SearchStream
را پُرسمان کنید
تا پویش پیش‌نویس را پیدا کنید:
SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"
پس‌از اینکه نام منبع پویش پیش‌نویس را دریافت کردید، می‌توانید آن را مانند هر پویش دیگری در حسابتان اصلاح کنید. کمپین پیش‌نویس نمی‌تواند آگهی ارائه دهد، اما به‌عنوان یک منطقه آماده‌سازی برای تغییراتی عمل می‌کند که می‌توانید بعداً در کمپین پایه اعمال کنید.
تبلیغ یا حذف پویش پیش‌نویس
پس‌از اینکه پیکربندی پیش‌نویس پویش خود را تمام کردید، چند گزینه دارید:
- با فراخوانی
CampaignDraftService.PromoteCampaignDraft، کمپین پیش‌نویس را به کمپین پایه تبدیل کنید. این کار همه تغییراتی را که در کمپین پیش‌نویس ایجاد کرده‌اید روی کمپین پایه اعمال می‌کند. این یک عملیات ناهمزمان است. - پیش‌نویس پویش را بااستفاده از عملیات
removeدرCampaignDraftService.MutateCampaignDraftsبردارید و نام منبع پیش‌نویس پویش را عبور دهید. اگر تصمیم گرفتید ادامه ندهید، این کار پیش‌نویس را لغو می‌کند و از هرگونه تغییر صرف‌نظر می‌کند. این عملیات همگام است.