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 toplulara bölünme şekli aşağıdaki faktörlere göre belirlenir:

1. Listeleme grubu filtresinin türü
2. Listeleme grubu filtresinin hedeflediği AdGroupCriterion veya AssetGroup
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şlemleri, atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• Aynı AdGroup öğesini hedefleyen bir listing_group 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).
• 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. Her bir gri kutudaki 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:

• listing_group içeren ve aynı AdGroup'yi hedefleyen tek bir AssetGroupListingGroupFilterOperation işlem toplu işlemi 20.000 işlemi aşamaz. Ancak 10.000 işlemi aşmamanız önerilir.
• Aynı AssetGroup'ı hedefleyen tek bir AssetGroupListingGroupFilterOperation işlem grubu 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ş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.