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

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

آلية عمل الإحالات الناجحة

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

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

• تم ضبط status على PAUSED.
• وتظهر أهلية عرضها في primary_status.
• يتم ضبط contains_eu_political_advertising على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تلقائيًا (إذا لم يتم تحديده من قبل في "الحملة الذكية"). يُرجى التحقّق من هذا الحقل وتعديله إذا كانت حملتك تحتوي على إعلانات سياسية عن الاتحاد الأوروبي.

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

مسودات مواد العرض

تتضمّن الحملة الجديدة مجموعة من الصور المؤقتة التي يجب استبدالها قبل تفعيل الحملة الجديدة. عندما يكون الحقل image_enabled متاحًا ويتم ضبطه على true في الطلب، تنشئ واجهة برمجة التطبيقات الصور تلقائيًا بدلاً من استخدام صور مؤقتة. يمكنك فحص مواد العرض الجديدة في حقل assets الخاص بالاستجابة، واستبدالها باتّباع الخطوات التالية:

1. راجِع دليل متطلبات مواد العرض.
2. حمِّل صورًا جديدة باتّباع مثال تحميل مادة عرض صورة.
3. اربط مواد العرض الجديدة بمجموعة مواد العرض الخاصة بالحملة المسودّة، ثم أزِل روابط الصور النائبة AssetGroupAsset (إما في طلب التعديل الذري نفسه أو بعد ربط مواد العرض الجديدة لضمان استيفاء الحد الأدنى من متطلبات مواد العرض) باتّباع دليل ربط مجموعات مواد العرض بمواد العرض.

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

تنبيه: لا تتوفّر المَعلمتان gbp_enabled وimage_enabled، وتؤديان إلى حدوث أخطاء في حال ضبطهما على true في الطلب. اترك كلا الحقلين بدون ضبط أو اضبطهما على false.

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

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

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

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

• image_enabled (غير متاح): سمة اختيارية. ما إذا كان سيتم إنشاء صور مطلوبة لـ "حملة الأداء الأفضل" (مثل أنواع الصور الأفقية والمربّعة وصور الشعار). اترك هذا الحقل بدون ضبط أو false، لأنّ ضبطه على true غير متاح وسيؤدي إلى ظهور الخطأ 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 وcreation_status = INCOMPLETE، عليك فحص ميزانيتها ومجموعة مواد العرض ومواد العرض وضبطها.
3. تفعيل الحملة وإيقاف الحملة الأصلية مؤقتًا: عندما تكون مستعدًا لعرض الإعلانات، عدِّل status "حملة الأداء الأفضل" إلى ENABLED، ثم عدِّل status "الحملة الذكية" الأصلية إلى PAUSED لمنع عرض الإعلانات المكرّرة.

ملاحظة: بعد تفعيل gbp_enabled وimage_enabled في إصدار مستقبلي، ستتمكّن أيضًا من نقل مواقع الملف التجاري على Google ومواد عرض الصور تلقائيًا.