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ı 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. 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 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 AdGroup veya AssetGroup 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 (create, update ve remove) atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• Aynı AdGroup hedefleyen LISTING_GROUP ölçütleri (AdGroupCriterion.listing_group) için tüm ardışık AdGroupCriterionOperation işlemler (create, update ve remove) atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• 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 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:

• Aynı AdGroup hedefleyen LISTING_GROUP ölçütleri (AdGroupCriterion.listing_group) için AdGroupCriterionOperation işlemlerinin (create, update ve remove) tek bir atomik alt toplu işlemi 20.000 işlemden uzun olamaz. Ancak 10.000 işlemi aşmamanız önerilir. Her AddBatchJobOperationsRequest 10.000 işlemle sınırlandırıldığından, 10.001 ila 20.000 işlem içeren bir AdGroup alt toplu işlemi en az iki ardışık AddBatchJobOperations isteğiyle yüklenmelidir.
• Aynı AssetGroup hedefleyen, art arda gelen AssetGroupListingGroupFilterOperation işlemlerden (create, update ve remove) oluşan tek bir atomik alt toplu iş 10.000 işlemi aşamaz.
• Bu işlem sayısı sınırlarından birinin ihlal edilmesi (veya sunucunun tek bir alt toplu iş için dahili seri hale getirilmiş bayt boyutu sınırının aşılması) toplu işi o alt toplu işte iptal eder: Daha önce tamamlanmış olan alt toplu işler gönderilmiş olarak kalır. İhlal eden alt toplu işteki ve sonraki tüm alt toplu işlerdeki işlemler InternalError.INTERNAL_ERROR ile 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 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 sonra bir dizinde görünebilir.

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

• AdGroupCriterionOperation listeleme grupları için, aynı AdGroup'ı hedefleyen ardışık işlemlerin CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION ile başarısız olduğunu görebilirsiniz (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.).
• AssetGroupListingGroupFilterOperation işlemleri için aynı AssetGroup 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 toplu işlemdeki başka bir işlem başarısız olduğu için söz konusu 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 işlem hatasının operation_index öncesinde ve sonrasında her BatchJobResult içindeki status mesajlarını inceleyin.