Strukturanfragen

In diesem Leitfaden werden viele der Feinheiten beim Strukturieren von Anfragen zum Erstellen und Aktualisieren von Performance Max-Kampagnen beschrieben. Sie kann eine nützliche Ressource beim Entwerfen Ihrer Integration sein. In diesem Leitfaden wird erläutert, wie Anfragen verarbeitet werden, die Performance Max-Kampagnen ändern. Er kann als Ergänzung zum Leitfaden zur Fehlerbehebung bei Performance Max-Kampagnen und zum Leitfaden zur Batchverarbeitung für 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 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 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 alle Mindestanforderungen an Assets und Spezifikationen erfüllen. Bei Kampagnen für den Einzelhandel ist das anders. 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 sollen, 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 Mutationsanfrage ein.

Sie können die Ressourcen CampaignBudget, Campaign, Asset und CampaignAsset 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, aktive 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 AssetGroup- und AssetGroupAsset-Ressourcen erstellt werden. Alternativ können Sie AssetGroupSignal-Entitäten in einer separaten Anfrage nach dem Erstellen des AssetGroup erstellen.

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 benutzerdefinierte Assets (oder nur mit HTML5-Assets vom Typ MEDIA_BUNDLE)
  • Asset-Gruppen, die alle erforderlichen Assets enthalten (bevorzugt)

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

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

Das Feld Campaign.shopping_setting muss in Kampagnen für den Einzelhandel ausgefüllt werden. Außerdem müssen alle in einem AssetGroup aufgeführten final_urls mit der Websitedomain übereinstimmen, die mit der in Campaign.shopping_setting angegebenen Merchant Center-Konto-ID verknüpft ist. Schließlich muss jede AssetGroup einen zugehörigen, gültigen Produkteintragsgruppenbaum haben, der aus einer oder mehreren AssetGroupListingGroupFilter-Ressourcen besteht. Sie müssen mindestens einen Baum mit einem einzelnen Knoten 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, aktive Performance Max-Kampagne für den Einzelhandel

Image

Für Performance Max-Kampagnen für den Einzelhandel können alle Optionen verwendet werden, die für Standard-Performance Max-Kampagnen verfügbar sind, einschließlich des Erstellens von Asset-Gruppensignalen, Conversion-Zielvorhaben für Kampagnen und Kampagnenkriterien. Wenn Sie beim Erstellen der AssetGroup-Ressource benutzerdefinierte Assets (außer HTML5-MEDIA_BUNDLE-Assets) zu einer AssetGroup hinzufügen möchten, muss Ihre Anfrage alle Mindestanforderungen an Assets erfüllen (einschließlich Marken-Assets auf Kampagnenebene, wenn Markenrichtlinien aktiviert sind). Sie müssen also entweder gar keine benutzerdefinierten Assets oder alle erforderlichen Assets einbeziehen.

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 gibt es einen wichtigen Unterschied zwischen ungültigen Status und ungültigen Anfragen.

Ungültiges Bundesland
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, die Kampagne ist aber nicht aktiv, bis Sie ihr mindestens eine AssetGroup hinzufügen. Wenn Ihre Anfragen erfolgreich sind, Ihre Kampagne oder Asset-Gruppen aber nicht ausgeliefert werden, können Sie die Ursache mithilfe von CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason ermitteln, wie im Leitfaden zur Fehlerbehebung beschrieben.
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, eine AssetGroup für eine Kampagne zu erstellen, die nicht für den Einzelhandel bestimmt ist (außer Performance Max-Kampagnen für lokale Dienstleistungen), ohne die erforderlichen Mindest-Assets anzugeben. Daher müssen Sie eine AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen in dieselbe Anfrage einbeziehen. Das bedeutet auch, dass alle Ihre 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 Mutationsanfragen gruppieren

Performance Max-Kampagnen bestehen aus mehreren Ressourcen. Sie können diese separaten Ressourcen in einzelnen Anfragen oder in einer einzigen Bulk-Mutationsanfrage erstellen. AssetGroups und die zugehörigen AssetGroupAssets in Standard-Performance Max-Kampagnen müssen jedoch wie bereits erwähnt 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 nie auf eine Ressource verweisen, bevor sie erstellt wurde. Bei Bulk-Mutationsanfragen bedeutet dies, dass die Vorgänge so sortiert werden, dass referenzierte Ressourcen vor den Ressourcen aufgeführt werden, die auf sie verweisen.

Wenn Sie Asset-Ressourcen in derselben Bulk-Mutationsanfrage erstellen möchten, in der auch eine AssetGroup- und die zugehörigen AssetGroupAsset-Ressourcen erstellt werden, müssen alle AssetOperations vor allen AssetGroupAssetOperations stehen, wie im Diagramm dargestellt.

Image

Der Google Ads-Server fasst aufeinanderfolgende AssetGroupAssetOperations zusammen und prüft, ob ein AssetGroup nach dem letzten Vorgang in dieser Gruppe die Mindestanforderungen für 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 die restlichen Vorgänge in der Anfrage fortzusetzen. In diesem Fall wird keines der Assets in der Anfrage Ihrem Google Ads-Konto hinzugefügt. Außerdem werden weder die AssetGroup noch die zugehörigen AssetGroupAsset-Ressourcen erstellt.

Asset-Gruppen aktualisieren

Nachdem Sie eine gültige AssetGroup erstellt haben, können Sie keine nachfolgenden Anfragen senden, die dazu führen würden, dass eine Asset-Gruppe die Mindestanforderungen für Assets nicht erfüllt. Bei einer solchen Anfrage wird ein Fehler ausgegeben. Wenn Sie beispielsweise einen AssetGroup mit einer einzelnen MARKETING_IMAGE (Mindestanforderung) erstellen, wird bei einer Anfrage zum Entfernen nur dieser MARKETING_IMAGE AssetGroupAsset ein Fehler zurückgegeben. In Performance Max-Kampagnen für den Einzelhandel können Sie jedoch wieder AssetGroup auf automatisch generierte Assets aus dem Google Merchant Center zurückgreifen, indem Sie alle benutzerdefinierten AssetGroupAsset-Links in einer einzigen Anfrage entfernen.

Bei Asset-Gruppen in Performance Max-Kampagnen für den Einzelhandel, die ohne verknüpfte benutzerdefinierte Assets erstellt wurden, muss bei nachfolgenden Anfragen zum Verknüpfen benutzerdefinierter Assets (außer HTML5-MEDIA_BUNDLE-Assets) mindestens ein final_urls für die AssetGroup festgelegt werden (falls ursprünglich weggelassen, muss sie zuerst ausgefüllt werden). Außerdem müssen alle erforderlichen Mindest-Assets (einschließlich Marken-Assets auf Kampagnenebene, wenn Markenrichtlinien aktiviert sind) in einer einzigen atomaren Anfrage angegeben werden. Verknüpfen Sie optionale Anzeigen-Assets wie YOUTUBE_VIDEO nicht allein und fügen Sie Anzeigen-Assets nicht schrittweise über separate Anfragen hinzu. Wenn Sie nur optionale benutzerdefinierte Assets verknüpfen, befindet sich die Asset-Gruppe in einem nicht unterstützten Zustand, der Änderungen in der Google Ads-Benutzeroberfläche verhindert. Weitere Informationen finden Sie unter Asset-Gruppen mit Assets in Performance Max-Kampagnen für den Einzelhandel verknüpfen.

Zurück
Berichte zu Kampagnenkriterien
Weiter
Batchverarbeitung