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.

obraz

Atomowość w przypadku dzielenia partii

Interfejs Google Ads API może dzielić operacje w przesłanym zadaniu wsadowym na mniejsze podzbiory do przetworzenia. Jeśli nie zgrupujesz powiązanych operacji, takich jak modyfikacje grupy plików w ramach AssetGroup i AdGroup, kolejno w zadaniu wsadowym, interfejs Google Ads API może podzielić te operacje na różne podpartie. Ten podział może spowodować niepowodzenie całej modyfikacji lub pozostawienie konta w stanie niespójności.

Grupowanie logiczne

AssetGroupListingGroupFilterOperation zarządza grupami informacji o produktach w ramach AssetGroup, co jest powszechne w kampaniach Performance Max. AdGroupCriterionOperation zarządza grupami produktów w ramach AdGroup, co jest typowe w przypadku standardowych kampanii produktowych. Oba te typy służą do określania kierowania na produkty. Jeśli wprowadzasz zmiany, które wpływają na hierarchię kierowania na produkty w obu kontekstach, pogrupuj te operacje kolejno w zadaniu wsadowym, aby mieć pewność, że zostaną zastosowane razem.

Spójność danych

Aby zachować spójność danych i zapobiec częściowym aktualizacjom, dodaj powiązane operacje na grupach informacji o produktach kolejno do zadania wsadowego. Takie uporządkowanie pomaga grupować je w atomowe podpartie zgodnie z logiką dzielenia partii interfejsu API, co zapobiega pozostawieniu konta w niespójnym stanie.

Ograniczenia

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

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.

Wstecz
Używanie identyfikatorów tymczasowych
Dalej
Sprawdzone metody