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

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

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

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

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

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

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

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

متطلبات CampaignOperation وCampaignAssetOperation

ملاحظة: ينطبق هذا الشرط فقط على موارد Campaign التي تتضمّن موارد Asset مرتبطة بها باستخدام 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 لعرض حالاتها وردودها بعد خطوة عرض جميع نتائج مهام الدُفعة في دليل المعالجة العامة للدُفعات.