عند استخدام فلاتر مجموعات بيانات التسجيل في سياق
AdGroupCriterion.listing_group
أو
AssetGroupListingGroupFilter،
يجب مراعاة ما يلي عند تصميم عملية الدمج.
التقسيم على دفعات
إذا كانت هناك أي عمليات في مهمة مجمّعة تحتوي على معايير مجموعات إعلانية أو فلاتر مجموعات إعلانية خاصة بقوائم مجموعات مواد العرض، يتم تقسيم العمليات في المهمة المجمّعة إلى مجموعات فرعية متعددة عند تلقّيها من خادم Google Ads API. يُرجى العِلم أنّه على عكس العمليات العادية في مهمة الدُفعة، يتم التعامل مع كل دُفعة فرعية تحتوي على عمليات فلترة مجموعة المؤسسات بشكل ذري.
يتم تحديد طريقة تقسيم المهام المجمّعة التي تحتوي على فلاتر مجموعات بيانات إلى مجموعات فرعية وفقًا للعوامل التالية:
- نوع فلتر مجموعة البيانات
AdGroupCriterionأوAssetGroupالتي يستهدفها فلتر مجموعة البيانات- ترتيب العمليات
ضَع في اعتبارك كيفية تجميع العمليات:
- يتم تجميع جميع عمليات
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، بحثًا عن معلومات إضافية حول الخطأ.