Strukturanfragen

In diesem Leitfaden werden viele der Feinheiten der Strukturierung von Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen beschrieben. Sie kann beim Entwerfen deiner Integration eine nützliche Ressource sein. In diesem Leitfaden wird erläutert, wie Anfragen zur Änderung von Performance Max-Kampagnen verarbeitet werden. Sie kann als Begleitressource für den Leitfaden zur Fehlerbehebung bei Performance Max-Kampagnen dienen.

Performance Max-Kampagnen erstellen

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

Standard-Performance Max-Kampagnen

Für Standard-Performance Max-Kampagnen ist eine bestimmte Mindestmenge an Ressourcen erforderlich.

• Kampagnenbudget
• Campaign
• Asset-Gruppen
• Asset-Gruppen-Assets
• Assets

Wichtig: Die Vorgänge zum Erstellen von AssetGroup- und AssetGroupAsset-Entitäten müssen in einer einzigen Anfrage zusammengefasst sein und die AssetGroupAsset-Ressourcen müssen kombiniert werden, um alle Mindestanforderungen an Assets und -spezifikationen zu erfüllen. Hier sehen Sie die Unterschiede bei Einzelhandelskampagnen. 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 zum Erstellen von Performance Max-Kampagnen zu strukturieren. Die Entscheidung, wie Vorgänge und Anfragen gruppiert werden sollen, 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.
• Nehmen Sie alle diese Ressourcen in eine einzige mutate-Anfrage auf.

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

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

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 der Kampagne
• Kampagnenkriterien

Sie können Vorgänge zum Erstellen von AssetGroupSignal-Ressourcen in die Anfrage aufnehmen, 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

Einzelhandelskampagnen sind ein Sonderfall, da 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 zum Erstellen von Anzeigen. Wir empfehlen jedoch, Assets bereitzustellen, die im gesamten Inventar erreicht werden sollen. Für Performance Max-Kampagnen für den Einzelhandel sind mindestens die folgenden Ressourcen erforderlich.

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

Wichtig: In Einzelhandelskampagnen muss das Feld Campaign.shopping_settings ausgefüllt sein. Außerdem müssen die in den einzelnen AssetGroup aufgeführten final_urls mit den URLs übereinstimmen, die mit der Merchant Center-Konto-ID verknüpft sind, die im Campaign.shopping_settings angegeben ist. Schließlich muss jede AssetGroup eine zugehörige, gültige Produkteintragsgruppe haben, die aus einer oder mehreren AssetGroupListingGroupFilter-Ressourcen besteht. Sie müssen mindestens einen einzelnen Knotenbaum 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 Ressourcen korrekt erstellt wurden.

Mindestanforderungen an eine gültige Performance Max-Kampagne mit Anzeigenauslieferung

Für Einzelhandelskampagnen stehen alle Optionen zur Verfügung, die für standardmäßige Performance Max-Kampagnen zur Verfügung stehen. Dazu gehört auch das Erstellen von Signalen für Asset-Gruppen, Kampagnen-Conversion-Zielvorhaben und Kampagnenkriterien. Wenn Sie beim Erstellen der AssetGroup-Ressource Assets zu einem AssetGroup hinzufügen, unterliegt Ihre AssetGroup den Mindestanforderungen an Assets. Sie können also entweder keine oder alle erforderlichen Assets einschließen.

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, sie kann aber erst ausgeliefert werden, wenn Sie der Kampagne mindestens eine AssetGroup hinzugefügt haben. Wenn Ihre Anfragen erfolgreich sind, die Kampagne oder Asset-Gruppen aber nicht ausgeliefert werden, können Sie CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason verwenden, um den Grund zu ermitteln, wie in der Anleitung zur Fehlerbehebung beschrieben.

ungültige Anfrage

Eine Anfrage, die nicht erfolgreich ist, weil dadurch die Kampagne oder Ressource ungültig wird. Die Google Ads API gibt beispielsweise einen Fehler aus, wenn Sie versuchen, eine AssetGroup für eine Nicht-Einzelhandelskampagne zu erstellen, ohne die Mindestanzahl an 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 den korrekten Spezifikationen für eine bestimmte field_type entsprechen müssen, damit die gesamte Anfrage nicht 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 Bulk-Mutate-Anfrage erstellen. Allerdings müssen AssetGroups und die zugehörige AssetGroupAssets in Performance Max-Standardkampagnen wie bereits erwähnt in einer einzelnen atomaren Anfrage erstellt werden.

Ihre Kampagne kann 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 BulkMutate-Anfragen mit mehreren Vorgängen Ressourcennamen, die mit temporären IDs gebildet wurden.

Reihenfolge von Vorgängen

Sie müssen Ihre Anfragen und Vorgänge so ordnen, dass nie auf eine Ressource verwiesen wird, und zwar unabhängig davon, ob Sie eine BulkMutate-Anfrage zum Erstellen einer Performance Max-Kampagne verwenden. Bei BulkMutate-Anfragen müssen die Vorgänge so angeordnet werden, dass referenzierte Ressourcen vor den Ressourcen aufgelistet werden, die darauf verweisen.

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

Der Google Ads-Server fasst aufeinanderfolgende AssetGroupAssetOperations in Batches zusammen und prüft, ob ein AssetGroup nach dem letzten Vorgang in dieser Gruppe die Mindestanforderungen an Assets erfüllt. Wenn Sie in Ihrer Anfrage abwechselnd AssetOperations und AssetGroupAssetOperations angeben, 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. Daher 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 eine gültige AssetGroup erstellt haben, können Sie keine weiteren Anfragen mehr senden, die zu einem ungültigen Status führen, bei dem die Mindestanforderungen an Assets nicht mehr erfüllt werden. Solche Anfragen führen zu einem Fehler. Wenn Sie beispielsweise ein AssetGroup mit einer einzelnen MARKETING_IMAGE (Mindestanforderung) erstellen, geben alle Anfragen zum Entfernen der mit dieser MARKETING_IMAGE verknüpften AssetGroupAsset einen Fehler zurück.

Das ist besonders wichtig bei Asset-Gruppen in Einzelhandelskampagnen, 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 nicht schrittweise Assets hinzufügen.