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

في الإصدار 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" تلقائيًا.