Strukturanfragen

In diesem Leitfaden erfahren Sie, wie Sie Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen strukturieren. Sie kann eine hilfreiche Ressource beim Entwerfen Ihrer Integration sein. In diesem Leitfaden wird erläutert, wie Anfragen verarbeitet werden, die Performance Max-Kampagnen verändern. Er kann als Ergänzung zum Leitfaden zur Fehlerbehebung bei Performance Max-Kampagnen und zum Leitfaden zur Batchverarbeitung von Performance Max-Kampagnen verwendet werden.

Performance Max-Kampagnen erstellen

In der Google Ads API werden Performance Max-Kampagnenentitäten als Kombination mehrerer eindeutiger Ressourcen dargestellt.

Standard-Performance Max-Kampagnen

Für Standard-Performance Max-Kampagnen sind mindestens eine Reihe von Ressourcen erforderlich, damit Anzeigen ausgeliefert werden können.

• Kampagnenbudget
• Kampagne
• Kampagnen-Assets (nur für Kampagnen mit aktivierten Markenrichtlinien)
• Asset-Gruppen
• Assets in Asset-Gruppen
• Assets

Bei Kampagnen, für die Markenrichtlinien aktiviert sind, müssen die Vorgänge zum Erstellen von Campaign und die erforderlichen CampaignAsset-Ressourcen in einer einzigen Anfrage enthalten sein. Außerdem müssen die CampaignAsset-Ressourcen die Mindestanforderungen und ‑spezifikationen für Assets erfüllen.

Die Vorgänge zum Erstellen von AssetGroup- und AssetGroupAsset-Entitäten müssen in einer einzigen Anfrage enthalten sein. Die AssetGroupAsset-Ressourcen müssen zusammen alle Mindestvoraussetzungen für Assets und Spezifikationen erfüllen. Wie sich das für Einzelhandelskampagnen unterscheidet, wird unten erläutert. Anfragen zum Erstellen einer AssetGroup ohne alle erforderlichen AssetGroupAsset-Entitäten führen zu einem Fehler. Weitere Informationen finden Sie unter Ungültiger Status im Vergleich zu ungültigen Anfragen.

Es gibt verschiedene Möglichkeiten, Anfragen für die Erstellung von Performance Max-Kampagnen zu strukturieren. Die Entscheidung, wie Sie Vorgänge gruppieren und Anfragen strukturieren, hängt weitgehend von Ihren Zielen und Ihrer Infrastruktur ab.

• Erstellen Sie die CampaignBudget-, Campaign-, Asset- und CampaignAsset-Ressourcen in separaten Anfragen, bevor Sie die AssetGroup- und AssetGroupAsset-Ressourcen erstellen. Bei Kampagnen mit aktivierten Markenrichtlinien müssen die Campaign- und die erforderlichen CampaignAsset-Ressourcen in einer einzigen Anfrage enthalten sein.
• Fügen Sie alle diese Ressourcen in eine einzelne Mutanfrage ein.

Sie können die Ressourcen vom Typ CampaignBudget, Campaign, Asset und CampaignAsset in separaten vorherigen Anfragen erstellen. Die Anzeigen der Performance Max-Kampagne können jedoch erst ausgeliefert werden, wenn auch die Ressourcen vom Typ AssetGroup und AssetGroupAsset erstellt wurden.

Mindestanforderungen für eine gültige Auslieferung von Performance Max-Kampagnen

Sie können Ihre Performance Max-Kampagnen weiter anpassen, indem Sie wie im Diagramm dargestellt zusätzliche Ressourcen erstellen.

• Asset-Gruppensignale
• Conversion-Zielvorhaben für Kampagnen
• Kampagnenkriterien

Sie können Vorgänge zum Erstellen von AssetGroupSignal-Ressourcen in derselben Anfrage einschließen, mit der die AssetGroup- und AssetGroupAsset-Ressourcen erstellt werden. Alternativ können Sie AssetGroupSignal-Entitäten in einer separaten Anfrage erstellen, nachdem Sie die AssetGroup erstellt haben.

Performance Max-Kampagne mit zusätzlichen Optionen

Performance Max-Kampagnen für den Einzelhandel

Einzelhandelskampagnen sind insofern einzigartig, als es zwei Möglichkeiten gibt, Asset-Gruppen zu erstellen, die zu einer gültigen Auslieferungskampagne führen:

• Asset-Gruppen ohne Assets
• Asset-Gruppen, die ALLE erforderlichen Assets enthalten (bevorzugt)

Wenn Sie Assets aus Asset-Gruppen ausschließen, verwendet Google automatisch die Assets in Ihrem verknüpften Merchant Center-Konto, um Anzeigen zu erstellen. Wir empfehlen jedoch, Assets bereitzustellen, die für das gesamte Inventar verwendet werden können. Für Performance Max-Kampagnen für den Einzelhandel sind die folgenden Mindestressourcen erforderlich, damit Anzeigen ausgeliefert werden können.

• CampaignBudget
• Campaign (mit ausgefülltem ShoppingSettings)
• AssetGroup
• AssetGroupListingGroupFilter

Das Feld Campaign.shopping_settings muss in Einzelhandelskampagnen ausgefüllt sein. Außerdem müssen die in den einzelnen final_urls aufgeführten final_urls mit den URLs übereinstimmen, die mit der in der Campaign.shopping_settings angegebenen Merchant Center-Konto-ID verknüpft sind.AssetGroup Schließlich muss jeder AssetGroup ein gültiger Produkteintragsgruppenbaum mit einer oder mehreren AssetGroupListingGroupFilter-Ressourcen zugeordnet sein. Sie müssen mindestens einen Knotenbaum erstellen, der alle Produkte in Ihrem angegebenen Merchant Center-Feed berücksichtigt.

Jede dieser Ressourcen kann separat oder in einer einzigen Anfrage erstellt werden. Die Anzeigen der Kampagne können jedoch erst ausgeliefert werden, wenn alle diese Ressourcen korrekt erstellt wurden.

Mindestanforderungen für eine gültige Auslieferung von Performance Max-Kampagnen für den Einzelhandel

Für Einzelhandelskampagnen stehen alle Optionen zur Verfügung, die auch für Standard-Performance Max-Kampagnen verfügbar sind. Dazu gehören das Erstellen von Asset-Gruppensignalen, Kampagnen-Conversion-Zielvorhaben und Kampagnenkriterien. Wenn du einer AssetGroup beim Erstellen der AssetGroup-Ressource Assets hinzufügst, gelten für die AssetGroup die Mindestanforderungen an Assets. Mit anderen Worten: Sie können entweder keine oder alle erforderlichen Assets einschließen.

Performance Max-Kampagne für den Einzelhandel mit zusätzlichen Optionen

Ungültiger Status im Vergleich zu ungültigen Anfragen

Bei der Arbeit mit Performance Max-Kampagnen in der Google Ads API ist es wichtig, zwischen ungültigen Zuständen und ungültigen Anfragen zu unterscheiden.

Ungültiges Bundesland

Die Kampagne kann aufgrund ihrer Konfiguration nicht ausgeliefert werden. Sie können beispielsweise eine eigenständige Campaign-Ressource mit dem advertising_channel_type PERFORMANCE_MAX erstellen. Die Anfrage zum Erstellen der Kampagne ist zwar erfolgreich, Anzeigen können aber erst ausgeliefert werden, wenn Sie der Kampagne mindestens eine AssetGroup hinzugefügt haben. Wenn Ihre Anfragen erfolgreich sind, Ihre Kampagnen- oder Asset-Gruppen aber nicht ausgeliefert werden, können Sie mit CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason den Grund ermitteln. Weitere Informationen finden Sie im Leitfaden zur Fehlerbehebung.

Ungültige Anfrage

Eine Anfrage, die fehlschlagen würde, weil sie die Kampagne oder Ressource in einen ungültigen Status versetzen würde. Die Google Ads API gibt beispielsweise einen Fehler aus, wenn Sie versuchen, eine AssetGroup für eine Kampagne ohne Einzelhandel zu erstellen, ohne die erforderlichen Assets anzugeben. Daher müssen Sie eine AssetGroup- und die zugehörigen AssetGroupAsset-Ressourcen in derselben Anfrage angeben. Das bedeutet auch, dass alle AssetGroupAsset-Ressourcen die richtigen Spezifikationen für eine bestimmte field_type erfüllen müssen, damit die gesamte Anfrage nicht fehlschlägt.

Vorgänge mit Mutanfragen gruppieren

Performance Max-Kampagnen bestehen aus mehreren Ressourcen. Sie können diese separaten Ressourcen in einzelnen Anfragen oder in einer einzigen Bulk-Änderungsanfrage erstellen. AssetGroups und zugehörige AssetGroupAssets in Standard-Performance Max-Kampagnen müssen jedoch, wie bereits erwähnt, in einer einzigen atomaren Anfrage erstellt werden.

Anzeigen in Ihrer Kampagne können erst ausgeliefert werden, wenn Sie alle in diesem Leitfaden beschriebenen erforderlichen Ressourcen erstellt haben. Verwenden Sie bei separaten Anfragen die tatsächlichen Ressourcennamen der referenzierten Ressourcen in nachfolgenden Anfragen. Verwenden Sie bei Bulk-Änderungsanfragen mit mehreren Vorgängen Ressourcennamen, die mithilfe von temporären IDs erstellt wurden.

Reihenfolge von Vorgängen

Unabhängig davon, ob Sie eine Bulk-Mutationsanfrage zum Erstellen einer Performance Max-Kampagne verwenden, müssen Sie Ihre Anfragen und Vorgänge so anordnen, dass Sie niemals auf eine Ressource verweisen, bevor sie erstellt wurde. Bei Bulk-Änderungsanfragen bedeutet das, dass die Vorgänge so sortiert werden müssen, dass die referenzierten Ressourcen vor den Ressourcen aufgeführt werden, auf die sie verweisen.

Wenn Sie Asset-Ressourcen in derselben Bulk-Änderungsanfrage erstellen, mit der eine AssetGroup und ihre AssetGroupAsset-Ressourcen erstellt werden, sollten alle AssetOperations vor allen AssetGroupAssetOperations stehen, wie im Diagramm dargestellt.

Der Google Ads-Server gruppiert aufeinanderfolgende AssetGroupAssetOperations und prüft, ob ein AssetGroup nach dem letzten Vorgang in dieser Gruppe die Mindestanforderungen an Assets erfüllt. Wenn du in deiner Anfrage zwischen AssetOperations und AssetGroupAssetOperations wechselst, prüft der API-Server nach der ersten AssetGroupAssetOperation die Mindestanforderungen an Assets und gibt einen Fehler zurück, ohne mit den restlichen Vorgängen in der Anfrage fortzufahren. Daher werden Ihrem Google Ads-Konto keine der Assets in der Anfrage hinzugefügt. Außerdem werden weder die AssetGroup- noch die zugehörigen AssetGroupAsset-Ressourcen erstellt.

Asset-Gruppen aktualisieren

Nachdem du ein gültiges AssetGroup erstellt hast, kannst du keine nachfolgenden Anfragen senden, die zu einem ungültigen Status führen würden, bei dem die Mindestanforderungen an Assets nicht mehr erfüllt werden. Bei solchen Anfragen wird ein Fehler ausgegeben. Wenn Sie beispielsweise eine AssetGroup mit einer einzelnen MARKETING_IMAGE erstellen (die Mindestanforderung), wird bei allen Anfragen zum Entfernen der mit dieser MARKETING_IMAGE verknüpften AssetGroupAsset ein Fehler zurückgegeben.

Das ist besonders wichtig bei Asset-Gruppen in Einzelhandelskampagnen, die ohne zugehörige Assets erstellt wurden. Nachfolgende Anfragen, der AssetGroup durch Erstellen von AssetGroupAsset-Ressourcen Assets hinzuzufügen, sind nur dann erfolgreich, wenn die Anfrage alle Asset-Anforderungen erfüllt. Sie können diesen Asset-Gruppen also nicht nach und nach Assets hinzufügen.