Przetwarzanie wsadowe w kampaniach Performance Max

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ólne informacje o przetwarzaniu w partiach znajdziesz w ogólnym przewodniku po przetwarzaniu w partiach, a szczegółowe informacje o składaniu żądań w celu tworzenia kampanii Performance Max lub zarządzania nimi – w przewodniku po żądaniach strukturalnych.

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 strukturze żądań. 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 CampaignAssetmusi 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 z informacją o braku 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 sprawdzonych metod

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 ono ukończone.

Po zakończeniu wszystkich zadań zbiorczych zadzwoń pod numer ListBatchJobResults, aby wydrukować ich stany i odpowiedzi. Aby to zrobić, wykonaj etap wyświetlania wszystkich wyników zadań zbiorczych w ogólnym przewodniku po przetwarzaniu zbiorczym.