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

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

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

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

إنشاء مسودة

لإنشاء 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"

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

الترويج لمسودة حملة أو إزالتها

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

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