تحويل "الحملات الذكية" إلى "حملات الأداء الأفضل"

اعتبارًا من الإصدار v25_2، يقدّم Google Ads API الطريقة SmartCampaignSettingService.GeneratePMaxDraftCampaign لمساعدتك في تحويل "حملة ذكية" إلى "حملة أداء أفضل".

طريقة عمل الإحالة الناجحة

عند إجراء طلب إلى SmartCampaignSettingService.GeneratePMaxDraftCampaign، ينشئ واجهة برمجة التطبيقات مسودة "حملة أداء أفضل" استنادًا إلى إعدادات "حملة ذكية" حالية.

يتمّ ضبط قيم الحالة التالية في المسودّة التي تمّ إنشاؤها من "حملة الأداء الأفضل":

  • تم ضبط status على PAUSED.
  • تم ضبط creation_status على INCOMPLETE.

يتيح لك ذلك فحص الحملة والميزانية ومجموعة مواد العرض ومواد العرض التي تم إنشاؤها في "حملة الأداء الأفضل" وتعديلها وتحسينها قبل تفعيل الحملة لعرض الإعلانات.

مَعلمات الطلب

تقبل رسالة GeneratePMaxDraftCampaignRequest الحقول التالية:

  • ‫resource_name (مطلوب): اسم مورد SmartCampaignSetting المرتبط بـ "الحملة الذكية" الحالية التي تريد تحويلها، بالتنسيق التالي:

    customers/customer_id/smartCampaignSettings/campaign_id

  • validate_only (اختياري): إذا كانت القيمة true، سيتم التحقّق من صحة الطلب ولكن لن يتم تنفيذه. يتم عرض أخطاء التحقّق من الصحة أو التحذيرات أو المشاكل المحتملة في التحويل فقط في الحقل validated_info الخاص بالرد.

  • gbp_enabled (غير متاح حاليًا): ما إذا كان سيتم تحويل موقع "الملف التجاري على Google" المرتبط بـ "الحملة الذكية" وربطه بـ "حملة الأداء الأفضل" التي تم إنشاؤها. لا يمكن حاليًا ضبط قيمة هذا الحقل على true، وسيؤدي ذلك إلى ظهور الخطأ GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

  • image_enabled (غير متاح حاليًا): ما إذا كان سيتم تلقائيًا إنشاء الصور المطلوبة لـ "حملة الأداء الأفضل" (مثل مواد عرض الصور الأفقية والمربّعة والشعار). لا يمكن حاليًا ضبط قيمة هذا الحقل على true، وسيؤدي ذلك إلى ظهور الخطأ IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

تفاصيل الردّ

تعرض الرسالة GeneratePMaxDraftCampaignResponse أسماء موارد مسودة "حملة الأداء الأفضل" التي تم إنشاؤها حديثًا والكيانات المرتبطة بها، على النحو التالي:

  • pmax_campaign: اسم مورد Campaign لمسودة "حملة الأداء الأفضل" التي تم إنشاؤها.
  • campaign_budget: اسم مصدر CampaignBudget المرتبط بـ "حملة الأداء الأفضل" التي تم إنشاؤها.
  • asset_group: اسم مورد AssetGroup المرتبط بـ "حملة الأداء الأفضل" التي تم إنشاؤها.
  • assets: قائمة بأسماء موارد Asset مرتبطة بـ "حملة الأداء الأفضل" التي تم إنشاؤها.
  • ‫validated_info: معلومات التحقّق الإضافية أو مشاكل الإحالة الناجحة المحتملة التي يتم عرضها عند ضبط validate_only على true.

لتحويل "حملة ذكية"، استخدِم سير العمل التالي:

  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 وcreation_status إلى COMPLETE.
السابق
نظرة عامة
التالي
الحصول على اقتراحات