Strukturanfragen

In diesem Leitfaden werden viele der Komplexitäten bei der Strukturierung von Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen beschrieben. Sie kann beim Entwerfen der Integration eine nützliche Ressource sein. In diesem Leitfaden wird erläutert, wie Anfragen zur Änderung von Performance Max-Kampagnen verarbeitet werden. Außerdem können Sie den Leitfaden zur Fehlerbehebung bei Performance Max-Kampagnen und den Leitfaden zur Batchverarbeitung für Performance Max-Kampagnen ergänzen.

Performance Max-Kampagnen erstellen

In der Google Ads API werden Entitäten für Performance Max-Kampagnen als Kombination mehrerer eindeutiger Ressourcen dargestellt.

Standardmäßige Performance Max-Kampagnen

Für Standard-Performance Max-Kampagnen ist ein Minimum an Ressourcen erforderlich.

Die Vorgänge zum Erstellen der Entitäten AssetGroup und AssetGroupAsset müssen zusammen in einer einzigen Anfrage enthalten sein und die AssetGroupAsset-Ressourcen müssen zusammengehören, um alle Mindestanforderungen an Assets und Spezifikationen zu erfüllen. Hier sehen Sie, was sich bei Einzelhandelskampagnen unterscheidet. 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 zu strukturieren, mit denen Performance Max-Kampagnen erstellt werden. 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 und Asset in separaten Anfragen, bevor Sie die Ressourcen AssetGroup und AssetGroupAsset erstellen.
Binden Sie alle diese Ressourcen in eine einzelne mutate-Anfrage ein.

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

Mindestanforderungen für eine gültige Performance Max-Kampagne

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

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

Performance Max-Kampagne mit zusätzlichen Optionen

Performance Max-Kampagnen für den Einzelhandel

Das Besondere an Einzelhandelskampagnen ist, dass es zwei separate Möglichkeiten zum Erstellen von Asset-Gruppen gibt, die zu einer gültigen Kampagne zur Anzeigenauslieferung 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 für das gesamte Inventar bereitzustellen. Für Performance Max-Kampagnen für den Einzelhandel sind die folgenden Mindestressourcen erforderlich.

CampaignBudget
Campaign (mit ausgefülltem ShoppingSettings)
AssetGroup
AssetGroupListingGroupFilter

Bei Einzelhandelskampagnen muss das Feld Campaign.shopping_settings ausgefüllt werden. Außerdem müssen die final_urls in jeder AssetGroup mit den URLs übereinstimmen, die mit der Merchant Center-Konto-ID verknüpft sind, die in Campaign.shopping_settings angegeben ist. Schließlich muss jeder AssetGroup eine verknüpfte, gültige Struktur für Produktgruppen mit einer oder mehreren AssetGroupListingGroupFilter-Ressourcen haben. Sie müssen mindestens eine einzelne Knotenstruktur erstellen, um alle Produkte im 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 Ressourcen korrekt erstellt wurden.

Mindestanforderungen für eine gültige Performance Max-Kampagne für den Einzelhandel

Bei Einzelhandelskampagnen können alle Optionen genutzt werden, die für standardmäßige Performance Max-Kampagnen verfügbar sind. Dazu zählen das Erstellen von Asset-Gruppensignalen, Conversion-Zielvorhaben der Kampagne und Kampagnenkriterien. Wenn Sie beim Erstellen der AssetGroup-Ressource einem AssetGroup Assets hinzufügen, gelten für Ihre AssetGroup die Mindestanforderungen an Assets. Sie können also entweder keine Assets oder alle erforderlichen Assets einfügen.

Performance Max-Einzelhandelskampagne mit zusätzlichen Optionen

Ungültiger Status im Vergleich zu ungültigen Anfragen

Bei Performance Max-Kampagnen in der Google Ads API wird zwischen ungültigen Status und ungültigen Anfragen unterschieden.

Ungültiger Status: Die Anzeigen der Kampagne können aufgrund ihrer Konfiguration nicht ausgeliefert werden. Sie können beispielsweise eine eigenständige Campaign-Ressource mit einem advertising_channel_type von PERFORMANCE_MAX erstellen. Die Anfrage zum Erstellen der Kampagne ist zwar erfolgreich, kann aber erst ausgeliefert werden, wenn Sie der Kampagne mindestens eine AssetGroup hinzufügen. Wenn Ihre Anfragen erfolgreich sind, aber keine Anzeigen aus Ihrer Kampagne oder Asset-Gruppen ausgeliefert werden, können Sie CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason verwenden, um den Grund zu ermitteln. Weitere Informationen dazu finden Sie im Leitfaden zur Fehlerbehebung.
ungültige Anfrage: Eine Anfrage, die nicht erfolgreich ist, 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 andere Kampagne zu erstellen, ohne die mindestens erforderliche Anzahl von Assets einzubeziehen. Aus diesem Grund müssen Sie eine AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen in derselben Anfrage angeben. Dies bedeutet auch, dass alle Ihre AssetGroupAsset-Ressourcen die richtigen Spezifikationen für eine bestimmte field_type erfüllen müssen, um zu verhindern, dass die gesamte Anfrage fehlschlägt.

Vorgänge mit mutate-Anfragen gruppieren

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

Ihre Kampagne kann erst ausgeliefert werden, wenn Sie alle erforderlichen Ressourcen erstellt haben, die in diesem Leitfaden aufgeführt sind. Verwenden Sie beim Senden separater Anfragen die tatsächlichen Ressourcennamen der referenzierten Ressourcen in den nachfolgenden Anfragen. Verwenden Sie beim Senden von BulkMutate-Anfragen mit mehreren Vorgängen Ressourcennamen, die aus temporären IDs bestehen.

Reihenfolge von Vorgängen

Unabhängig davon, ob Sie eine BulkMutate-Anfrage 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 diese erstellt wurde. Bei BulkMutate-Anfragen werden die Vorgänge so sortiert, dass referenzierte Ressourcen vor den Ressourcen aufgelistet werden, die darauf verweisen.

Wenn Sie Asset-Ressourcen in derselben BulkMutate-Anfrage erstellen, mit der eine AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen erstellt werden, sollten alle AssetOperations vor allen AssetGroupAssetOperations stehen, wie im Diagramm dargestellt.

Der Google Ads-Server fasst aufeinanderfolgende AssetGroupAssetOperations zusammen und bewertet, ob eine AssetGroup nach dem letzten Vorgang in dieser Gruppe die Mindestanforderungen an Assets erfüllt. Wenn Sie in Ihrer Anfrage zwischen AssetOperations und AssetGroupAssetOperations wechseln, wertet der API-Server die Mindestanforderungen an Assets nach dem ersten AssetGroupAssetOperation aus und gibt einen Fehler zurück, ohne mit den restlichen Vorgängen in der Anfrage fortzufahren. Infolgedessen wird keines der Assets in der Anfrage Ihrem Google Ads-Konto hinzugefügt. Außerdem werden weder die AssetGroup noch eine der verknüpften AssetGroupAsset-Ressourcen erstellt.

Asset-Gruppen aktualisieren

Nachdem Sie ein gültiges AssetGroup erstellt haben, können Sie keine weiteren Anfragen mehr senden, die zu einem ungültigen Status führen würden, in dem die Mindestanforderungen für Assets nicht mehr erfüllt sind. Solche Anfragen geben einen Fehler aus. Wenn Sie beispielsweise ein AssetGroup mit einer einzelnen MARKETING_IMAGE (Mindestanforderung) erstellen, geben alle Anfragen zum Entfernen der AssetGroupAsset, die mit diesem MARKETING_IMAGE verknüpft ist, einen Fehler zurück.

Das ist besonders wichtig bei Asset-Gruppen in Kampagnen für den Einzelhandel, die ohne zugehörige Assets erstellt wurden. Nachfolgende Anfragen zum Hinzufügen von Assets zum AssetGroup durch Erstellen von AssetGroupAsset-Ressourcen sind nur erfolgreich, wenn die Anfrage alle Asset-Anforderungen erfüllt hat. Sie können diesen Asset-Gruppen also keine Assets schrittweise hinzufügen.