Toplu işlerde grup filtrelerini listeleme

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

Toplu bölme

Bir toplu işte reklam grubu ölçütleri veya öğe grubu listeleme grubu filtreleri içeren işlemler 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şlerdeki standart işlemlerden farklı olarak, listeleme grubu filtre işlemlerini içeren her alt grubun atomik olarak işlendiğini unutmayın.

Listeleme grubu filtreleri içeren toplu işlerin alt gruplara ayrılma yöntemi, 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ığıyla ilgili şu noktaları göz önünde bulundurun:

• Aynı AssetGroup bölgesini hedefleyen tüm ardışık AssetGroupListingGroupFilterOperation işlemleri, bir atom alt grubu içinde bir araya getirilir (kısmi hata davranışı olmaz).
• Aynı AdGroup öğesini hedefleyen listing_group içeren tüm ardışık AdGroupCriterionOperation işlemleri, atomik bir alt grupta birlikte gruplandırılır (kısmi hata davranışı gösterilmez).
• Diğer tüm ardışık işlemler, atomik olmayan alt gruplarda (kısmi hata davranışı) birlikte gruplandırılır.

Bu kavram aşağıdaki şemada gösterilmektedir. Gri kutuların her biri, Google Ads API kullanılarak gönderilen toplu işi gösterir. 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 kutuların her birindeki 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:

• listing_group içeren ve aynı AdGroup öğesini hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubunun uzunluğu 20.000 işlemi aşamaz. Ancak 10.000'den fazla işlem yapılmaması önerilir.
• Aynı AssetGroup işlemini hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubu en fazla 10.000 işlem olabilir.
• Bu koşullardan birinin ihlal edilmesi, toplu işin tamamının başarısız olmasına neden olur.