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

Temel Nokta: Aynı AssetGroup öğesini hedefleyen AssetGroupListingGroupFilterOperation işlemlerini ve aynı AdGroup öğesini hedefleyen bir listing_group içeren AdGroupCriterionOperation işlemlerini art arda bir toplu işe eklemenizi öneririz. Böylece, toplu işlem bölme sırasında işlem grubu atomik olarak ele alınır.

Bir toplu işte reklam grubu ölçütleri veya öğe grubu listeleme grubu filtreleri içeren işlemler varsa toplu iş, Google Ads API sunucusu tarafından alındığında birden fazla alt toplu işe bölünür. Bir toplu işteki standart işlemlerden farklı olarak, giriş grubu filtresi işlemlerini içeren her alt toplu işin atomik olarak ele alındığını 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ığını düşünün:

• Aynı AssetGroup öğesini hedefleyen tüm art arda gelen AssetGroupListingGroupFilterOperation işlemleri, atomik bir alt grupta birlikte gruplandırılır (kısmi başarısızlık davranışı yoktur).
• Aynı AdGroup öğesini hedefleyen bir listing_group içeren tüm art arda gelen AdGroupCriterionOperation işlemleri, atomik bir alt grupta gruplandırılır (kısmi başarısızlık davranışı yoktur).
• Diğer tüm art arda gelen işlemler, atomik olmayan alt gruplarda (kısmi başarısızlık davranışı) gruplandırılır.

Önemli Terim: Art arda, toplu işteki işlemlerin sırasını ifade eder.

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 grupları temsil etmek için ayrı işlemler renge göre gruplandırılır. Gri kutuların her birindeki işlemlerin sırası, işlemlerin toplu işe eklenme sırasına karşılık gelir.

Sınırlamalar

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

• Bir listing_group içeren ve aynı AdGroup'yi hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubu,20.000 işlemden uzun olamaz. Ancak 10.000 işlemden fazla olmaması önerilir.
• Aynı AssetGroup'yi hedefleyen tek bir AssetGroupListingGroupFilterOperation işlemi grubu 10.000 işlemi aşamaz.
• Bu koşulların ihlaline yol açan işlemler, toplu işin tamamının başarısız olmasına neden olur.

Sorun giderme

Grup filtreleme işlemleri, toplu işte tek bir işlem olarak işlenir. Bu durum, küçük sayıda hatalı işlem nedeniyle birçok işlemin başarısız olduğu senaryolara yol açabilir. Ayrıca, BatchJob işlemlerinin işlenme şekli nedeniyle, hataların temel nedeni, yayın sonrası hatalardan önce veya sonra bir dizinde görünebilir.

Örneğin, ListBatchJobResults adresinden 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 farklı bir dizindeki başarısız bir işlem nedeniyle bu dizindeki işlemin iptal edildiğini gösterir. Sorunun temel nedenini belirlemek için ek hata bilgileri aramak amacıyla BatchJobResult'teki tüm durum mesajlarını (Ad group is invalid hata mesajının dizininden önce ve sonra) incelemenizi öneririz.