Toplu işlerde grup filtrelerini listeleme

AdGroupCriterion.listing_group veya AssetGroupListingGroupFilter bağlamında listeleme grubu filtreleriyle çalışırken entegrasyonunuzu tasarlarken dikkate almanız gereken birkaç nokta vardır.

Toplu bölme

Önemli Nokta: Aynı AssetGroup'yi hedefleyen AssetGroupListingGroupFilterOperation işlemlerini ve aynı AdGroup öğesini hedefleyen listing_group içeren AdGroupCriterionOperation işlemlerini arka arkaya bir toplu işe eklemenizi öneririz. Böylece işlem grubu, toplu bölme sırasında atomik olarak işlenir.

Bir toplu işte reklam grubu ölçütleri veya öğe grubu listeleme grubu filtreleri içeren herhangi bir işlem varsa toplu işteki işlemler Google Ads API sunucusu tarafından alındığında birden fazla alt gruba bölünür. Toplu işteki standart işlemlerden farklı olarak, listeleme grubu filtreleme işlemlerini içeren her alt grubun atomik olarak değerlendirildiğini unutmayın.

Listeleme grubu filtreleri içeren toplu işlerin alt gruplara bölünme şekli aşağıdaki faktörlere göre belirlenir:

1. Listeleme grubu filtresi türü
2. Listeleme grubu filtresinin hedeflediği AdGroupCriterion veya AssetGroup
3. İşlem sırası

İşlemlerin nasıl gruplandırıldığına ilişkin şu noktaları göz önünde bulundurun:

• Aynı AssetGroup hedefini hedefleyen tüm art arda yapılan AssetGroupListingGroupFilterOperation işlemleri, bir atom alt grupta gruplandırılır (kısmi hata davranışı olmaz).
• Aynı AdGroup öğesini hedefleyen bir listing_group içeren art arda yapılan tüm AdGroupCriterionOperation işlemleri, bir atomik alt grup halinde gruplandırılır (kısmi hata davranışı olmaz).
• Diğer tüm ardışık işlemler, atomik olmayan alt gruplar halinde birlikte gruplandırılır (kısmi hata davranışı).

Önemli Terim: Ardışık öğe, toplu işteki işlemlerin sırasını ifade eder.

Aşağıdaki diyagramda bu kavram gösterilmektedir. Gri kutuların her biri, Google Ads API kullanılarak gönderilen bir toplu işi temsil eder. Gri kutularda her bir işlem, Google Ads API sunucusunun oluşturduğu alt grupları temsil edecek şekilde renge göre gruplandırılır. Gri kutulardaki işlemlerin sırası, işlemlerin toplu işe ekleneceği sıraya karşılık gelir.

Sınırlamalar

Toplu işler bağlamında listeleme grubu filtreleriyle çalışırken aşağıdaki sınırlamalar geçerlidir:

• Bir listing_group içeren ve aynı AdGroup değerini hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubu uzunluğu 20.000 işlem sınırını aşamaz. Bununla birlikte, 10.000 işlemi aşmamanız önerilir.
• Aynı AssetGroup'yi hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubu 10.000 işlemi aşamaz.
• Bu koşullardan birinin ihlal edilmesi, toplu işin tamamının başarısız olmasına neden olur.