مسودات الحملات

تُعدّ مسودّات الحملات طريقة لتنظيم مجموعة من التغييرات المقصودة على حملة أساسية. ترتبط كل مسوّدة حملة بحملة أساسية وحملة اختبارية.

• الحملة الأساسية هي حملة عادية في حسابك، تتضمّن إعلانات ومجموعات إعلانية ومواد عرض أخرى.
• الحملة الاختبارية هي طبقة افتراضية يتم فيها تجميع التغييرات أثناء تنفيذ العمليات، ولكنّها لا تؤثّر في أيّ حملات حقيقية في حسابك. بعد أن تصبح راضيًا عن حالة الحملة الاختبارية، يمكنك تطبيقها على حملة حقيقية بعدّة طرق مختلفة.

مصطلح أساسي: **مسودة الحملة** هي مَورد تستخدمه لإنشاء مسودّات جديدة من حملة أساسية ولتحديد الروابط بين الحملات الأساسية ومسودّات الحملات. مسودة الحملة هي حملة افتراضية تعمل كحملة ولكن لا يمكنها عرض إعلانات.

يمكنك الاطّلاع على مثال كامل لإنشاء تجربة في كتالوج نماذج الرموز البرمجية.

إنشاء مسودة

لإنشاء CampaignDraft، اتّبِع الخطوات التالية:

1. أنشئ كائن CampaignDraft مع الـ حقول التالية:

   • base_campaign: اسم مَورد الحملة التي ستستند إليها هذه المسودة.
   • name: اسم لمسودة حملتك.

2. بعد ذلك، أنشئ CampaignDraftOperation مع ضبط الحقل create على الكائن CampaignDraft الذي أنشأته.

3. أخيرًا، أرسِل هذه العملية إلى Google Ads API باستخدام الـ CampaignDraftService.MutateCampaignDrafts. طلب create متزامن ويعرض ردًا على الفور.

تعديل حملة اختبارية

بعد إنشاء مسودة حملة، يمكنك استرداد اسم المَورد من حقل results في MutateCampaignDraftsResponse.

عليك استرداد اسم مَورد حملة اختبارية مرتبطة بها قبل إجراء تغييرات عليها. باستخدام اسم مَورد مسوّدة حملة، يمكنك طلب البحث من GoogleAdsService.SearchStream للعثور على حملة اختبارية:

SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"

بعد الحصول على اسم مَورد مسودة الحملة، يمكنك تعديلها مثل أيّ حملة أخرى في حسابك. لا يمكن للحملة الاختبارية عرض إعلانات، ولكنّها تعمل كمنطقة تنظيم للتغييرات التي يمكنك تطبيقها على حملة أساسية لاحقًا.

ترقية حملة اختبارية أو إزالتها

مصطلح أساسي: تعرض العمليات غير المتزامنة في Google Ads API ما يُعرف باسم العملية الطويلة الأمد. تُعدّ العمليات الطويلة الأمد طريقة ملائمة للتحقّق من اكتمال العملية بدون الحاجة إلى إجراء طلب كامل إلى واجهة برمجة التطبيقات.

بعد الانتهاء من ضبط حملتك الاختبارية، تتوفّر لك بعض الخيارات:

1. ترقية الحملة الاختبارية إلى الحملة الأساسية من خلال استدعاء CampaignDraftService.PromoteCampaignDraft. يؤدّي ذلك إلى تطبيق جميع التغييرات التي أجريتها في مسودة الحملة على الحملة الأساسية. هذه عملية غير متزامنة.
2. إزالة مسودة الحملة باستخدام عملية remove في CampaignDraftService.MutateCampaignDrafts، مع تمرير اسم مَورد مسودة الحملة. يؤدّي ذلك إلى إلغاء المسودة وتجاهل أيّ تغييرات إذا قرّرت عدم المتابعة. هذه عملية متزامنة.