Smarte Kampagnen in Performance Max-Kampagnen umwandeln

In v25 (ab v25.2) 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.

So funktioniert die Umstellung

Wenn Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign aufrufen, wird in der API ein Entwurf für eine Performance Max-Kampagne auf Grundlage der Konfiguration einer Smart-Kampagne erstellt.

Der generierte Performance Max-Kampagnenentwurf wird mit status auf PAUSED initialisiert. Die Berechtigung für die Anzeigenauslieferung wird in primary_status angegeben. Wenn die Validierung aller Funktionskonverter für die smarte Kampagne fehlschlägt, schlägt die Anfrage mit dem Fehler SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL fehl.

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 aktivieren. Durch das Erstellen der Performance Max-Kampagne als Entwurf wird die ursprüngliche Smart-Kampagne nicht geändert oder pausiert. Sie bleibt aktiv, bis Sie sie manuell pausieren.

Anfrageparameter

Die Nachricht GeneratePMaxDraftCampaignRequest akzeptiert die folgenden Felder:

  • resource_name (Erforderlich): Der Ressourcenname des SmartCampaignSetting, der für die Smart-Kampagne, die Sie umwandeln 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. In der Antwort werden nur Validierungsfehler, Warnungen oder mögliche Conversion-Probleme im Feld validated_info zurückgegeben, ohne dass Entwurfseinheiten erstellt werden.

  • gbp_enabled (Nicht unterstützt): Optional. Gibt an, ob der mit der Performance Max-Kampagne verknüpfte Standort des Unternehmensprofils umgewandelt werden soll. Lassen Sie dieses Feld leer oder legen Sie es auf false fest. Die Einstellung auf true ist in v25 nicht implementiert und gibt einen SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED-Fehler zurück.

  • image_enabled (Nicht unterstützt): Optional. Gibt an, ob die erforderlichen Bilder für Performance Max-Kampagnen generiert werden sollen, z. B. horizontale, quadratische und Logo-Bilder. Lassen Sie dieses Feld leer oder legen Sie es auf false fest. Die Einstellung auf true ist in v25 nicht implementiert und gibt einen SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED-Fehler zurück.

Antwortdetails

Die Meldung 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.
  • campaign_budget: Der Ressourcenname CampaignBudget, der mit der generierten Performance Max-Kampagne verknüpft ist.
  • asset_group: Der Ressourcenname AssetGroup, der mit der generierten Performance Max-Kampagne verknüpft ist.
  • assets: Eine Liste der Ressourcennamen von Asset, die mit der generierten Performance Max-Kampagne verknüpft sind.
  • validated_info: Validierungsinformationen oder mögliche Conversion-Probleme, die von der Conversion-Prüfung zurückgegeben werden (werden sowohl festgelegt, wenn validate_only auf true gesetzt ist, als auch zusammen mit den generierten Ressourcennamen der Entität, wenn validate_only false ist).

So wandeln Sie eine Smart-Kampagne um:

  1. Kampagnenentwurf erstellen: Rufen Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign mit nur den erforderlichen resource_name auf (lassen Sie gbp_enabled und image_enabled nicht festgelegt oder legen Sie sie auf false fest). Speichern Sie die zurückgegebenen Ressourcennamen pmax_campaign, campaign_budget, asset_group und assets.
  2. Kampagne überprüfen und anpassen: Da die Performance Max-Kampagne im Entwurf mit status = PAUSED erstellt wird, sollten Sie das Budget, die Asset-Gruppe und die Assets prüfen und konfigurieren.
  3. Kampagne aktivieren und ursprüngliche Kampagne pausieren: Wenn Sie Anzeigen schalten möchten, ändern Sie den status der Performance Max-Kampagne in ENABLED und den status der ursprünglichen Smart-Kampagne in PAUSED, um doppelte Auslieferungen zu vermeiden.