Przetwarzanie wsadowe umożliwia wysyłanie zestawu operacji, które mogą być współzależne, do wielu usług bez synchronicznego oczekiwania na zakończenie operacji. Do tworzenia kampanii Performance Max i zarządzania nimi możesz używać przetwarzania wsadowego.
Ten przewodnik zawiera szczegółowe informacje o kampaniach Performance Max, które są przydatne podczas korzystania z przetwarzania wsadowego. Ogólny przewodnik po przetwarzaniu wsadowym zawiera ogólne informacje o przetwarzaniu wsadowym, a przewodnik po strukturze żądań zawiera szczegółowe informacje o tworzeniu żądań służących do tworzenia kampanii Performance Max i zarządzania nimi.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania wsadowego:
Tworzenie nowego zadania wsadowego
Wykonaj ogólne kroki tworzenia zadania przetwarzania wsadowego, aby utworzyć zasób BatchJob.
Przygotowywanie listy operacji mutacji
Kampanie Performance Max wymagają operacji, które tworzą kilka powiązanych zasobów. Szczegółowe informacje znajdziesz w przewodniku po strukturze żądań. Utwórz MutateOperation dla każdego zasobu, który powinien 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ć z nią zasoby marki za pomocą zasobów CampaignAsset. Ponadto w zadaniu wsadowym utworzenie tych zasobów CampaignAsset musi nastąpić natychmiast po utworzeniu samego zasobu Campaign. Jeśli zasoby CampaignAsset nie zostaną utworzone natychmiast po zasobie Campaign (gdy włączone są wskazówki dotyczące marki – patrz rozwiązywanie problemów), żądanie zakończy się niepowodzeniem i zwróci błąd CampaignError wskazujący brakujące komponenty.
Uwzględnienie 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 sekwencyjnie, bez innych operacji pomiędzy nimi, ze względu na sposób grupowania tych operacji podczas przetwarzania. W przeciwnym razie żądanie zwróci błąd AssetGroupError wskazujący, że brakuje niektórych komponentów, nawet jeśli operacje wymagane do spełnienia minimalnych wymagań dotyczących komponentów znajdują się na liście operacji.
AssetGroupListingGroupFilterOperation sprawdzone metody
Podczas pracy z filtrami grup informacji o produktach w kontekście AssetGroupListingGroupFilter zalecamy dodawanie operacji AssetGroupListingGroupFilterOperation kierowanych na ten sam AssetGroup do zadania wsadowego po kolei, aby zestaw operacji był traktowany jako niepodzielny podczas dzielenia zadania 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.
Dodawanie do zadania operacji mutacji
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 opisany w ogólnym przewodniku po przetwarzaniu wsadowym.
Uruchamianie zadania wsadowego
Zezwól na uruchamianie przesłanych zadań, wywołując metodę RunBatchJob. Przykład znajdziesz w kroku Uruchamianie zadania wsadowego w ogólnym przewodniku po przetwarzaniu wsadowym.
Pobieranie stanu 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, dopóki nie zostanie ono ukończone.
Gdy wszystkie zadania wsadowe zostaną zakończone, wywołaj ListBatchJobResults, aby wyświetlić ich stany i odpowiedzi zgodnie z krokiem wyświetlania wszystkich wyników zadań wsadowych w ogólnym przewodniku po przetwarzaniu wsadowym.