Smarte Kampagnen in Performance Max-Kampagnen umwandeln

In v25 und höher können Sie die Methode SmartCampaignSettingService.GeneratePMaxDraftCampaign verwenden, um eine smarte Kampagne in eine Performance Max-Kampagne umzuwandeln. Diese Methode ist in v24 und früheren Versionen nicht verfügbar.

Funktionsweise der Conversion

Wenn Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign aufrufen, generiert die API einen Entwurf für eine Performance Max-Kampagne, ein Budget, eine Asset-Gruppe und Assets. Grundlage dafür ist die Konfiguration der smarten Kampagne, die in der Anfrage angegeben wurde. Nachdem die neuen Ressourcen generiert wurden, sollten Sie sie prüfen, ändern und optimieren, bevor Sie die Kampagne für die Anzeigenauslieferung aktivieren.

Der generierte Entwurf einer Performance Max-Kampagne wird mit den folgenden Statuswerten initialisiert:

• status ist auf PAUSED gesetzt.
• Die Auslieferungseignung wird in primary_status angegeben.
• contains_eu_political_advertising ist standardmäßig auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING festgelegt, sofern nicht bereits in der smarten Kampagne angegeben. Überprüfen und aktualisieren Sie dieses Feld, wenn Ihre Kampagne politische Werbung in der EU enthält.

So können Sie die generierte Performance Max-Kampagne, das Budget, die Asset-Gruppe und die Assets prüfen, ändern und optimieren, bevor Sie die Kampagne für die Anzeigenauslieferung aktivieren.

Asset-Entwürfe

Die neue Kampagne enthält eine Gruppe von Platzhalterbildern, die ersetzt werden müssen, bevor die neue Kampagne aktiviert wird. Wenn das Feld image_enabled unterstützt wird und in der Anfrage auf true gesetzt ist, generiert die API automatisch Bilder, anstatt Platzhalterbilder zu verwenden. Sie können die neuen Assets im Feld assets der Antwort prüfen und sie so ersetzen:

1. Lesen Sie den Leitfaden zu den Asset-Anforderungen.
2. Laden Sie neue Bilder hoch, indem Sie dem Beispiel Bild-Asset hochladen folgen.
3. Verknüpfen Sie die neuen Assets mit der Asset-Gruppe der Kampagne im Entwurf und entfernen Sie dann die AssetGroupAsset-Links für die Platzhalterbilder (entweder in derselben atomaren Mutationsanfrage oder nach dem Verknüpfen der neuen Assets, damit die Mindestanforderungen für Assets weiterhin erfüllt sind). Folgen Sie dazu der Anleitung zum Verknüpfen von Asset-Gruppen mit Assets.

Anfrageparameter

Achtung: Die Parameter gbp_enabled und image_enabled werden nicht unterstützt und verursachen Fehler, wenn sie in einer Anfrage auf true gesetzt werden. Lassen Sie beide Felder leer oder setzen Sie sie auf false.

Die Nachricht GeneratePMaxDraftCampaignRequest akzeptiert die folgenden Felder:

• resource_name (erforderlich): Der Ressourcenname der SmartCampaignSetting, die für die smarte Kampagne, die Sie konvertieren möchten, neu generiert werden soll, im folgenden Format:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (optional): Wenn true, wird die Anfrage validiert, aber nicht ausgeführt. Im Feld validated_info der Antwort werden nur Validierungsfehler, Warnungen oder mögliche Konvertierungsprobleme zurückgegeben, ohne dass Entwurfsentitäten erstellt werden.

• gbp_enabled (Nicht unterstützt): Optional. Gibt an, ob der mit der Performance Max-Kampagne verknüpfte Standort im Google Unternehmensprofil konvertiert werden soll. Lassen Sie dieses Feld leer oder legen Sie es auf false fest. Wenn Sie es auf true festlegen, wird ein SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED-Fehler zurückgegeben.

• image_enabled (Nicht unterstützt): Optional. Gibt an, ob erforderliche Bilder für Performance Max-Kampagnen generiert werden sollen (z. B. horizontale, quadratische und Logo-Bildtypen). Lassen Sie dieses Feld leer oder legen Sie es auf false fest. Das Festlegen auf true wird nicht unterstützt und gibt den Fehler SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED zurück.

Antwortdetails

Die Nachricht GeneratePMaxDraftCampaignResponse gibt die Ressourcennamen des generierten Performance Max-Kampagnenentwurfs und der zugehörigen Entitäten zurück:

• pmax_campaign: Der Campaign-Ressourcenname der generierten Performance Max-Kampagne im Entwurf.
• campaign_budget: Der Ressourcenname der CampaignBudget, die mit der generierten Performance Max-Kampagne verknüpft ist.
• asset_group: Der Ressourcenname der AssetGroup, die mit der generierten Performance Max-Kampagne verknüpft ist.
• assets: Eine Liste von Asset-Ressourcennamen, die mit der generierten Performance Max-Kampagne verknüpft sind.
• validated_info: Validierungsinformationen oder mögliche Konvertierungsprobleme, die von der Konvertierungsprüfung zurückgegeben werden. Diese werden sowohl ausgefüllt, wenn validate_only auf true gesetzt ist, als auch zusammen mit den generierten Entitätsressourcennamen, wenn validate_only auf false gesetzt ist.

Empfohlener Workflow

So wandeln Sie eine smarte Kampagne um:

1. Kampagnenentwurf generieren: Rufen Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign auf und legen Sie nur die erforderliche resource_name fest. Lassen Sie gbp_enabled und image_enabled leer oder legen Sie sie auf false fest. Speichern Sie die zurückgegebenen Ressourcennamen pmax_campaign, campaign_budget, asset_group und assets.
2. Kampagne prüfen und anpassen: Da der Entwurf der Performance Max-Kampagne mit status = PAUSED und creation_status = INCOMPLETE erstellt wird, sollten Sie das Budget, die Asset-Gruppe und die Assets prüfen und konfigurieren.
3. Kampagne aktivieren und Original pausieren: Wenn Sie bereit sind, Anzeigen auszuliefern, ändern Sie den status der Performance Max-Kampagne in ENABLED und den status der ursprünglichen smarten Kampagne in PAUSED, um eine doppelte Auslieferung zu vermeiden.

Hinweis: Sobald gbp_enabled und image_enabled in einer zukünftigen Version aktiviert sind, können Sie auch Unternehmensprofil-Standorte und Bild-Assets automatisch migrieren.