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

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

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

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

إنشاء وظيفة مجمّعة جديدة

اتّبِع الخطوات العامة لمعالجة الدفعات لإنشاء مهمة من أجل إنشاء مورد 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 لطباعة حالاتها واستجاباتها باتّباع خطوة عرض جميع نتائج المهام المجمّعة في دليل المعالجة المجمّعة العام.