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 wsadowym znajdują się operacje zawierające kryteria grupy reklam lub filtry grup produktów w grupie plików, operacje w tym zadaniu są dzielone na kilka podzadań 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 niepodzielna 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. Filtr grupy informacji o produktach AdGroupCriterion lub AssetGroup jest kierowany na
3. Kolejność działań

Zastanów się, jak są pogrupowane operacje:

• Wszystkie kolejne operacje AssetGroupListingGroupFilterOperation skierowane na ten sam element AssetGroup są grupowane w atomową podgrupę (bez częściowego błędu).
• Wszystkie kolejne AdGroupCriterionOperation operacje, które zawierają listing_group kierowanie na ten sam AdGroup, są grupowane w atomową podgrupę (bez zachowania w przypadku częściowej awarii).
• 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.

Ograniczenia

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

• Pojedyncza partia AdGroupCriterionOperation operacji zawierająca listing_group i skierowana na ten sam AdGroup nie może zawierać więcej niż 20 000 operacji. Zalecamy jednak, aby nie przekraczać 10 tys. operacji.
• Pojedyncza partia AssetGroupListingGroupFilterOperation operacji 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 wsadowym 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 zakończyło się niepowodzeniem i wyświetlił 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 przeanalizowanie 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.