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

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

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

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

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

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

يُرجى مراعاة طريقة تجميع العمليات:

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

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

القيود

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

• لا يمكن أن يتجاوز طول دفعة واحدة من AdGroupCriterionOperation العمليات التي تحتوي على 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، بحثًا عن معلومات إضافية عن الخطأ.