فهرست کردن فیلترهای گروه در کارهای دسته ای

هنگامی که با فهرست کردن فیلترهای گروه در زمینه AdGroupCriterion.listing_group یا AssetGroupListingGroupFilter کار می کنید، هنگام طراحی ادغام خود، ملاحظات زیر را در نظر بگیرید.

تقسیم دسته ای

اگر در یک کار دسته‌ای عملیاتی وجود داشته باشد که حاوی معیارهای گروه آگهی یا فیلترهای گروه فهرست گروه دارایی باشد، عملیات‌های کار دسته‌ای پس از دریافت توسط سرور API Google Ads به چند دسته تقسیم می‌شوند. توجه داشته باشید که بر خلاف عملیات استاندارد در یک کار دسته‌ای، هر زیرمجموعه حاوی عملیات فیلتر گروه فهرست به صورت اتمی در نظر گرفته می‌شود.

روشی که در آن کارهای دسته ای حاوی فیلترهای گروه فهرست بندی به دسته های فرعی تقسیم می شوند توسط عوامل زیر تعیین می شود:

  1. نوع فیلتر گروه لیست
  2. AdGroupCriterion یا AssetGroup که فیلتر گروه لیست را هدف قرار می دهد
  3. ترتیب عملیات

نحوه گروه بندی عملیات را در نظر بگیرید:

  • همه عملیات‌های متوالی AssetGroupListingGroupFilterOperation که همان AssetGroup را هدف قرار می‌دهند در یک دسته فرعی اتمی با هم گروه‌بندی می‌شوند (بدون رفتار شکست جزئی).
  • همه عملیات متوالی AdGroupCriterionOperation که حاوی یک listing_group است که همان AdGroup را هدف قرار می دهد، در یک دسته فرعی اتمی (بدون رفتار شکست جزئی) گروه بندی می شوند.
  • تمام عملیات های متوالی دیگر در دسته های فرعی غیر اتمی با هم گروه بندی می شوند (رفتار شکست جزئی).

نمودار زیر این مفهوم را نشان می دهد. هر یک از کادرهای خاکستری نشان دهنده یک کار دسته‌ای است که با استفاده از Google Ads API ارسال شده است. در کادرهای خاکستری، عملیات جداگانه بر اساس رنگ گروه بندی می شوند تا دسته های فرعی را که سرور API Google Ads ایجاد می کند، نشان دهند. ترتیب عملیات در هر یک از جعبه های خاکستری با ترتیبی که عملیات به کار دسته ای اضافه می شد مطابقت دارد.

تصویر

محدودیت ها

هنگام کار با لیست کردن فیلترهای گروه در زمینه کارهای دسته ای، محدودیت های زیر اعمال می شود:

  • یک دسته از عملیات AssetGroupListingGroupFilterOperation که شامل یک listing_group است و همان AdGroup را هدف قرار می دهد، نمی تواند بیش از 20000 عملیات باشد. با این حال، توصیه می شود از 10000 عملیات تجاوز نکنید.
  • یک دسته از عملیات AssetGroupListingGroupFilterOperation که همان AssetGroup هدف قرار می دهد نمی تواند از 10000 عملیات تجاوز کند.
  • نقض هر یک از این شرایط منجر به شکست کل کار دسته ای می شود.

عیب یابی

عملیات فیلتر گروهی فهرست‌بندی در یک کار دسته‌ای به‌عنوان یک تراکنش پردازش می‌شود، که می‌تواند منجر به سناریوهایی شود که در آن بسیاری از عملیات به دلیل تعداد کمی از عملیات اشتباه شکست می‌خورند. علاوه بر این، به دلیل نحوه پردازش عملیات BatchJob ، ممکن است علت اصلی خرابی ها در یک شاخص قبل یا بعد از خرابی های پایین دستی ظاهر شود.

به عنوان مثال، هنگام پردازش یک پاسخ از ListBatchJobResults ، ممکن است متوجه شوید که چندین عملیات با یک پیام وضعیت ناموفق است، Ad group is invalid due to the listing groups it contains . این پیام معمولاً نشان می‌دهد که عملیات در این شاخص به دلیل عملکرد ناموفق در یک شاخص دیگر لغو شده است. برای شناسایی علت اصلی مشکل، توصیه می‌کنیم تمام پیام‌های وضعیت موجود در BatchJobResult - قبل و بعد از اینکه فهرست پیام خطای Ad group is invalid - برای جستجوی اطلاعات بیشتر درباره خطا تکرار شود.