Przetwarzanie wsadowe umożliwia wysyłanie zestawu operacji, które mogą być od siebie zależne, do wielu usług bez synchronicznego oczekiwania na ich zakończenie. Przetwarzania wsadowego możesz używać do tworzenia kampanii Performance Max i zarządzania nimi.
W tym przewodniku znajdziesz szczegółowe informacje dotyczące kampanii Performance Max podczas pracy z przetwarzaniem wsadowym. Ogólne informacje o przetwarzaniu wsadowym znajdziesz w ogólnym przewodniku po przetwarzaniu wsadowym, a szczegółowe informacje o tworzeniu żądań dotyczących tworzenia kampanii Performance Max i zarządzania nimi znajdziesz w przewodniku po żądaniach struktury.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania wsadowego:
Utwórz nowe zadanie wsadowe
Aby utworzyć zasób
BatchJob, wykonaj ogólny krok tworzenia zadania przetwarzania wsadowego
.
Przygotuj listę operacji mutacji
Kampanie Performance Max wymagają operacji tworzenia kilku powiązanych
zasobów, które są szczegółowo opisane w
przewodniku po żądaniach struktury. Utwórz a
MutateOperation dla każdego zasobu, który ma
być uwzględniony w zadaniu wsadowym.
Wymagania dotyczące CampaignOperation i CampaignAssetOperation
Gdy w kampanii są włączone wskazówki dotyczące marki (patrz
wskazówki dotyczące marki), musisz połączyć
zasoby marki z kampanią za pomocą CampaignAsset
zasobów. Ponadto w zadaniu wsadowym tworzenie tych CampaignAsset
zasobów musi nastąpić natychmiast po utworzeniu samego Campaign
zasobu. Jeśli zasoby CampaignAsset nie zostaną utworzone natychmiast
po utworzeniu zasobu Campaign (gdy włączone są wskazówki dotyczące marki – patrz
rozwiązywanie problemów),
żądanie zakończy się niepowodzeniem i zwróci CampaignError wskazujący brak komponentów.
Dodanie operacji tworzenia CampaignAsset później na tej samej liście operacji nie zapobiegnie temu błędowi.
Wymagania dotyczące AssetGroupOperation i AssetGroupAssetOperation
Operacje typu MutateOperation, które
tworzą zasoby AssetGroup i
AssetGroupAsset w zadaniu wsadowym, muszą
być wykonywane kolejno bez innych operacji pomiędzy nimi, ponieważ są grupowane podczas przetwarzania. W przeciwnym razie żądanie zgłosi
AssetGroupError wskazujący brak niektórych komponentów,
nawet jeśli operacje wymagane do
spełnienia minimalnych wymagań dotyczących komponentów zostaną uwzględnione później
na liście operacji.
Sprawdzone metody dotyczące AssetGroupListingGroupFilterOperation
Podczas pracy z filtrami grup informacji o produktach w kontekście
AssetGroupListingGroupFilter zalecamy dodawanie
AssetGroupListingGroupFilterOperation
operacji kierowanych na tę samą AssetGroup do
zadania wsadowego kolejno, aby zestaw operacji był traktowany jako niepodzielny
podczas dzielenia wsadowego. Więcej informacji o dzieleniu wsadowym i innych czynnikach
wpływających na grupy informacji o produktach znajdziesz w
przewodniku po przetwarzaniu wsadowym grup informacji o produktach.
Dodaj operacje mutacji do zadania
Dodaj operacje mutacji z kroku 2 do listy i wywołaj
AddBatchJobOperations
, aby dodać listę mutacji do zadania wsadowego utworzonego w kroku 1.
Aby dodać listę operacji mutacji, wykonaj krok dodawania operacji
w ogólnym przewodniku po przetwarzaniu wsadowym.
Uruchom zadanie wsadowe
Aby umożliwić uruchomienie przesłanych zadań, wywołaj
RunBatchJob. Przykład znajdziesz w kroku
Uruchom zadanie wsadowe
w ogólnym przewodniku po przetwarzaniu wsadowym.
Pobierz stan zadania
Zadania wsadowe rozpoczynają się jako długo trwające operacje i zwykle wymagają czasu na zakończenie.
Po rozpoczęciu zadania użyj metody
GetOperation
długo trwającej operacji, aby sondować stan zadania
do momentu jego zakończenia.
Gdy wszystkie zadania wsadowe zostaną ukończone, wywołaj
ListBatchJobResults, aby
wydrukować ich stany i odpowiedzi, wykonując krok
Wyświetl wszystkie wyniki zadań wsadowych w
ogólnym przewodniku po przetwarzaniu wsadowym.