المعالجة المجمّعة لـ "حملات الأداء الأفضل"

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

يوفّر هذا الدليل تفاصيل خاصة بـ "حملات الأداء الأفضل" عند استخدام المعالجة على دفعات. يوفّر دليل المعالجة على دفعات العام معلومات عامة عن المعالجة على دفعات، ويحتوي دليل طلبات البنية على معلومات مفصّلة عن إنشاء الطلبات لإدارة "حملات الأداء الأفضل" أو إنشائها.

لإنشاء حملة أداء أفضل باستخدام المعالجة على دفعات، اتّبِع الخطوات التالية:

إنشاء مهمة مجمّعة جديدة

اتّبِع خطوة إنشاء مهمة المعالجة على دفعات العامة لإنشاء مورد BatchJob.

إعداد قائمة بعمليات التعديل

تتطلّب "حملات الأداء الأفضل" عمليات لإنشاء عدّة موارد ذات صلة ، والتي يتم تفصيلها في دليل طلبات البنية. أنشِئ MutateOperation لكل مورد يجب تضمينه في المهمة المجمّعة.

متطلبات CampaignOperation وCampaignAssetOperation

**ملاحظة:** لا ينطبق هذا الشرط إلا على موارد `Campaign`Campaign التي تتضمّن موارد `Asset`Asset مرتبطة باستخدام `CampaignAsset`CampaignAsset من أجل استيفاء متطلبات مادة عرض خاصة بعلامة تجارية.

عند تفعيل إرشادات العلامة التجارية لإحدى الحملات (اطّلِع على إرشادات العلامة التجارية)، يجب ربط مادة عرض خاصة بعلامة تجارية بالحملة باستخدام CampaignAsset موارد. علاوةً على ذلك، في مهمة مجمّعة، يجب أن يتم إنشاء CampaignAsset الموارد هذه مباشرةً بعد إنشاء Campaign المورد نفسه. إذا لم يتم إنشاء موارد CampaignAsset مباشرةً بعد مورد Campaign (عند تفعيل إرشادات العلامة التجارية - اطّلِع على تحديد المشاكل وحلّها)، سيفشل الطلب وسيعرض CampaignError يشير إلى مواد عرض غير متوفّرة. لن يمنع هذا الخطأ تضمين عمليات إنشاء CampaignAsset لاحقًا في قائمة العمليات نفسها.

متطلبات AssetGroupOperation وAssetGroupAssetOperation

**ملاحظة:** لا ينطبق هذا الشرط إلا على موارد AssetGroup التي تتضمّن موارد Asset مرتبطة باستخدام AssetGroupAsset من أجل الالتزام بالحد الأدنى من متطلبات مواد العرض.

يجب أن تكون عمليات النوع MutateOperation التي تنشئ AssetGroup و AssetGroupAsset موارد في مهمة مجمّعة متسلسلة بدون عمليات أخرى بينها بسبب طريقة تجميع هذه العمليات عند معالجتها. بخلاف ذلك، سيعرض الطلب AssetGroupError يشير إلى أنّ بعض مواد العرض غير متوفّرة, حتى إذا تم تضمين العمليات المطلوبة لاستيفاء الحد الأدنى من متطلبات مواد العرض لاحقًا في قائمة العمليات.

أفضل الممارسات المتعلّقة بـ AssetGroupListingGroupFilterOperation

ملاحظة: AssetGroupListingGroupFilter لا يمكن استخدام موارد إلا مع "حملات الأداء الأفضل" للمبيعات على الإنترنت التي تتضمّن خلاصة منتجات. يجب أن تتضمّن موارد AssetGroup في هذه الحملات شجرة مجموعة منتجات صالحة تتألف من مورد واحد أو أكثر من موارد AssetGroupListingGroupFilter المرتبطة بها. لاستهداف كل المنتجات، استخدِم شجرة عقدة واحدة.

عند استخدام فلاتر مجموعة بطاقات البيانات في سياق AssetGroupListingGroupFilter، ننصح بإضافة عمليات AssetGroupListingGroupFilterOperation التي تستهدف AssetGroup نفسه على التوالي إلى مهمة مجمّعة، بحيث يتم التعامل مع مجموعة العمليات بشكل غير قابل للتجزئة أثناء تقسيم الدفعات. لمزيد من المعلومات عن تقسيم الدفعات والعوامل الأخرى التي تؤثّر في مجموعات بطاقات البيانات، اطّلِع على دليل المعالجة المجمّعة لمجموعات بطاقات البيانات.

إضافة عمليات التعديل إلى المهمة

أضِف عمليات التعديل من الخطوة 2 إلى قائمة، ثم استخدِم AddBatchJobOperations لإضافة قائمة التعديلات إلى المهمة المجمّعة التي تم إنشاؤها في الخطوة 1. اتّبِع خطوة إضافة العمليات الإعلانية في دليل المعالجة على دفعات العام لإضافة قائمة عمليات التعديل.

تشغيل المهمة المجمّعة

اسمَح للمهام التي تم تحميلها بالبدء في التشغيل من خلال استدعاء RunBatchJob. اطّلِع على خطوة تشغيل المهمة المجمّعة في دليل المعالجة على دفعات العام للحصول على مثال.

استرداد حالة المهمة

تبدأ المهام المجمّعة كعمليات طويلة الأمد وتستغرق عادةً وقتًا حتى تكتمل. بعد بدء المهمة، استخدِم طريقة العملية طويلة الأمد GetOperation لـ الاطّلاع على حالة المهمة إلى أن تكتمل.

عند اكتمال جميع مهامك المجمّعة، استخدِم ListBatchJobResults لعرض حالاتها وردودها باتّباع خطوة عرض جميع نتائج المهام المجمّعة في دليل المعالجة المجمّعة العام.