Die Batchverarbeitung bietet eine Möglichkeit, eine Reihe von Vorgängen, die voneinander abhängig sein können, an mehrere Dienste weiterzuleiten, ohne synchron auf den Abschluss der Vorgänge warten zu müssen. Sie können die Batchverarbeitung verwenden, um Performance Max-Kampagnen zu erstellen und zu verwalten.
Dieser Leitfaden enthält Details zu Performance Max-Kampagnen bei der Batchverarbeitung. Im allgemeinen Leitfaden zur Batchverarbeitung finden Sie allgemeine Informationen zur Batchverarbeitung. Im Leitfaden zu Strukturanfragen finden Sie detaillierte Informationen zum Erstellen von Anfragen zum Erstellen oder Verwalten von Performance Max-Kampagnen.
So erstellen Sie eine Performance Max-Kampagne mit Batchverarbeitung:
Neuen Batchjob erstellen
Führen Sie den allgemeinen Schritt zur Joberstellung für die Batchverarbeitung aus, um eine BatchJob-Ressource zu erstellen.
Liste mit mutate-Vorgängen erstellen
Bei Performance Max-Kampagnen müssen mehrere zugehörige Ressourcen erstellt werden. Weitere Informationen dazu finden Sie im Leitfaden zu Strukturanfragen. Erstellen Sie eine MutateOperation für jede Ressource, die im Batchjob enthalten sein soll.
AssetGroupOperation- und AssetGroupAssetOperation-Anforderungen
Die Vorgänge vom Typ MutateOperation, mit denen Ressourcen vom Typ AssetGroup und AssetGroupAsset in einem Batchjob erstellt werden, müssen ohne andere Vorgänge dazwischen erfolgen, da diese Vorgänge bei der Verarbeitung gruppiert werden. Andernfalls gibt die Anfrage eine AssetGroupError zurück, die angibt, dass einige Assets fehlen, auch wenn die Vorgänge, die zur Erfüllung der Mindestanforderungen an Assets erforderlich sind, weiter unten in der Liste der Vorgänge aufgeführt sind.
AssetGroupListingGroupFilterOperation Best Practices
Wenn Sie Gruppenfilter für Listen im Kontext einer AssetGroupListingGroupFilter verwenden, sollten Sie einem Batchjob AssetGroupListingGroupFilterOperation-Vorgänge hinzufügen, die auf denselben AssetGroup ausgerichtet sind. So wird die Gruppe von Vorgängen während der Batchaufteilung atomar behandelt. Weitere Informationen zur Batchaufteilung und anderen Faktoren, die sich auf Eintragsgruppen auswirken, finden Sie in der Anleitung zur Batchverarbeitung für Eintragsgruppen.
mutate-Vorgänge zum Auftrag hinzufügen
Fügen Sie die mutate-Vorgänge aus Schritt 2 einer Liste hinzu und rufen Sie AddBatchJobOperations auf, um die Liste der Mutationen dem in Schritt 1 erstellten Batch-Auftrag hinzuzufügen.
Folgen Sie dem Schritt zum Hinzufügen von Vorgängen in der allgemeinen Anleitung zur Batchverarbeitung, um die Liste der mutate-Vorgänge hinzuzufügen.
Batchjob ausführen
Starten Sie die Ausführung der hochgeladenen Jobs, indem Sie RunBatchJob aufrufen. Ein Beispiel finden Sie im Schritt Batchjob ausführen im allgemeinen Leitfaden zur Batchverarbeitung.
Jobstatus abrufen
Batchjobs beginnen als lang andauernde Vorgänge und benötigen in der Regel eine gewisse Zeit, bis sie abgeschlossen sind.
Verwenden Sie nach dem Start des Jobs die Methode GetOperation des Vorgangs mit langer Ausführungszeit, um den Status des Jobs abzufragen, bis er abgeschlossen ist.
Wenn alle Batchjobs abgeschlossen sind, rufen Sie ListBatchJobResults auf, um den jeweiligen Status und die Antworten auszudrucken. Folgen Sie dazu dem Schritt Ergebnisse aller Batchjobs auflisten in der allgemeinen Batchverarbeitungsanleitung.