Strukturanfragen

In diesem Leitfaden werden viele der Feinheiten der Strukturierung von Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen beschrieben. Sie kann eine nützliche Ressource für die Gestaltung Ihrer Integration sein. In diesem Leitfaden wird beschrieben, wie Anfragen zur Änderung von Performance Max-Kampagnen verarbeitet werden. Er kann als Ergänzung zum Leitfaden zur Fehlerbehebung bei Performance Max-Kampagnen und zum Leitfaden zur Batchverarbeitung von Performance Max-Kampagnen dienen.

Performance Max-Kampagnen erstellen

In der Google Ads API werden Performance Max-Kampagnenentitäten als Kombination aus mehreren eindeutigen Ressourcen dargestellt.

Standard-Performance Max-Kampagnen

Für die Auslieferung von Standard-Performance Max-Kampagnen ist ein Mindestsatz an Ressourcen erforderlich.

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

Bei Kampagnen mit aktivierten Markenrichtlinien müssen die Vorgänge zum Erstellen von Campaign und die erforderlichen CampaignAsset-Ressourcen in einer einzelnen Anfrage enthalten sein. Außerdem müssen die CampaignAsset-Ressourcen die Mindestanforderungen an Assets und die Spezifikationen erfüllen.

Die Vorgänge zum Erstellen von AssetGroup- und AssetGroupAsset-Einheiten müssen in einer einzigen Anfrage enthalten sein. Die AssetGroupAsset-Ressourcen müssen zusammen alle Mindestanforderungen und Spezifikationen für Assets erfüllen. Weitere Informationen Anfragen zum Erstellen eines 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 zum Erstellen von Performance Max-Kampagnen zu strukturieren. Die Entscheidung, wie Vorgänge gruppiert und Anfragen strukturiert werden, hängt weitgehend von Ihren Zielen und Ihrer Infrastruktur ab.

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

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

Mindestanforderungen für eine gültige Performance Max-Kampagne, in der Anzeigen ausgeliefert werden

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

• Signale für Asset-Gruppen
• Conversion-Zielvorhaben für Kampagnen
• Kampagnenkriterien

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

Performance Max-Kampagne mit zusätzlichen Optionen

Performance Max-Kampagnen für den Einzelhandel

Einzelhandelskampagnen sind insofern einzigartig, als es zwei separate Möglichkeiten gibt, Asset-Gruppen zu erstellen, die zu einer gültigen Kampagne 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, die in Ihrem verknüpften Merchant Center-Konto bereitgestellt werden, um Anzeigen zu erstellen. Wir empfehlen jedoch, Assets bereitzustellen, damit Sie das gesamte Inventar abdecken. Für Performance Max-Kampagnen für den Einzelhandel ist die folgende Mindestanzahl an Ressourcen 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 muss die final_urls in jedem AssetGroup mit URLs übereinstimmen, die der Merchant Center-Konto-ID zugeordnet sind, die in der Campaign.shopping_settings angegeben ist. Außerdem muss jeder AssetGroup einen zugehörigen, gültigen Produktlistengruppenbaum haben, der aus einer oder mehreren AssetGroupListingGroupFilter-Ressourcen besteht. Sie müssen mindestens einen einzelnen Knotenbaum erstellen, um alle Produkte in Ihrem angegebenen Merchant Center-Feed zu berücksichtigen.

Jede dieser Ressourcen kann separat oder in einer einzelnen Anfrage erstellt werden. Die Kampagne kann jedoch erst ausgeliefert werden, wenn alle diese Assets korrekt erstellt wurden.

Mindestanforderungen für die Auslieferung einer gültigen Performance Max-Kampagne für den Einzelhandel

Für Einzelhandelskampagnen können alle Optionen verwendet werden, die für Standard-Performance Max-Kampagnen verfügbar sind. Dazu gehören das Erstellen von Asset-Gruppensignalen, Conversion-Zielvorhaben für Kampagnen und Kampagnenkriterien. Wenn Sie beim Erstellen der AssetGroup-Ressource Assets zu einem AssetGroup hinzufügen, unterliegt Ihr AssetGroup den Mindestanforderungen für Assets. Sie können also entweder keine oder alle erforderlichen Assets einfügen.

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 muss zwischen ungültigen Status und ungültigen Anfragen unterschieden werden.

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 wird zwar erfolgreich ausgeführt, aber die Kampagne kann erst ausgeliefert werden, wenn Sie ihr mindestens ein AssetGroup hinzufügen. Wenn Ihre Anfragen erfolgreich sind, Ihre Kampagnen oder Asset-Gruppen aber nicht ausgeliefert werden, können Sie die Gründe anhand von CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason ermitteln. Weitere Informationen finden Sie im Leitfaden zur Fehlerbehebung.

Ungültige Anfrage

Eine Anfrage, die nicht erfolgreich wäre, 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, ein AssetGroup für eine Kampagne zu erstellen, die nicht für den Einzelhandel bestimmt ist, ohne die erforderlichen Mindest-Assets anzugeben. Aus diesem Grund müssen Sie eine AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen in derselben Anfrage angeben. Das bedeutet auch, dass alle Ihre AssetGroupAsset-Ressourcen die richtigen Spezifikationen für eine bestimmte field_type erfüllen müssen, damit der gesamte Antrag nicht fehlschlägt.

Vorgänge mit Mutate-Anfragen gruppieren

Performance Max-Kampagnen bestehen aus mehreren Ressourcen. Sie haben die Möglichkeit, diese separaten Ressourcen in einzelnen Anfragen oder in einer einzelnen Bulk-Mutate-Anfrage zu erstellen. AssetGroups und zugehörige AssetGroupAssets in Standard-Performance Max-Kampagnen müssen jedoch wie bereits erwähnt in einer einzelnen atomaren Anfrage erstellt werden.

Ihre Kampagne kann erst ausgeliefert werden, wenn Sie alle in diesem Leitfaden aufgeführten erforderlichen Ressourcen erstellt haben. Verwenden Sie bei separaten Anfragen die tatsächlichen Ressourcennamen der referenzierten Ressourcen in nachfolgenden Anfragen. Verwenden Sie beim Ausstellen von Bulk-Mutate-Anfragen mit mehreren Vorgängen Ressourcennamen, die mit temporären IDs gebildet werden.

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 nie auf eine Ressource verweisen, bevor sie erstellt wurde. Bei Bulk-Mutate-Anfragen müssen die Vorgänge so angeordnet werden, dass referenzierte Ressourcen vor den Ressourcen aufgeführt werden, die auf sie verweisen.

Wenn Sie Asset-Ressourcen in derselben Bulk-Mutate-Anfrage erstellen möchten, mit der eine AssetGroup- und ihre AssetGroupAsset-Ressourcen erstellt werden, müssen alle AssetOperations vor allen AssetGroupAssetOperations stehen, wie im Diagramm dargestellt.

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

Asset-Gruppen aktualisieren

Nachdem Sie ein gültiges AssetGroup erstellt haben, können Sie keine nachfolgenden Anfragen stellen, die zu einem ungültigen Status führen, in dem die Mindestanforderungen für Assets nicht mehr erfüllt sind. Bei solchen Anfragen wird ein Fehler ausgegeben. Wenn Sie beispielsweise eine AssetGroup mit einem einzelnen MARKETING_IMAGE erstellen (die Mindestanforderung), wird bei allen Anfragen zum Entfernen der AssetGroupAsset, die mit diesem MARKETING_IMAGE verknüpft sind, ein Fehler zurückgegeben.

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