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