Filtry grup informacji o produktach w zadaniach wsadowych

Podczas pracy z filtrami grup produktów w kontekście AdGroupCriterion.listing_group lub AssetGroupListingGroupFilter weź pod uwagę te kwestie podczas projektowania integracji.

Dzielenie wsadowe

Jeśli w zadaniu zbiorczym znajdują się operacje zawierające kryteria grupy reklam lub filtry grup plików grupy plików, operacje w zadaniu zbiorczym są dzielone na kilka podzadań zbiorczych po otrzymaniu przez serwer interfejsu Google Ads API. Pamiętaj, że w przeciwieństwie do standardowych operacji w zadaniu wsadowym każda podpartia zawierająca operacje filtrowania grup plików jest traktowana jako całość.

Sposób dzielenia zadań wsadowych zawierających filtry grup informacji o produktach na podzbiory zależy od tych czynników:

  1. Typ filtra grupy informacji o produktach
  2. AdGroupCriterion lub AssetGroup, na które kierowany jest filtr grupy informacji o produktach.
  3. Kolejność działań

Zastanów się, jak pogrupować operacje:

  • Wszystkie kolejne operacje AssetGroupListingGroupFilterOperation skierowane na ten sam element AssetGroup są grupowane w atomową podgrupę (bez częściowego błędu).
  • Wszystkie kolejne operacje AdGroupCriterionOperation, które zawierają listing_group kierowane na ten sam element AdGroup, są grupowane w atomową podgrupę (bez częściowego błędu).
  • Wszystkie pozostałe kolejne operacje są grupowane w niepodzielne podpartie (zachowanie w przypadku częściowej awarii).

Ten diagram ilustruje tę koncepcję. Każde szare pole reprezentuje zadanie zbiorcze przesłane za pomocą interfejsu Google Ads API. W szarych polach poszczególne operacje są pogrupowane według koloru, aby przedstawić podpartie, które tworzy serwer interfejsu Google Ads API. Kolejność operacji w każdym z szarych pól odpowiada kolejności, w jakiej operacje zostałyby dodane do zadania wsadowego.

obraz

Ograniczenia

Podczas pracy z filtrami grup informacji o produktach w kontekście zadań wsadowych obowiązują te ograniczenia:

  • Pojedyncza partia AssetGroupListingGroupFilterOperation operacji zawierająca listing_group i skierowana na ten sam AdGroup nie może przekraczać 20 000 operacji. Zalecamy jednak, aby nie przekraczać 10 tys. operacji.
  • Pojedyncza partia AssetGroupListingGroupFilterOperation operacji kierowanych na ten sam AssetGroup nie może przekraczać 10 000 operacji.
  • Naruszenie któregokolwiek z tych warunków spowoduje niepowodzenie całego zadania wsadowego.

Rozwiązywanie problemów

Operacje filtrowania grup produktów w zadaniu zbiorczym są przetwarzane jako jedna transakcja, co może prowadzić do sytuacji, w których wiele operacji kończy się niepowodzeniem z powodu niewielkiej liczby błędnych operacji. Ponadto ze względu na sposób przetwarzania operacji BatchJob główna przyczyna niepowodzeń może pojawić się w indeksie przed lub po niepowodzeniach w dalszej części procesu.

Na przykład podczas przetwarzania odpowiedzi z usługi ListBatchJobResults możesz zauważyć, że kilka operacji nie powiodło się i wyświetla się komunikat o stanie Ad group is invalid due to the listing groups it contains. Ten komunikat zwykle oznacza, że operacja na tym indeksie została anulowana z powodu nieudanej operacji na innym indeksie. Aby zidentyfikować główną przyczynę problemu, zalecamy przejrzenie wszystkich komunikatów o stanie w BatchJobResult – przed i po indeksie komunikatu o błędzie Ad group is invalid – w poszukiwaniu dodatkowych informacji o błędach.