Die Batchverarbeitung bietet eine Möglichkeit, eine Reihe von Vorgängen, die voneinander abhängig sein können, an mehrere Dienste zu senden, ohne synchron auf den Abschluss der Vorgänge zu warten. Sie können die Batchverarbeitung verwenden, um Performance Max-Kampagnen zu erstellen und zu verwalten.
In diesem Leitfaden finden Sie Details zu Performance Max-Kampagnen bei der Batchverarbeitung. Im allgemeinen Leitfaden zur Batchverarbeitung finden Sie allgemeine Informationen zur Batchverarbeitung und im Leitfaden zum Strukturieren von Anfragen detaillierte Informationen zum Erstellen von Anfragen zum Erstellen oder Verwalten von Performance Max Kampagnen.
So erstellen Sie eine Performance Max-Kampagne mit der Batchverarbeitung:
Neuen Batchjob erstellen
Folgen Sie der allgemeinen Anleitung zum Erstellen von Batchverarbeitungs
jobs, um eine
BatchJob-Ressource zu erstellen.
Liste der Mutationsvorgänge vorbereiten
Für Performance Max-Kampagnen sind Vorgänge zum Erstellen mehrerer verknüpfter
Ressourcen erforderlich, die im
Leitfaden zum Strukturieren von Anfragenbeschrieben werden. Erstellen Sie ein
MutateOperation für jede Ressource, die im Batchjob enthalten sein
soll.
Anforderungen für CampaignOperation und CampaignAssetOperation
Wenn Markenrichtlinien für eine Kampagne aktiviert sind (siehe
Markenrichtlinien), müssen Sie
Marken-Assets mit der Kampagne mithilfe von CampaignAsset
Ressourcen verknüpfen. Außerdem muss die Erstellung dieser CampaignAsset
Ressourcen in einem Batchjob unmittelbar nach der Erstellung der Campaign
Ressource erfolgen. Wenn die CampaignAsset Ressourcen nicht sofort
nach der Campaign Ressource erstellt werden (wenn Markenrichtlinien aktiviert sind – siehe
Fehlerbehebung),
schlägt die Anfrage fehl und gibt eine CampaignError zurück, die auf fehlende Assets hinweist.
Wenn Sie die Erstellungsvorgänge für CampaignAsset später in derselben Liste von Vorgängen einfügen, wird dieser Fehler nicht verhindert.
Anforderungen für AssetGroupOperation und AssetGroupAssetOperation
Die Vorgänge vom Typ MutateOperation, mit denen
AssetGroup und
AssetGroupAsset-Ressourcen in einem Batchjob erstellt werden, müssen
sequenziell ohne andere Vorgänge dazwischen erfolgen, da diese
Vorgänge bei der Verarbeitung gruppiert werden. Andernfalls wird mit der Anfrage ein
AssetGroupError ausgelöst, der darauf hinweist, dass einige Assets fehlen,
auch wenn die Vorgänge, die zum
Erfüllen der Mindestanforderungen an Assets erforderlich sind, später
in der Liste der Vorgänge enthalten sind.
Best Practices für AssetGroupListingGroupFilterOperation
Wenn Sie mit Filtern für Eintragsgruppen im Zusammenhang mit einem
AssetGroupListingGroupFilter arbeiten, empfehlen wir,
AssetGroupListingGroupFilterOperation
-Vorgänge, die auf dieselbe AssetGroup ausgerichtet sind, nacheinander zu einem
Batchjob hinzuzufügen, damit die Vorgänge bei der Batchaufteilung atomar behandelt werden. Weitere Informationen zur Batchaufteilung und zu anderen Faktoren
, die sich auf Eintragsgruppen auswirken, finden Sie im
Leitfaden zur Batchverarbeitung von Eintragsgruppen.
Mutationsvorgänge zum Job hinzufügen
Fügen Sie die Mutationsvorgänge aus Schritt 2 einer Liste hinzu und rufen Sie
AddBatchJobOperations
auf, um die Liste der Mutationen zum in Schritt 1 erstellten Batchjob hinzuzufügen.
Folgen Sie der Anleitung zum Hinzufügen von Vorgängen
im allgemeinen Leitfaden zur Batchverarbeitung, um die Liste der Mutationsvorgänge hinzuzufügen.
Batchjob ausführen
Rufen Sie
RunBatchJob auf, damit die hochgeladenen Jobs ausgeführt werden können. Ein Beispiel finden Sie im
Schritt Batchjob ausführen
im allgemeinen Leitfaden zur Batchverarbeitung.
Status des Jobs abrufen
Batchjobs werden als Vorgänge mit langer Ausführungszeit gestartet und benötigen in der Regel Zeit, bis sie abgeschlossen sind.
Nach dem Starten des Jobs können Sie mit der GetOperationMethode des Vorgangs mit langer Ausführungszeitden Status des Jobs abrufen, bis er abgeschlossen ist.
Wenn alle Batchjobs abgeschlossen sind, rufen Sie
ListBatchJobResults auf,
um die Status und Antworten auszugeben. Folgen Sie dazu der Anleitung zum
Auflisten aller Batchjob-Ergebnisse im
allgemeinen Leitfaden zur Batchverarbeitung.