Filtry grup informacji o produktach w zadaniach wsadowych

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

Dzielenie zbiorczego

Ważne: zalecamy dodawanie do zadania zbiorczego kolejno operacji AssetGroupListingGroupFilterOperation kierowanych na ten sam element AssetGroup oraz operacji AdGroupCriterionOperation zawierających element listing_group, który kieruje na ten sam element AdGroup, aby zestaw operacji był traktowany jako całość podczas podziału zbiorczego.

Jeśli w zbiorowym zadaniu występują operacje zawierające kryteria grupy reklam lub filtry grup listy komponentów, operacje w zbiorowym zadaniu są dzielone na podzbiory po otrzymaniu przez serwer Google Ads API. Pamiętaj, że w odróżnieniu od standardowych operacji w zestawie każda podpartia zawierająca operacje filtra grupy informacji o produktach jest traktowana jako operacja atomowa.

Sposób dzielenia zadań zbiorczych 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 kieruje filtr grupy informacji o produktach.
3. Kolejność działań

Rozważ sposób grupowania operacji:

• Wszystkie kolejne operacje AssetGroupListingGroupFilterOperation, które mają na celu ten sam AssetGroup, są grupowane w atomowy podzbiór (bez częściowego niepowodzenia).
• Wszystkie kolejne operacje AdGroupCriterionOperation, które zawierają listing_group kierowane na ten sam element AdGroup, są grupowane w atomowy podzbiór (bez częściowego niepowodzenia).
• Wszystkie pozostałe kolejne operacje są grupowane w nieatomowe podpartie (działanie w przypadku częściowego niepowodzenia).

Kluczowy termin: Ciągły odnosi się do kolejności operacji w zadaniem zbiorczym.

Tę koncepcję ilustruje diagram poniżej. 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 przedstawiać podpartie tworzone przez serwer Google Ads API. Kolejność operacji w każdej z szarych ramek odpowiada kolejności, w jakiej operacje zostałyby dodane do zadania zbiorczego.

Ograniczenia

W przypadku pracy z filtrami grup informacji o produktach w kontekście zadań zbiorczych obowiązują te ograniczenia:

• Pojedyncza partia operacji AssetGroupListingGroupFilterOperation zawierająca listing_group i kierowana na ten sam element AdGroup nie może obejmować więcej niż 20 tys. operacji. Zalecamy jednak, aby nie przekraczać 10 tys. operacji.
• Jedna partia operacji AssetGroupListingGroupFilterOperation, która kieruje się na ten sam element AssetGroup, nie może zawierać więcej niż 10 000 operacji.
• Naruszenie któregokolwiek z tych warunków powoduje niepowodzenie całego zadania zbiorczego.

Rozwiązywanie problemów

Operacje filtrowania listy grup w ramach zadania zbiorczego są przetwarzane jako jedna transakcja, co może prowadzić do sytuacji, w której 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 błędów może pojawić się w indeksie przed lub po błędach w dół łańcucha.

Podczas przetwarzania odpowiedzi z ListBatchJobResults możesz na przykład zauważyć, że kilka operacji zakończyło się niepowodzeniem z komunikatem stanu Ad group is invalid due to the listing groups it contains. Ta wiadomość zwykle oznacza, że operacja w tym indeksie została anulowana z powodu nieudanej operacji w 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 celu znalezienia dodatkowych informacji o błędzie.