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

في v25 (اعتبارًا من v25.2)، يمكنك استخدام طريقة SmartCampaignSettingService.GeneratePMaxDraftCampaign لتحويل "حملة ذكية" إلى "حملة أداء أفضل". لا تتوفّر هذه الطريقة في الإصدار v24 والإصدارات الأقدم.

طريقة عمل التحويل

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

يتمّ ضبط status في مسودّة "حملة الأداء الأفضل" التي تمّ إنشاؤها على PAUSED (ويظهر مدى أهليتها للعرض في primary_status). إذا تعذّر التحقّق من صحة جميع أدوات تحويل الميزات في "الحملة الذكية"، سيتعذّر تنفيذ الطلب وسيظهر الخطأ SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

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

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

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

• resource_name (مطلوب): اسم المورد الخاص بـ SmartCampaignSetting المطلوب إعادة إنشائه للحملة الذكية التي تريد تحويلها، بالتنسيق التالي:

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

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

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

تفاصيل الردّ

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

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

سير العمل المقترَح

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

1. إنشاء حملة اختبارية: استدعِ SmartCampaignSettingService.GeneratePMaxDraftCampaign مع ضبط resource_name المطلوب فقط (اترك gbp_enabled وimage_enabled بدون ضبط أو اضبطهما على false). احفظ أسماء الموارد pmax_campaign وcampaign_budget وasset_group وassets التي تم عرضها.
2. مراجعة الحملة وتخصيصها: بما أنّ مسودة "حملة الأداء الأفضل" يتم إنشاؤها باستخدام status = PAUSED، راجِع ميزانيتها ومجموعة مواد العرض ومواد العرض فيها، واضبطها.
3. تفعيل الحملة وإيقاف الحملة الأصلية مؤقتًا: عندما تكون مستعدًا لعرض الإعلانات، عدِّل status في "حملة الأداء الأفضل" إلى ENABLED، ثم عدِّل status في "الحملة الذكية" الأصلية إلى PAUSED لمنع عرض الإعلانات المكرّرة.