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. Der allgemeine Leitfaden zur Batchverarbeitung enthält allgemeine Informationen zur Batchverarbeitung. Im Leitfaden zum Strukturieren von Anfragen 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
Folgen Sie dem allgemeinen Schritt zum Erstellen von Batchverarbeitungsjobs, um eine BatchJob-Ressource zu erstellen.
Liste der Änderungsvorgänge vorbereiten
Für Performance Max-Kampagnen müssen mehrere zugehörige Ressourcen erstellt werden. Weitere Informationen finden Sie im Leitfaden zum Strukturieren von Anfragen. Erstellen Sie für jede Ressource, die in den Batchjob aufgenommen werden soll, ein 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 der Erstellung der Campaign-Ressource selbst erstellt werden. Wenn die CampaignAsset-Ressourcen nicht unmittelbar nach der Campaign-Ressource erstellt werden (wenn Markenrichtlinien aktiviert sind – siehe Fehlerbehebung), schlägt die Anfrage fehl und es wird ein CampaignError zurückgegeben, der auf fehlende Assets hinweist.
Wenn Sie die CampaignAsset-Erstellungsvorgänge 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, die AssetGroup- und AssetGroupAsset-Ressourcen in einem Batchjob erstellen, müssen sequenziell ohne andere Vorgänge dazwischen sein, da diese Vorgänge bei der Verarbeitung zusammen gruppiert werden. Andernfalls wird bei der Anfrage ein AssetGroupError-Fehler ausgegeben, der darauf hinweist, dass einige Assets fehlen, auch wenn die Vorgänge, die erforderlich sind, um die Mindestanforderungen an Assets zu erfüllen, später in der Vorgangsliste enthalten sind.
AssetGroupListingGroupFilterOperation Best Practices
Wenn Sie mit Filtern für Eintragsgruppen im Kontext einer AssetGroupListingGroupFilter arbeiten, empfehlen wir, AssetGroupListingGroupFilterOperation-Vorgänge, die auf dieselbe AssetGroup abzielen, nacheinander einem Batchjob hinzuzufügen, damit die Vorgänge bei der Batchaufteilung unteilbar 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 Mutate-Vorgänge aus Schritt 2 einer Liste hinzu und rufen Sie AddBatchJobOperations auf, um die Liste der Mutationen dem in Schritt 1 erstellten Batchjob hinzuzufügen.
Folgen Sie dem Schritt zum Hinzufügen von Vorgängen im allgemeinen Leitfaden zur Batchverarbeitung, um die Liste der Änderungsvorgänge hinzuzufügen.
Batchjob ausführen
Lassen Sie die hochgeladenen Jobs durch Aufrufen von RunBatchJob starten. Ein Beispiel finden Sie im allgemeinen Leitfaden zur Batchverarbeitung im Schritt Batchjob ausführen.
Jobstatus abrufen
Batchjobs werden als Vorgänge mit langer Ausführungszeit gestartet und dauern in der Regel einige Zeit.
Verwenden Sie nach dem Starten 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 ihre Status und Antworten auszugeben. Folgen Sie dazu dem Schritt Alle Batchjob-Ergebnisse auflisten im allgemeinen Leitfaden zur Batchverarbeitung.