Strukturanfragen

In diesem Leitfaden werden viele der Feinheiten der Strukturierung von Anfragen beschrieben, die zu und aktualisieren Sie Ihre Performance Max-Kampagnen. Sie kann eine nützliche Ressource sein, wenn Sie Ihre Integration verwenden. In diesem Leitfaden wird erläutert, wie Anfragen zur Änderung von Performance Max-Kampagnen Kampagnen werden verarbeitet und können eine Begleitressource zu den Performance Max-Kampagnen Anleitung zur Fehlerbehebung und die Leitfaden zur Batchverarbeitung für Performance Max-Kampagnen

Performance Max-Kampagnen erstellen

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

Standardmäßige Performance Max-Kampagnen

Für Standard-Performance Max-Kampagnen ist eine Mindestanzahl an Ressourcen erforderlich, ausgeliefert werden soll.

• Kampagnenbudget
• Kampagne
• Asset-Gruppen
• Asset-Gruppen-Assets
• Assets

Beachten Sie, dass die Vorgänge zum Erstellen von AssetGroup und AssetGroupAsset-Entitäten müssen zusammen in einer einzelnen Anfrage enthalten sein. Die AssetGroupAsset-Ressourcen müssen kombiniert werden, um das gesamte Mindest-Asset zu erfüllen Anforderungen und Spezifikationen; sehen wir uns an, was der Unterschied Kampagnen für den Einzelhandel: Anfragen zum Erstellen Ein AssetGroup ohne alle erforderlichen AssetGroupAsset-Entitäten führt zu einer Fehler; Siehe Ungültiger Status im Vergleich zu ungültigen Anfragen .

Es gibt verschiedene Optionen für die Strukturierung von Anfragen, durch die Performance Max-Kampagnen. Die Entscheidung, wie Operationen und Strukturanfragen hängt weitgehend von Ihren Zielen und Ihrer Infrastruktur ab.

• Erstellen Sie die Ressourcen CampaignBudget, Campaign und Asset separat. -Anfragen vor dem Erstellen der Ressourcen AssetGroup und AssetGroupAsset.
• Binden Sie alle diese Ressourcen in eine einzelne mutate-Anfrage ein.

Sie können zwar CampaignBudget, Campaign und Asset erstellen. in separaten vorherigen Anfragen, kann die Performance Max-Kampagne können ausgeliefert werden, bis die Ressourcen AssetGroup und AssetGroupAsset erstellt wurde.

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

Sie können Ihre Performance Max-Kampagnen weiter anpassen, wie im Diagramm dargestellt.

• Signale für Asset-Gruppen
• Conversion-Zielvorhaben der Kampagne
• Kampagnenkriterien

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

Performance Max-Kampagne mit zusätzlichen Optionen

Performance Max-Kampagnen für den Einzelhandel

Kampagnen für den Einzelhandel sind ein Sonderfall, da es Zwei separate Möglichkeiten zum Erstellen von Asset-Gruppen, mit denen eine gültige Auslieferung erzielt wird Kampagne:

• Asset-Gruppen ohne Assets
• Asset-Gruppen, die ALLE erforderlichen Assets enthalten (bevorzugt)

Wenn Sie Assets aus Asset-Gruppen ausschließen, verwendet Google automatisch die in Ihren verknüpften Merchant Center-Konto, um Anzeigen. Wir empfehlen jedoch, Assets für das gesamte Inventar bereitzustellen. Für Performance Max-Kampagnen für den Einzelhandel sind die folgenden Mindestanforderungen erforderlich: Ressourcen bereitgestellt werden.

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

Beachten Sie, dass das Feld Campaign.shopping_settings in Kampagnen für den Einzelhandel. Außerdem sind die final_urls in den einzelnen AssetGroup muss mit URLs übereinstimmen, die mit der Merchant Center-Konto-ID verknüpft sind in Campaign.shopping_settings angegeben. Schließlich muss jede AssetGroup verfügen über eine verknüpfte, gültige Struktur für eine Gruppe von Produkteinträgen, die aus einer oder mehreren AssetGroupListingGroupFilter Ressourcen. Sie müssen mindestens einen einzelnen Knotenbaum zur Berücksichtigung aller Produkte im angegebenen Merchant Center-Feed.

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

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

Bei Kampagnen für den Einzelhandel können alle Optionen genutzt werden, Performance Max-Kampagnen, einschließlich Asset-Gruppensignalen, Conversion-Zielvorhaben und Kampagnenkriterien. Wenn Sie einer Kampagne Assets hinzufügen möchten, AssetGroup beim Erstellen der Ressource AssetGroup, Ihre AssetGroup ist die den Mindestanforderungen an Assets unterliegen. Mit anderen Worten: Sie können entweder keine oder alle erforderlichen Assets enthalten.

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 gibt es wichtige Unterscheidung zwischen ungültigen Bundesstaaten und ungültigen Anfragen.

Ungültiges Bundesland

Die Anzeigen der Kampagne können aufgrund ihrer Konfiguration nicht ausgeliefert werden. Für Sie können beispielsweise eine eigenständige Campaign-Ressource mit einem advertising_channel_type von PERFORMANCE_MAX. Die Anfrage zum Erstellen die Kampagne erfolgreich ist, kann sie erst ausgeliefert werden, wenn Sie mindestens ein AssetGroup der Kampagne hinzu. Wenn Ihre Anfragen erfolgreich sind, Ihre Kampagne oder werden keine Anzeigen aus Asset-Gruppen ausgeliefert, können Sie CampaignPrimaryStatus verwenden. CampaignPrimaryStatusReason, AssetGroupPrimaryStatus und AssetGroupPrimaryStatusReason, um den Grund zu ermitteln, wie in der Fehlerbehebung

Ungültige Anfrage

Eine Anfrage, die nicht erfolgreich ist, weil dadurch die Kampagne oder in einen ungültigen Status versetzt. Die Google Ads API gibt beispielsweise einen Fehler aus, wenn Sie versuchen, eine AssetGroup für eine andere Kampagne als den Einzelhandel zu erstellen, ohne mindestens erforderliche Assets. Dies ist warum eine AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen in den dieselbe Anfrage. Das bedeutet auch, dass alle AssetGroupAsset-Ressourcen die korrekten Spezifikationen für eine bestimmte field_type erfüllen, um zu verhindern, für das Fehlschlagen der Anfrage.

Vorgänge mit mutate-Anfragen gruppieren

Performance Max-Kampagnen bestehen aus mehreren Ressourcen. können Sie diese separaten Ressourcen in einzelnen Anfragen oder in einem Bulk-Änderungsanfrage an. AssetGroups und die mit AssetGroupAssets in Standard-Performance Max-Kampagnen verknüpften die in einer einzelnen atomaren Anfrage erstellt wurden.

Ihre Kampagne kann erst ausgeliefert werden, wenn Sie alle alle erforderlichen Ressourcen, die in diesem Leitfaden aufgeführt sind. Bei der Ausstellung separater -Anfragen verwenden, verwenden Sie die tatsächlichen Ressourcennamen der referenzierten Ressourcen in den nachfolgenden -Anfragen. Wenn Sie BulkMutate-Anfragen mit mehreren Vorgängen senden, verwenden Sie Ressourcennamen, die durch temporäre IDs gebildet wurden.

Reihenfolge von Vorgängen

Unabhängig davon, ob Sie eine Bulk-Änderungsanfrage verwenden, um eine Performance Max-Kampagne zu erstellen müssen Sie Ihre Anfragen und Vorgänge so anordnen, auf eine Ressource verweisen, bevor sie erstellt wird. Bei Bulk-Änderungen bedeutet dies, die Vorgänge so zu ordnen, dass Ressourcen werden vor den Ressourcen aufgeführt, die auf sie verweisen.

Wenn Sie Asset-Ressourcen in derselben BulkMutate-Anfrage erstellen, erstellt ein AssetGroup und die zugehörigen AssetGroupAsset-Ressourcen, alle AssetOperations muss vor allen AssetGroupAssetOperations stehen, wie: die im Diagramm dargestellt sind.

Auf dem Google Ads-Server werden aufeinanderfolgende AssetGroupAssetOperations in einem Batch zusammengefasst. und bewertet, ob eine AssetGroup die Mindestanforderungen an Assets erfüllt, der letzte Operation in dieser Gruppe. Wenn du zwischen AssetOperations wechselst und AssetGroupAssetOperations in Ihrer Anfrage enthält, wertet der API-Server Mindestanforderungen an Assets nach den ersten AssetGroupAssetOperation und Fehler zurückgegeben, ohne mit den übrigen Vorgängen Infolgedessen wird keines der Assets in der Anfrage Ihrem Google Ads-Konto. Weder die AssetGroup noch die zugehörigen AssetGroupAsset Ressourcen werden 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 würden, in dem die Mindestanforderungen an Assets erfüllt sind. Solche Anfragen geben einen Fehler aus. Wenn Sie beispielsweise AssetGroup mit nur einem MARKETING_IMAGE erstellen (Mindestanforderung) alle Anträge auf Entfernung der AssetGroupAsset die mit MARKETING_IMAGE verknüpft sind, einen Fehler zurückgeben.

Das ist besonders bei Asset-Gruppen in Kampagnen für den Einzelhandel wichtig. die ohne zugehörige Assets erstellt wurden. Nachfolgende Anfragen zum Hinzufügen von Assets zu den AssetGroup durch Erstellen von AssetGroupAsset Ressourcen würde nur erfolgreich sein, wenn der Anforderung alle Asset-Anforderungen erfüllt. Sie können also keine Assets diese Asset-Gruppen schrittweise zu erhöhen.