Batchverarbeitung für Performance Max-Kampagnen

Mit der Batchverarbeitung können Sie eine Reihe von Vorgängen, die voneinander abhängig sein können, an mehrere Dienste senden, 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.

In diesem Leitfaden finden Sie Details zu Performance Max-Kampagnen, wenn Sie mit der Batchverarbeitung arbeiten. 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, eine MutateOperation.

Anforderungen für CampaignOperation und CampaignAssetOperation

Wenn Markenrichtlinien für eine Performance Max-Kampagne Campaign aktiviert sind (brand_guidelines_enabled ist standardmäßig auf true festgelegt, sofern Sie nicht false festlegen oder eine Kampagne mit Zielvorhaben für die Reisebranche erstellen), müssen Sie Asset-Markenressourcen mithilfe von CampaignAsset-Ressourcen mit der Kampagne verknüpfen. Performance Max-Kampagnen für lokale Dienstleistungen unterstützen keine Markenrichtlinien und lassen Markenressourcen vom Typ CampaignAsset aus. Setzen Sie brand_guidelines_enabled beim Erstellen der Kampagne auf false. Bei Performance Max-Kampagnen für den Einzelhandel (mit einem Merchant Center-Feed) können Markenressourcen vom Typ CampaignAsset im selben atomaren Unterbatch nur dann weggelassen werden, wenn Sie eine Kampagne ohne Assets und ohne benutzerdefinierte AssetGroupAsset-Ressourcen (außer HTML5-MEDIA_BUNDLE-Assets) erstellen oder wenn brand_guidelines_enabled auf false festgelegt ist.

Erstellen Sie in einem Batchjob diese CampaignAsset-Ressourcen sofort nach dem Erstellen der Campaign-Ressource selbst (insgesamt bis zu 1.000 Vorgänge im atomaren Unterbatch). Für den create-Vorgang (resource_name) zum Erstellen von Campaign und die nachfolgenden create-Vorgänge (campaign) zum Erstellen von CampaignAsset muss dieselbe negative temporäre ID angegeben werden. Alle erforderlichen create-Vorgänge zum Erstellen von AssetOperation müssen vor dem Erstellen von Campaign platziert 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

Wenn Sie AssetGroup-Ressourcen mit zugehörigen Asset-Ressourcen mithilfe von AssetGroupAsset erstellen, um die Mindestanforderungen für Assets zu erfüllen, müssen die MutateOperation-Objekte, die die AssetGroup- und AssetGroupAsset-Ressourcen in einem Batchauftrag erstellen, sequenziell sein, ohne dass andere Vorgänge dazwischen liegen. Das liegt daran, wie diese Vorgänge in atomare Unterbatches (insgesamt bis zu 1.000 Vorgänge pro Unterbatch) gruppiert werden. Geben Sie im AssetGroup-create-Vorgang (resource_name) und in den nachfolgenden AssetGroupAsset-create-Vorgängen (asset_group) dieselbe negative temporäre ID an und platzieren Sie alle erforderlichen AssetOperation-create-Vorgänge vor der AssetGroup-Erstellung. Andernfalls schlägt die Anfrage mit einem AssetGroupError fehl, der angibt, dass einige Assets fehlen, auch wenn die Vorgänge, die zum Erfüllen der Mindestanforderungen an Assets erforderlich sind, später in der Vorgangsliste enthalten sind.

AssetGroupListingGroupFilterOperation Best Practices

Wenn Sie AssetGroupListingGroupFilter-Ressourcen erstellen, aktualisieren oder entfernen, fügen Sie dem Batchjob alle AssetGroupListingGroupFilterOperation-Vorgänge, die auf dieselbe AssetGroup abzielen, nacheinander hinzu, damit die Vorgänge während der Batchaufteilung in einem atomaren Sub-Batch gruppiert 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 die Methode 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 Mutate-Vorgänge hinzuzufügen.

Batchjob ausführen

Starten Sie die hochgeladenen Vorgänge durch einen Aufruf der Methode RunBatchJob. Ein Beispiel finden Sie im Schritt Batchjob ausführen im allgemeinen Leitfaden zur Batchverarbeitung.

Jobstatus abfragen und Ergebnisse abrufen

Batchjobs werden als Vorgänge mit langer Ausführungszeit ausgeführt und dauern in der Regel eine Weile. Nachdem Sie den Job gestartet haben, verwenden Sie die Methode Operations.GetOperation für den Dienst google.longrunning.Operations (oder fragen Sie batch_job.status mit GoogleAdsService ab), um den Status des Jobs abzufragen, bis er abgeschlossen ist.

Wenn der Batchjob abgeschlossen ist, rufen Sie die Methode ListBatchJobResults auf, um den Status und die Antwort für jeden Vorgang im Job abzurufen. Ein Beispiel finden Sie unter Alle Batch-Job-Ergebnisse auflisten.