Strukturanfragen

In diesem Leitfaden werden viele der Feinheiten der Strukturierung von Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen beschrieben. Er kann bei der Entwicklung Ihrer Integration eine nützliche Ressource sein. In diesem Leitfaden wird erläutert, wie Anfragen zur Änderung von Performance Max Kampagnen verarbeitet werden. Er kann als Begleitressource zum Leitfaden zur Fehlerbehebung bei Performance Max Kampagnen und zum Leitfaden zur Batchverarbeitung für 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 Standard-Performance Max-Kampagnen ist eine Mindestanzahl von Ressourcen erforderlich, damit Anzeigen ausgeliefert werden können.

Bei Kampagnen mit aktivierten Markenrichtlinien müssen die Vorgänge zum Erstellen von Campaign und den erforderlichen CampaignAsset -Ressourcen in einer einzigen Anfrage enthalten sein. Die CampaignAsset -Ressourcen müssen die Mindestanforderungen und ‑spezifikationen für Assets erfüllen.

Wichtig: 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 Mindestanforderungen und ‑spezifikationen für Assets erfüllen. Informationen zu den Unterschieden bei Kampagnen für den Einzelhandel finden Sie hier. 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 gruppiert und Anfragen strukturiert werden, hängt weitgehend von Ihren Zielvorhaben 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 in einer einzigen Anfrage enthalten sein.
  • Fügen Sie alle diese Ressourcen in eine einzige Mutationsanfrage 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

Image

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 dieselbe Anfrage einfügen, mit der die Ressourcen AssetGroup und AssetGroupAsset 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

Image

Performance Max-Kampagnen für den Einzelhandel

Kampagnen für den Einzelhandel sind insofern einzigartig, als es zwei verschiedene 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 (empfohlen)

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, um alle Inventartypen zu erreichen. Für Performance Max-Kampagnen für den Einzelhandel ist eine Mindestanzahl der folgenden Ressourcen erforderlich, damit Anzeigen ausgeliefert werden können.

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

Es ist wichtig zu beachten, dass das Feld Campaign.shopping_settings in Kampagnen für den Einzelhandel ausgefüllt sein muss. Außerdem müssen die in den einzelnen AssetGroup aufgeführten final_urls mit den URLs übereinstimmen, die mit der im Campaign.shopping_settings angegebenen Merchant Center-Konto-ID verknüpft sind. Schließlich muss jede AssetGroup eine zugehörige, gültige Produktlistengruppierung haben, die aus einer oder mehreren AssetGroupListingGroupFilter Ressourcen besteht. Sie müssen mindestens eine einzelne Baumstruktur erstellen, um alle Produkte in Ihrem angegebenen Merchant Center-Feed zu berücksichtigen.

Jede dieser Ressourcen kann separat oder in einer einzigen 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

Image

Kampagnen für den Einzelhandel können alle Optionen nutzen, die für Standard-Performance Max-Kampagnen verfügbar sind, einschließlich des Erstellens von Signalen für Asset-Gruppen, Conversion-Zielvorhaben für Kampagnen und Kampagnenkriterien. Wenn Sie beim Erstellen der AssetGroup-Ressource Assets zu einer AssetGroup hinzufügen, unterliegt Ihre AssetGroup den Mindestanforderungen für Assets. Mit anderen Worten: Sie können entweder keine oder alle erforderlichen Assets einfügen.

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

Image

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 Status und ungültigen Anfragen zu unterscheiden.

Ungültiger Status
Die Kampagne kann 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 ist jedoch nicht aktiv, bis Sie der Kampagne mindestens eine AssetGroup hinzufügen. Wenn Ihre Anfragen erfolgreich sind, Ihre Kampagne oder Asset-Gruppen aber nicht ausgeliefert werden, können Sie CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, und AssetGroupPrimaryStatusReason verwenden, um den Grund zu ermitteln. Weitere Informationen 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 Nicht-Kampagne für den Einzelhandel zu erstellen, ohne die erforderliche Mindestanzahl von Assets anzugeben. Aus diesem Grund müssen Sie eine AssetGroup und ihre AssetGroupAsset-Ressourcen in derselben Anfrage angeben. Außerdem müssen alle Ihre AssetGroupAsset-Ressourcen die korrekten Spezifikationen für einen bestimmten field_type erfüllen, damit die gesamte Anfrage nicht fehlschlägt.

Vorgänge mit Mutationsanfragen gruppieren

Performance Max-Kampagnen bestehen aus mehreren Ressourcen. Sie haben die Option, diese separaten Ressourcen in eindeutigen Anfragen oder in einer einzigen Bulk-Mutationsanfrage zu erstellen. Wie bereits erwähnt, müssen AssetGroups und die zugehörigen AssetGroupAssets in Standard-Performance Max-Kampagnen jedoch in einer einzigen atomaren Anfrage erstellt werden.

Ihre Kampagne kann erst ausgeliefert werden, wenn Sie alle in diesem Leitfaden genannten erforderlichen Ressourcen erstellt haben. Wenn Sie separate Anfragen senden, verwenden Sie in nachfolgenden Anfragen die tatsächlichen Ressourcennamen der referenzierten Ressourcen. Wenn Sie Bulk-Mutationsanfragen mit mehreren Vorgängen senden, verwenden Sie Ressourcennamen, die mit 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 dies, dass die Vorgänge so angeordnet werden müssen, dass referenzierte Ressourcen vor den Ressourcen aufgeführt werden, die auf sie verweisen.

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

Image

Der Google Ads-Server führt aufeinanderfolgende AssetGroupAssetOperations zusammen und prüft nach dem letzten Vorgang in dieser Gruppe, ob eine AssetGroup die Mindestanforderungen für Assets erfüllt. Wenn Sie in Ihrer Anfrage zwischen AssetOperations und AssetGroupAssetOperations wechseln, prüft der API-Server die Mindestanforderungen für Assets nach der ersten AssetGroupAssetOperation 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 werden weder die AssetGroup noch eine der zugehörigen AssetGroupAsset Ressourcen erstellt.

Asset-Gruppen aktualisieren

Nachdem Sie eine gültige AssetGroup erstellt haben, können Sie keine nachfolgenden Anfragen senden, die zu einem ungültigen Status führen, in dem die Mindestanforderungen für Assets nicht mehr erfüllt sind. Solche Anfragen führen zu einem Fehler. Wenn Sie beispielsweise ein AssetGroup mit einem einzelnen MARKETING_IMAGE erstellen (die Mindestanforderung), führen alle Anfragen zum Entfernen des AssetGroupAsset , das mit diesem MARKETING_IMAGE verknüpft ist, zu einem Fehler.

Dies 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 Anzeigen-Assets zu den AssetGroup durch Erstellen von AssetGroupAsset Ressourcen sind nur erfolgreich, wenn die Anfrage alle Anforderungen an Anzeigen-Assets erfüllt. Mit anderen Worten: Sie können diesen Asset-Gruppen nicht schrittweise Assets hinzufügen.

Zurück
Berichte zu Kampagnenkriterien
Weiter
Batchverarbeitung