Toplu işlerde grup filtrelerini listeleme

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

Önemli nokta: Aynı AssetGroup'i hedefleyen AssetGroupListingGroupFilterOperation işlemleri ve aynı AdGroup'i hedefleyen listing_group içeren AdGroupCriterionOperation işlemlerini toplu işe art arda eklemenizi öneririz. Böylece, toplu iş bölme işlemi sırasında işlemler 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ş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 filtresi AdGroupCriterion veya AssetGroup öğesini 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şlemleri, atomik bir alt toplu işlemde birlikte gruplandırılır (kısmi hata davranışı yoktur).
• Aynı AdGroup hedeflemeyi 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).listing_group
• Diğer tüm ardışık işlemler, atomik olmayan alt gruplar halinde birlikte gruplandırılır (kısmi hata davranışı).

Önemli Terim: Ardışık, 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 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.

Toplu Bölmede Atomiklik

Google Ads API, gönderilen bir toplu işteki işlemleri işlenmek üzere daha küçük alt toplu işlere bölebilir. Bir AssetGroup içindeki listeleme grubu değişiklikleri ve bir AdGroup gibi ilgili işlemleri bir toplu işlemde art arda gruplandırmazsanız Google Ads API bu işlemleri farklı alt toplu işlemlere bölebilir. Bu ayrım, değişikliğin tamamen başarısız olmasına veya hesabın tutarsız bir durumda kalmasına neden olabilir.

Mantıksal Gruplama

AssetGroupListingGroupFilterOperation AssetGroup içindeki listeleme gruplarını yönetir. Bu, Maksimum Performans kampanyalarında yaygın bir durumdur. AdGroupCriterionOperation, AdGroup içindeki listeleme gruplarını yönetir. Bu, standart Alışveriş kampanyalarında yaygındır. Her ikisi de ürün hedeflemeyi tanımlamak için kullanılır. Her iki bağlamda da ürün hedefleme hiyerarşisini etkileyen değişiklikler yaparsanız bu işlemlerin birlikte uygulanmasını sağlamak için toplu işinizde bu işlemleri art arda gruplandırın.

Veri Tutarlılığı

Veri tutarlılığını korumak ve kısmi güncellemeleri önlemek için ilgili listeleme grubu işlemlerini toplu işinize sırayla ekleyin. Bu sıralama, API'nin toplu işleri bölme mantığına göre atomik alt toplu işler halinde gruplandırılmalarına yardımcı olur. Böylece hesabınızın tutarsız bir durumda kalması önlenir.

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 ve listing_group içeren tek bir AdGroupCriterionOperation işlemi toplu işlemi 20.000 işlemi aşamaz. Ancak 10.000 işlemi aşmamanız önerilir.
• Aynı AssetGroup'ı hedefleyen tek bir toplu işlemde AssetGroupListingGroupFilterOperation işlem sayısı 10.000'i geçemez.
• 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.