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:
- Typ filtra grupy informacji o produktach
AdGroupCriterion
lubAssetGroup
, na które kierowany jest filtr grupy informacji o produktach.- Kolejność działań
Zastanów się, jak pogrupować operacje:
- Wszystkie kolejne operacje
AssetGroupListingGroupFilterOperation
skierowane na ten sam elementAssetGroup
są grupowane w atomową podgrupę (bez częściowego błędu). - Wszystkie kolejne operacje
AdGroupCriterionOperation
, które zawierająlisting_group
kierowane na ten sam elementAdGroup
, 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.
Ograniczenia
Podczas pracy z filtrami grup informacji o produktach w kontekście zadań wsadowych obowiązują te ograniczenia:
- Pojedyncza partia
AssetGroupListingGroupFilterOperation
operacji zawierającalisting_group
i skierowana na ten samAdGroup
nie może przekraczać 20 000 operacji. Zalecamy jednak, aby nie przekraczać 10 tys. operacji. - Pojedyncza partia
AssetGroupListingGroupFilterOperation
operacji kierowanych na ten samAssetGroup
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.