فلاتر مجموعات البيانات في المهام المجمّعة

عند استخدام فلاتر مجموعات بيانات التسجيل في سياق AdGroupCriterion.listing_group أو AssetGroupListingGroupFilter، يجب مراعاة ما يلي عند تصميم عملية الدمج.

التقسيم على دفعات

إذا كانت هناك أي عمليات في مهمة مجمّعة تحتوي على معايير مجموعات إعلانية أو فلاتر مجموعات إعلانية خاصة بقوائم مجموعات مواد العرض، يتم تقسيم العمليات في المهمة المجمّعة إلى مجموعات فرعية متعددة عند تلقّيها من خادم Google Ads API. يُرجى العِلم أنّه على عكس العمليات العادية في مهمة الدُفعة، يتم التعامل مع كل دُفعة فرعية تحتوي على عمليات فلترة مجموعة المؤسسات بشكل ذري.

يتم تحديد طريقة تقسيم المهام المجمّعة التي تحتوي على فلاتر مجموعات البيانات إلى دفعات فرعية وفقًا للعوامل التالية:

1. نوع فلتر مجموعة البيانات
2. AdGroupCriterion أو AssetGroup التي يستهدفها فلتر مجموعة البيانات
3. ترتيب العمليات

ضَع في اعتبارك كيفية تجميع العمليات:

• يتم تجميع جميع عمليات AssetGroupListingGroupFilterOperation المتتالية التي تستهدف AssetGroup نفسه في مجموعة فرعية واحدة (بدون سلوك تعذُّر جزئي).
• يتم تجميع جميع عمليات AdGroupCriterionOperation المتتالية التي تحتوي على listing_group وتستهدف AdGroup نفسه في مجموعة فرعية ذرية (بدون سلوك تعذُّر جزئي).
• يتم تجميع جميع العمليات المتتالية الأخرى في دفعات فرعية غير ذرية (سلوك الفشل الجزئي).

يوضّح الرسم البياني التالي هذا المفهوم. يمثّل كل مربّع رمادي مهمة معالجة مجمّعة تم إرسالها باستخدام Google Ads API. ضمن المربّعات الرمادية، يتم تجميع العمليات الفردية حسب اللون لتمثيل الدُفعات الفرعية التي ينشئها خادم Google Ads API. يتوافق ترتيب العمليات في كل مربّع من المربّعات الرمادية مع ترتيب إضافة العمليات إلى مهمة المعالجة المجمّعة.

القيود

عند استخدام فلاتر مجموعات البيانات في سياق مهام الدفعات، تنطبق القيود التالية:

• لا يمكن أن يتجاوز حجم مجموعة واحدة من AssetGroupListingGroupFilterOperation عملية تتضمّن listing_group وتستهدف AdGroup نفسها 20,000 عملية. ومع ذلك، يُنصح بعدم تجاوز 10,000 عملية.
• يجب ألا تتجاوز مجموعة واحدة من AssetGroupListingGroupFilterOperation عملية تستهدف AssetGroup نفسه 10,000 عملية.
• ويؤدي انتهاك أيّ من هذين الشرطين إلى تعذُّر تنفيذ مهمة المعالجة المجمّعة بأكملها.

تحديد المشاكل وحلّها

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

على سبيل المثال، عند معالجة ردّ من ListBatchJobResults، قد تجد أنّ عدّة عمليات تعذّر إجراؤها مع ظهور رسالة الحالة Ad group is invalid due to the listing groups it contains. تشير هذه الرسالة عادةً إلى أنّه تم إلغاء العملية في هذا الفهرس بسبب تعذُّر إتمام عملية في فهرس آخر. لتحديد السبب الجذري للمشكلة، ننصحك بتكرار جميع رسائل الحالة في BatchJobResult، قبل وبعد فهرس رسالة الخطأ Ad group is invalid، بحثًا عن معلومات إضافية حول الخطأ.