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

عند العمل مع فلاتر مجموعات البيانات في سياق 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 وبعده بحثًا عن معلومات إضافية عن الخطأ.