وقتی با فیلترهای گروه فهرست‌بندی در چارچوب AdGroupCriterion.listing_group یا AssetGroupListingGroupFilter کار می‌کنید، ملاحظات زیر را هنگام طراحی یکپارچه‌سازی خود در نظر بگیرید.
تقسیم دسته‌ای
اگر در یک کار دسته‌ای عملیاتی وجود داشته باشد که حاوی معیارهای گروه تبلیغاتی یا فیلترهای گروه فهرست دارایی‌ها باشد، عملیات موجود در کار دسته‌ای هنگام دریافت توسط سرور API گوگل ادز به چندین زیرگروه تقسیم می‌شوند. توجه داشته باشید که برخلاف عملیات استاندارد در یک کار دسته‌ای، با هر زیرگروه حاوی عملیات فیلتر گروه فهرست‌بندی به صورت اتمی رفتار می‌شود.
نحوه تقسیم کارهای دسته‌ای حاوی فیلترهای گروه فهرست به زیردسته‌ها توسط عوامل زیر تعیین می‌شود:
- نوع فیلتر گروه آگهی
-
AdGroupCriterionیاAssetGroupکه فیلتر گروه فهرست‌بندی هدف قرار می‌دهد - ترتیب عملیات
نحوه گروه بندی عملیات را در نظر بگیرید:
- تمام عملیات متوالی
AssetGroupListingGroupFilterOperationکهAssetGroupیکسانی را هدف قرار می‌دهند، در یک زیرگروه اتمی (بدون رفتار خرابی جزئی) گروه‌بندی می‌شوند. - تمام عملیات‌های متوالی
AdGroupCriterionOperationکه شامل یکlisting_groupهستند کهAdGroupیکسانی را هدف قرار می‌دهد، در یک زیر-دسته اتمی (بدون رفتار خطای جزئی) گروه‌بندی می‌شوند. - تمام عملیات متوالی دیگر در زیرگروه‌های غیر اتمی (رفتار خرابی جزئی) گروه‌بندی می‌شوند.
نمودار زیر این مفهوم را نشان می‌دهد. هر یک از کادرهای خاکستری نشان‌دهنده یک کار دسته‌ای است که با استفاده از API تبلیغات گوگل ارسال می‌شود. در داخل کادرهای خاکستری، عملیات‌های جداگانه بر اساس رنگ گروه‌بندی شده‌اند تا زیردسته‌هایی را که سرور API تبلیغات گوگل ایجاد می‌کند، نشان دهند. ترتیب عملیات در هر یک از کادرهای خاکستری مطابق با ترتیبی است که عملیات‌ها به کار دسته‌ای اضافه می‌شدند.
محدودیت‌ها
هنگام کار با فیلترهای گروهی فهرست‌بندی در زمینه کارهای دسته‌ای، محدودیت‌های زیر اعمال می‌شود:
- یک دسته عملیات
AdGroupCriterionOperationکه شامل یکlisting_groupاست و همانAdGroupهدف قرار می‌دهد، نمی‌تواند بیش از 20،000 عملیات طول داشته باشد. با این حال، توصیه می‌شود که از 10،000 عملیات تجاوز نکند. - یک دسته عملیات
AssetGroupListingGroupFilterOperationکهAssetGroupیکسانی را هدف قرار می‌دهد، نمی‌تواند از 10000 عملیات تجاوز کند. - نقض هر یک از این شرایط منجر به شکست کل کار دسته‌ای می‌شود.
عیب‌یابی
عملیات فیلتر گروهی لیست شده در یک کار دسته‌ای به عنوان یک تراکنش پردازش می‌شوند، که می‌تواند منجر به سناریوهایی شود که در آن‌ها بسیاری از عملیات به دلیل تعداد کمی از عملیات اشتباه با شکست مواجه می‌شوند. علاوه بر این، به دلیل نحوه پردازش عملیات BatchJob ، علت اصلی شکست‌ها ممکن است در یک فهرست قبل یا بعد از شکست‌های پایین‌دستی ظاهر شود.
برای مثال، هنگام پردازش پاسخی از ListBatchJobResults ، ممکن است متوجه شوید که چندین عملیات با پیام وضعیت « Ad group is invalid due to the listing groups it contains شکست مواجه شده‌اند. این پیام معمولاً نشان می‌دهد که عملیات در این فهرست به دلیل عملیات ناموفق در یک فهرست متفاوت لغو شده است. برای شناسایی علت اصلی مشکل، توصیه می‌کنیم تمام پیام‌های وضعیت در BatchJobResult - قبل و بعد از پیام خطای «شاخص Ad group is invalid » - را برای جستجوی اطلاعات خطای بیشتر مرور کنید.