Toplu işlerde listeleme grubu filtrelerini kullanma

AdGroupCriterion.listing_group veya AssetGroupListingGroupFilter bağlamında listeleme grubu filtreleriyle çalışırken entegrasyonunuzu tasarlarken aşağıdaki hususları dikkate alın.

Toplu bölme

Önemli nokta: Aynı AssetGroupListingGroupFilterOperation hedefleyen işlemler (create, update ve remove) ve aynı AssetGroup hedefleyen AdGroupCriterionOperation işlemleri (create, update ve remove) LISTING_GROUP ölçütleri (AdGroupCriterion.listing_group) için toplu işe art arda eklemenizi öneririz. Böylece, toplu iş bölme sırasında işlemler grubu atomik olarak ele alınır.

AdGroup

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. Bir toplu işte yapılan standart işlemlerden farklı olarak, listeleme grubu filtresi işlemleri içeren her bir alt toplu iş atomik olarak değerlendirilir.

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 filtresinin türü
2. Listeleme grubu filtresi AdGroup veya AssetGroup hedefliyor
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 (create, update ve remove) atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• Aynı AdGroup öğesini hedefleyen LISTING_GROUP ölçütleri (AdGroupCriterion.listing_group) için tüm ardışık AdGroupCriterionOperation işlemleri (create, update ve remove), atomik bir alt grupta (kısmi hata davranışı yok) gruplandırılır.
• Diğer tüm ardışık işlemler, atomik olmayan alt toplu işlerde (kısmi hata davranışı) birlikte gruplandırılır.

Not: Aynı toplu işlemde AssetGroup oluşturuyorsanız yeni Asset kaynakları için ön koşul olan AssetOperation (create) işlemlerini AssetGroupOperation (create) işlemlerinden önce, ardından hemen AssetGroupAssetOperation (create) işlemleri (önceki atomik alt toplu işlemde birlikte yürütülür) ve ardından da ardışık AssetGroupListingGroupFilterOperation işlemleri (sonraki atomik alt toplu işlemde yürütülür) gelecek şekilde yerleştirin. Bunlar iki ayrı alt grup oluşturduğundan, AssetGroupListingGroupFilterOperation alt grubundaki bir hata, yeni oluşturulan AssetGroup ve AssetGroupAsset kaynaklarını geri çekmeden listeleme grubu filtrelerini geri çeker.

Önemli Terim: Ardışık, toplu işteki işlemlerin sırasını ifade eder. Aynı AdGroup veya AssetGroup hedeflenen işlemler farklı bir grubu hedefleyen işlemlerle birlikte işleniyorsa ayrı alt gruplara bölünür ve artık tek bir atomik işlem olarak işlenmez.

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 her bir işlem renge göre gruplandırılır. Gri kutulardaki işlemlerin sırası, işlemlerin toplu işe eklenme sırasına 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:

• Aynı AdGroup öğesini hedefleyen LISTING_GROUP ölçütleri (AdGroupCriterion.listing_group) için ardışık AdGroupCriterionOperation işlemlerinin (create, update ve remove) tek bir atomik alt grubu, uzunluk olarak 20.000 işlemi aşamaz. Ancak 10.000 işlemi aşmamanız önerilir. Her AddBatchJobOperationsRequest 10.000 işlemle sınırlı olduğundan, 10.001 ila 20.000 işlem içeren bir AdGroup alt grubu en az iki ardışık AddBatchJobOperations isteğiyle yüklenmelidir.
• Aynı AssetGroup öğesini hedefleyen ardışık AssetGroupListingGroupFilterOperation işlemlerinin (create, update ve remove) tek bir atomik alt grubu 10.000 işlemi aşamaz.
• Bu işlem sayısı sınırlarından birinin ihlal edilmesi (veya tek bir alt toplu işlem için sunucunun dahili serileştirilmiş bayt boyutu sınırının aşılması), toplu işi söz konusu alt toplu işlemde iptal eder: Tamamlanmış olan önceki alt toplu işlemler işlenmiş olarak kalırken, ihlalde bulunan alt toplu işlemdeki ve sonraki alt toplu işlemlerdeki tüm işlemler InternalError.INTERNAL_ERROR hatasıyla başarısız 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 olduğu senaryolara yol açabilir. Ayrıca, BatchJob işlemlerinin işlenme şekli nedeniyle, hataların temel nedeni, alt hatalardan önceki veya sonraki bir dizinde görünebilir.

Örneğin, ListBatchJobResults adlı kullanıcının yanıtı işlenirken:

• AdGroupCriterionOperation listeleme grupları için aynı AdGroup öğesini hedefleyen ardışık işlemlerin CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.) hatasıyla başarısız olduğunu görebilirsiniz.
• AssetGroupListingGroupFilterOperation işlemleri için aynı AssetGroup öğesini hedefleyen ardışık işlemlerin BatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILURE ile başarısız olduğunu görebilirsiniz.

Bu hatalar, aynı atomik alt gruptaki başka bir işlem başarısız olduğu için ilgili dizindeki işlemin geri alındığını gösterir. Sorunun temel nedenini belirlemek için aynı AdGroup veya AssetGroup kimliğini paylaşan işlemler için her BatchJobResult içindeki status mesajlarını (işlem hatasının operation_index öncesinde ve sonrasında) yineleyin.