Toplu işlerde grup filtrelerini listeleme

AdGroupCriterion.listing_group veya AssetGroupListingGroupFilter bağlamında listeleme grubu filtreleriyle çalışırken entegrasyonunuzu tasarlarken aşağıdaki hususları göz önünde bulundurun.

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 topluya bölünür. Toplu işteki standart işlemlerden farklı olarak, listeleme grubu filtre işlemleri içeren her bir alt toplu işin atomik olarak işlendiğini unutmayın.

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

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

İşlemlerin nasıl gruplandırıldığını göz önünde bulundurun:

• Aynı AssetGroup hedefleyen tüm ardışık AssetGroupListingGroupFilterOperation işlemler, atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• Aynı AdGroup hedeflemeyi içeren tüm ardışık AdGroupCriterionOperation işlemler, atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yok).listing_group
• Diğer tüm ardışık işlemler, atomik olmayan alt gruplar halinde birlikte gruplandırılır (kısmi hata davranışı).

Bu kavram aşağıdaki şemada gösterilmektedir. Gri kutuların her biri, Google Ads API kullanılarak gönderilen bir toplu işi temsil eder. Gri kutularda, Google Ads API sunucusunun oluşturduğu alt grupları temsil etmek için işlemler renklere göre gruplandırılmıştır. Gri kutulardaki işlemlerin sırası, işlemlerin toplu işe eklendiğ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:

• AdGroupCriterionOperation işlemlerinden oluşan ve listing_group içeren tek bir toplu işlem,aynı AdGroup'ı hedefleyen 20.000 işlemi aşamaz. Ancak 10.000 işlemi aşmamanız önerilir.
• Aynı AssetGroup'ı hedefleyen tek bir AssetGroupListingGroupFilterOperation işlem toplu işlemi 10.000 işlemi aşamaz.
• Bu koşullardan birinin ihlal edilmesi, tüm toplu işin başarısız olmasına neden olur.

Sorun giderme

Toplu işteki listeleme grubu filtre işlemleri tek bir işlem olarak işlenir. Bu durum, az sayıda hatalı işlem nedeniyle birçok işlemin başarısız olmasına yol açabilir. Ayrıca, BatchJob işlemlerinin işlenme şekli nedeniyle, hataların temel nedeni, aşağı akış hatalarından önce veya sonraki bir dizinde görünebilir.

Örneğin, ListBatchJobResults kaynağından gelen bir yanıtı işlerken birkaç işlemin Ad group is invalid due to the listing groups it contains durum mesajıyla başarısız olduğunu görebilirsiniz. Bu mesaj genellikle bu dizindeki işlemin, farklı bir dizindeki işlemin başarısız olması nedeniyle iptal edildiğini gösterir. Sorunun temel nedenini belirlemek için ek hata bilgileri bulmak amacıyla BatchJobResult içindeki tüm durum mesajlarını (Ad group is invalid hata mesajının dizininden önce ve sonra) incelemenizi öneririz.