Smarte Kampagnen in Performance Max-Kampagnen umwandeln

In v25 und höher können Sie mit der SmartCampaignSettingService.GeneratePMaxDraftCampaign Methode eine smarte Kampagne in eine Performance Max-Kampagne umwandeln. Diese Methode ist in v24 und niedriger nicht verfügbar.

So funktioniert die Umstellung

Wenn Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign aufrufen, generiert die API eine Performance Max-Kampagne im Entwurfsmodus, ein Budget, eine Asset-Gruppe und Assets basierend auf der Konfiguration der smarten Kampagne, die in der Anfrage angegeben ist. Nach der Generierung sollten Sie die neuen Ressourcen prüfen, ändern und optimieren, bevor Sie die Kampagne aktivieren, damit Anzeigen ausgeliefert werden können.

Die generierte Performance Max-Kampagne im Entwurfsmodus wird mit den folgenden Statuswerten initialisiert:

  • status ist auf PAUSED gesetzt.
  • Die Berechtigung zur Anzeigenauslieferung wird in primary_status angegeben.
  • contains_eu_political_advertising ist standardmäßig auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING gesetzt (sofern nicht bereits in der smarten Kampagne angegeben). Prü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 aktivieren, damit Anzeigen ausgeliefert werden können.

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. Folgen Sie dazu dem Beispiel zum Hochladen von Bild-Assets .
  3. Verknüpfen Sie die neuen Assets mit der Asset-Gruppe des Kampagnenentwurfs und entfernen Sie dann die AssetGroupAsset Verknüpfungen für die Platzhalterbilder. Das kann entweder in derselben atomaren Mutationsanfrage oder nach dem Verknüpfen der neuen Assets erfolgen, damit die Mindestanforderungen an Assets erfüllt bleiben. Folgen Sie dazu dem Leitfaden zum Verknüpfen von Asset-Gruppen mit Assets.

Anfrageparameter

Die GeneratePMaxDraftCampaignRequest Nachricht akzeptiert die folgenden Felder:

  • resource_name (Erforderlich): Der Ressourcenname der SmartCampaignSetting, die für die smarte 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 Probleme bei der Umstellung 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 im Unternehmensprofil umgewandelt werden soll. Lassen Sie dieses Feld nicht festgelegt oder false setzen Sie es auf true wird der Fehler SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED zurückgegeben.

  • image_enabled (Nicht unterstützt): Optional. Gibt an, ob die erforderlichen Bilder für die Performance Max-Kampagne generiert werden sollen (z. B. horizontale, quadratische und Logo-Bilder). Lassen Sie dieses Feld nicht festgelegt oder false. Wenn Sie es auf true setzen, wird der Fehler SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED zurückgegeben.

Antwortdetails

Die GeneratePMaxDraftCampaignResponse Nachricht gibt die Ressourcennamen der generierten Performance Max-Kampagne im Entwurfsmodus und der zugehörigen Einheiten zurück:

  • pmax_campaign: Der Campaign Ressourcenname der generierten Performance Max-Kampagne im Entwurfsmodus.
  • campaign_budget: Der CampaignBudget-Ressourcenname, der mit der generierten Performance Max-Kampagne verknüpft ist.
  • asset_group: Der AssetGroup Ressourcenname, der mit der generierten Performance Max-Kampagne verknüpft ist.
  • assets: Eine Liste der Asset-Ressourcennamen, die mit der generierten Performance Max-Kampagne verknüpft sind.
  • validated_info: Validierungsinformationen oder mögliche Probleme bei der Umstellung, die von der Umstellungsprüfung zurückgegeben werden. Dieses Feld wird sowohl festgelegt, wenn validate_only auf true gesetzt ist, als auch zusammen mit den Ressourcennamen der generierten Einheit, wenn validate_only auf false gesetzt ist.

So wandeln Sie eine smarte Kampagne um:

  1. Kampagne im Entwurfsmodus generieren: Rufen Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign auf und legen Sie nur das erforderliche Feld resource_name fest. Lassen Sie gbp_enabled und image_enabled nicht festgelegt oder setzen Sie sie auf false. Speichern Sie die zurückgegebenen Ressourcennamen pmax_campaign, campaign_budget, asset_group und assets.
  2. Kampagne prüfen und anpassen: Da die Performance Max Kampagne im Entwurfsmodus mit status = PAUSED und creation_status = INCOMPLETE erstellt wird, müssen Sie das Budget, die Asset Gruppe und die Assets prüfen und konfigurieren.
  3. Kampagne aktivieren und ursprüngliche Kampagne pausieren: Wenn Sie bereit sind, Anzeigen auszuliefern, setzen Sie `status` der Performance Max-Kampagne auf `ENABLED` und dann `status` der ursprünglichen smarten Kampagne auf `PAUSED`, um doppelte Auslieferungen zu vermeiden.statusstatusENABLEDPAUSED