Toplu işlerde grup filtrelerini listeleme

Bir 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şlerdeki 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. AdGroupCriterion veya AssetGroup listeleme grubu filtresi hedefleniyor
3. İşlem sırası

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

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

Aşağıdaki şemada bu kavram 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 toplu işlemleri temsil etmek için işlemler renklere göre gruplandırılı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 herhangi 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şlemleri işlenme şekli nedeniyle, hataların temel nedeni, aşağı akış hatalarından önce veya sonraki bir dizinde görünebilir.

Örneğin, ListBatchJobResults'dan gelen bir yanıtı işlerken Ad group is invalid due to the listing groups it contains durum mesajıyla birlikte birkaç işlemin 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.