Przesyłanie wsadowe umożliwia wysyłanie do wielu usług zestawu operacji, które mogą być ze sobą powiązane, bez oczekiwania na ich zakończenie. Do tworzenia kampanii Performance Max i zarządzania nimi możesz używać przetwarzania zbiorczego.
W tym przewodniku znajdziesz szczegółowe informacje o kampaniach Performance Max, gdy korzystasz z przetwarzania w partiach. Ogólny przewodnik po przetwarzaniu w partiach zawiera ogólne informacje o przetwarzaniu w partiach, a przewodnik po konstruowaniu żądań zawiera szczegółowe informacje o sposobie tworzenia żądań służących do tworzenia kampanii Performance Max i zarządzania nimi.
Aby utworzyć kampanię Performance Max za pomocą przetwarzania w partiach:
Tworzenie nowego zadania zbiorczego
Aby utworzyć zasób BatchJob
, wykonaj ogólny krok przetwarzania zbiorczego tworzenia zadania.
Przygotuj listę operacji przekształcania
Kampanie Performance Max wymagają operacji tworzenia kilku powiązanych zasobów, które są opisane w przewodniku po żądaniach strukturalnych. Utwórz element MutateOperation
dla każdego zasobu, który ma być uwzględniony w zadaniu zbiorczym.
Wymagania CampaignOperation
i CampaignAssetOperation
Jeśli w kampanii są włączone wskazówki dotyczące marki (patrz wskazówki dotyczące marki), musisz połączyć z nią komponenty marki, korzystając z komponentów CampaignAsset
. Ponadto w przypadku zadania zbiorczego tworzenie tych zasobów CampaignAsset
musi nastąpić bezpośrednio po utworzeniu zasobu Campaign
. Jeśli zasoby CampaignAsset
nie zostaną utworzone natychmiast po utworzeniu zasobu Campaign
(gdy są włączone wytyczne dotyczące marki – patrz rozwiązywanie problemów), żądanie zakończy się niepowodzeniem i zwróci odpowiedź CampaignError
wskazującą brakujące zasoby.
Dodanie operacji tworzenia CampaignAsset
do tej samej listy operacji nie zapobiegnie temu błędowi.
Wymagania AssetGroupOperation
i AssetGroupAssetOperation
Operacje typu MutateOperation
, które tworzą zasoby AssetGroup
i AssetGroupAsset
w zadaniu zbiorczym, muszą być wykonywane sekwencyjnie bez innych operacji po drodze ze względu na sposób grupowania tych operacji podczas przetwarzania. W przeciwnym razie żądanie powoduje 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 są uwzględnione później na liście operacji.
AssetGroupListingGroupFilterOperation
sprawdzone metody
Podczas pracy z filtrami grup ofert w kontekście AssetGroupListingGroupFilter
zalecamy dodawanie operacji kierowanych na ten sam AssetGroup
do zadania zbiorczego kolejno, aby zestaw operacji był traktowany jako operacja atomowa podczas dzielenia zbiorczego.AssetGroupListingGroupFilterOperation
Więcej informacji o dzielenie partii i innych czynnikach wpływających na grupy stron aplikacji znajdziesz w przewodniku po przetwarzaniu partii grup stron aplikacji.
Dodaj operacje zmiany do zadania
Dodaj operacje mutacji z kroku 2 do listy i wywołaj funkcję AddBatchJobOperations
, aby dodać listę mutacji do zadania zbiorczego utworzonego w kroku 1.
Aby dodać listę operacji modyfikacji, wykonaj czynności związane z dodawaniem operacji opisane w ogólnym przewodniku po przetwarzaniu w partiach.
Uruchamianie zadania wsadowego
Aby rozpocząć wykonywanie przesłanych zadań, wywołaj funkcję RunBatchJob
. Przykład znajdziesz w sekcji Wykonywanie zbiorczego zadania w ogólnym przewodniku po zbiorczym przetwarzaniu danych.
Pobieranie stanu zadania
Zadania wsadowe zaczynają się jako długotrwałe operacje i zwykle zajmują dużo czasu.
Po rozpoczęciu zadania użyj metody długotrwałej operacji GetOperation
, aby sprawdzać stan zadania, dopóki nie zostanie ukończone.
Po zakończeniu wszystkich zadań zbiorczych zadzwoń pod numer ListBatchJobResults
, aby wydrukować ich stany i odpowiedzi. Aby to zrobić, wykonaj etap listy wszystkich wyników zadań zbiorczych w ogólnym przewodniku po przetwarzaniu zbiorczym.