Die Batchverarbeitung bietet die Möglichkeit, eine Reihe von Vorgängen, die möglicherweise voneinander abhängig sind, 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 Informationen speziell zu Performance Max-Kampagnen bei der Batchverarbeitung. Der allgemeine Leitfaden zur Batchverarbeitung enthält allgemeine Informationen zur Batchverarbeitung. Der Leitfaden zum Strukturieren von Anfragen enthält detaillierte Informationen zum Erstellen von Anfragen zum Erstellen oder Verwalten von Performance Max-Kampagnen.
So erstellen Sie eine Performance Max-Kampagne mithilfe der Batchverarbeitung:
Neuen Batchjob erstellen
Folgen Sie dem Schritt zum Erstellen von Jobs für die allgemeine Batchverarbeitung, um eine BatchJob-Ressource zu erstellen.
Liste der Änderungsvorgänge erstellen
Für Performance Max-Kampagnen sind Vorgänge erforderlich, um mehrere zugehörige Ressourcen zu erstellen. Weitere Informationen finden Sie im Leitfaden für Strukturanfragen. Erstellen Sie für jede Ressource, die in den Batchjob aufgenommen werden soll, eine MutateOperation.
Anforderungen für CampaignOperation und CampaignAssetOperation
Wenn Markenrichtlinien für eine Kampagne aktiviert sind (siehe Markenrichtlinien), müssen Sie Marken-Assets mithilfe von CampaignAsset-Ressourcen mit der Kampagne verknüpfen. Außerdem müssen diese CampaignAsset-Ressourcen in einem Batchjob unmittelbar nach dem Erstellen der Campaign-Ressource selbst erstellt werden. Wenn die CampaignAsset-Ressourcen nicht direkt nach der Campaign-Ressource erstellt werden (wenn Markenrichtlinien aktiviert sind, siehe Fehlerbehebung), schlägt die Anfrage fehl und es wird eine CampaignError mit fehlenden Assets zurückgegeben.
Wenn Sie die Erstellungsvorgänge für CampaignAsset später in derselben Liste mit Vorgängen einfügen, wird dieser Fehler nicht verhindert.
Anforderungen für AssetGroupOperation und AssetGroupAssetOperation
Die Vorgänge vom Typ MutateOperation, die AssetGroup- und AssetGroupAsset-Ressourcen in einem Batchjob erstellen, müssen sequenziell und ohne andere Vorgänge dazwischen ausgeführt werden, da diese Vorgänge bei der Verarbeitung gruppiert werden. Andernfalls wird bei der Anfrage eine AssetGroupError ausgegeben, die darauf hinweist, dass einige Assets fehlen, auch wenn die Vorgänge, die zur Erfüllung der Mindestanforderungen an Assets erforderlich sind, später in der Liste der Vorgänge enthalten sind.
AssetGroupListingGroupFilterOperation Best Practices
Wenn Sie Listengruppenfilter im Zusammenhang mit einer AssetGroupListingGroupFilter verwenden, empfehlen wir, einem Batchjob nacheinander AssetGroupListingGroupFilterOperation-Vorgänge hinzuzufügen, die auf dieselbe AssetGroup ausgerichtet sind, damit die Vorgänge bei der Batchaufteilung atomar behandelt werden. Weitere Informationen zur Aufteilung von Batches und anderen Faktoren, die sich auf Gruppen von Einträgen auswirken, finden Sie im Leitfaden zur Batchverarbeitung von Gruppen von Einträgen.
Dem Job die Mutaionsvorgänge hinzufügen
Fügen Sie die Mutaionsvorgänge aus Schritt 2 einer Liste hinzu und rufen Sie AddBatchJobOperations auf, um die Liste der Mutationen dem Batchjob hinzuzufügen, der in Schritt 1 erstellt wurde.
Folgen Sie dem Schritt zum Hinzufügen von Vorgängen im allgemeinen Leitfaden zur Batchverarbeitung, um die Liste der Mutavorgäne hinzuzufügen.
Batchjob ausführen
Starten Sie die hochgeladenen Jobs, indem Sie RunBatchJob aufrufen. Ein Beispiel finden Sie im allgemeinen Leitfaden zur Batchverarbeitung im Schritt Batchjob ausführen.
Status des Jobs abrufen
Batchjobs beginnen als lang andauernde Vorgänge und dauern in der Regel einige Zeit.
Nachdem Sie den Job gestartet haben, können Sie mit der Methode GetOperation des Vorgangs mit langer Ausführungszeit den Status des Jobs abfragen, bis er abgeschlossen ist.
Wenn alle Batchjobs abgeschlossen sind, rufen Sie ListBatchJobResults auf, um ihre Status und Antworten auszugeben. Folgen Sie dazu dem Schritt Alle Ergebnisse von Batchjobs auflisten im allgemeinen Leitfaden zur Batchverarbeitung.